如何从零跑起插件化音乐播放器 MusicFree一份完整上手指南【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree你想在同一台手机上保留几家平台的歌单又不想忍受广告和会员墙。MusicFree 是一款开源的插件化音乐播放器App 本身不带任何音源搜索和播放全部由插件注入音乐源由你自己挑。下面介绍怎么跑起来以及它日常能做什么。 项目速览MusicFree 的定位是播放器壳 插件音源界面、播放控制、歌单、歌词这些基础能力由 App 提供歌从哪来交给插件决定。项目基于 React Native 和 TypeScript 编写按 AGPL 3.0 协议开源免费使用。目前主要支持 Android 平台也适配 HarmonyOS当前版本信息记录在 release/version.json 中。主界面大致长这样 快速上手1. 拿到项目把仓库克隆到本地应用入口在 src/entry/ 目录git clone https://gitcode.com/GitHub_Trending/mu/MusicFree2. 一键完成首次配置进入目录后安装依赖各项构建脚本都声明在 package.json 中cd MusicFree yarn install3. 开始使用连接手机或模拟器执行下面命令打包并安装到设备上yarn android装好后打开 App在侧边栏的插件设置里安装一个音源插件搜索框就能出结果了。插件管理入口在 src/pages/setting/settingTypes/pluginSetting/ 目录下。 它是怎么工作的可以把它想成一间毛坯房墙、电、水管都装好了插座上插什么电器由你决定。App 负责播放、暂停、进度、歌词这些基础设施而搜索歌曲、获取音质、导入歌单这些功能都由插件以 commonjs 模块的形式注入。安装插件后插件管理逻辑 会把它注册、启用并负责缓存和排序。你在界面里选了哪个音源App 就调用哪个插件的对应函数切换音源时只需在插件列表里开关和拖动顺序不用重装应用。侧边栏长这样插件、设置、歌单都从这里进入 典型使用场景三步切换音乐源你想从 A 音源换到 B 音源打开侧边栏的插件设置把要用的插件打开、不用的关掉再拖动排序。之后搜索和推荐歌单都会按启用的音源出结果入口是 插件设置页。一键完成主题换肤你想要深色界面或自定义背景打开 主题设置切换浅色或深色模式再选一张背景图界面颜色会实时变化。边听边看歌词你想让歌词跟着歌走进入正在播放的歌曲页当前行会逐句高亮。没有歌词的歌可以把另一首歌的歌词关联过来关联后两首歌共用同一份歌词。 想动手扩展想写自己的插件先读 插件接口定义它规定了搜索、播放、歌词等每个函数要接什么参数、返回什么结构写完在插件设置里安装即可。版本迭代情况可以对照 release/version.json 查看。MusicFree 把播放器做成了一个稳定的壳把音源选择权交给插件数据全部存在本地。它的核心逻辑、插件协议、界面代码都放在仓库里对想读源码的人是透明的。如果你想弄清某个功能怎么实现或打算从第一个插件开始动手去仓库翻一翻源码是个不错的起点。【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考