bujuan 完全上手指南如何用 Flutter 打造五端通用的网易云播放器【免费下载链接】bujuanFlutter移动端桌面端三方网易云播放器项目地址: https://gitcode.com/gh_mirrors/bu/bujuanbujuan 是一个用 Flutter 编写的三方网易云音乐播放器一套 Dart 代码即可编译到 Android、iOS、macOS、Windows、Linux 五个平台并内置 Rust 版 UnblockNeteaseMusic 来解锁灰色歌曲音源。它适合谁典型使用场景通勤路上手机听歌官方 App 登录状态偶尔被风控、或你想要更干净的播放界面时bujuan 提供邮箱/二维码登录保留每日推荐、私人 FM、电台、云盘等核心模块砍掉了社交、直播等冗余功能界面更轻。桌面端当播放器用macOS/Windows/Linux 下可横屏播放播放页模仿 YouTube Music 的歌词动效适合挂在电脑上当主力听歌工具macOS 仍在适配中。学习 Flutter 跨平台架构项目里 GetX auto_route Riverpod 三套状态/路由方案并存、音频走 audio_service 前台服务、Rust 模块经 flutter_rust_bridge 桥接是一份不错的跨平台播放器参考实现。平台状态界面形态Android / iOS基本完善竖屏手机界面macOS / Windows / Linux可用macOS 适配中横屏桌面界面手机端的播放界面底部有歌词、进度与模式切换桌面端macOS是横屏布局左侧专辑封面、右侧滚动歌词快速上手环境检查 五分钟跑通前置环境检查清单开始之前逐项确认缺哪个补哪个Flutter SDKflutter --version能正常输出版本号Dart 3.0 对应的 Flutter 版本Rust 工具链rustc --version可用——因为灰色歌曲模块是 Rust 写的没装会导致编译失败目标平台工具链Android 装 Android SDKiOS 只能在本机 macOS Xcode 上构建桌面端需要对应的 CMake/GCC 环境ffmpegRust 侧编解码会用到Windows 上一般装 Rust 时顺带解决Linux 建议apt install ffmpeg最小化跑通步骤git clone https://gitcode.com/gh_mirrors/bu/bujuan cd bujuan flutter pub get flutter run就这四步。flutter pub get拉取 Dart 依赖后接上设备直接flutter run首次启动进入登录页邮箱/手机密码或扫二维码两种方式登录成功后即可使用。多平台构建速查表五个平台的正式包都是同一套命令模式只换平台名无需逐条记忆目标平台构建命令备注Androidflutter build apk --release签名信息在 android/key.propertiesiOSflutter build ios仅 macOS 可构建macOSflutter build macos仍在适配中问题较多Windows / Linuxflutter build windows/flutter build linux横屏窗口尺寸写死在 main.dart 的窗口配置里开发调试阶段任意平台都可用flutter run 目标替代构建命令热重载生效更快。自定义与二次开发问题导向定位表想知道改哪里对照这张表找文件即可路径均相对项目根目录你想改什么去哪里改改完能得到什么主题色、深浅色模式、页面转场lib/common/constants/colors.dart中的AppTheme.light / AppTheme.dark全局配色与过渡动画随主题切换播放逻辑队列、循环模式、后台通知lib/common/bujuan_audio_handler.dart基于 audio_service播放页、系统通知、锁屏控制同步变化登录、搜索、歌单等接口与返回结构lib/common/netease_api/src/api/下按 login/search/play/dj 分包bean.dart定义数据结构新增接口只需仿照现有目录加 api bean 两件套页面与路由页面放lib/pages/模块/路由注册在lib/routes/router.dartauto_route 生成router.gr.dart新页面可被导航与控制器生命周期统一管理见lib/main.dart中MyObserver的路由进出清理逻辑灰色歌曲解锁能力Rust 模块经 flutter_rust_bridge 桥接Dart 侧入口在lib/common/netease_api/netease_music_api.dart打开解锁开关后灰色歌曲可正常播放缓存键名、持久化键名集中在lib/common/constants/key.dart存储用 Hive初始化在 main.dart 的_initAudioServer修改持久化字段时不遗漏键名生态与相关项目UnblockNeteaseMusicRust 版核心依赖。bujuan 内置它的服务端负责解析灰色歌曲音源是能听歌的关键一环。flutter_rust_bridge依赖工具。负责 Dart 与 Rust 之间的自动桥接让纯 Dart 工程能调用 Rust 编解码与解锁模块。NeteaseCloudMusicApi参考项目。本项目的接口路径与返回结构设计参考了它若你想扩展某个接口可对照它的接口文档。just_audio / audio_service依赖库。前者负责播放内核后者提供前台服务与系统媒体通知播放能力基本架在这两个包上。❓ 常见问题 FAQ灰色歌曲点击后无声音或报 404原因未开启解锁开关或 Rust 模块未编译进包。解决方法确认设置里的灰色歌曲解锁已打开并且构建前 Rust 环境可用。flutter pub get之后构建报 Rust / bridge 相关错误原因flutter_rust_bridge 生成的 Dart 绑定与当前 Rust 模块版本不匹配。解决方法升级 Rust 工具链后按该桥接工具的官方流程重新生成绑定代码再执行构建。桌面端Windows/Linux窗口大小异常原因窗口尺寸与最小尺寸是在lib/main.dart的_initWindowManager里写死的1080×720。解决方法直接改这里的Size参数。iOS 构建失败原因Flutter 的 iOS 构建只能在 macOS 的 Xcode 环境进行且需要 CocoaPods 可用。解决方法在 Mac 上先执行pod install再构建或先用 Android 包验证流程。登录成功但推荐页是空的原因接口返回结构可能随网易云服务端调整而变化。解决方法对照lib/common/netease_api/下对应模块的 bean 定义排查字段必要时参考 NeteaseCloudMusicApi 的接口说明更新。想深入定制的话建议从lib/common/constants/colors.dart换一套自己的主题色入手半小时就能看到效果再往接口层走就是一个完整的第三方播放器改造流程了。【免费下载链接】bujuanFlutter移动端桌面端三方网易云播放器项目地址: https://gitcode.com/gh_mirrors/bu/bujuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
