SkioFox/taro-music

taro-music

基于Taro与网易云音乐 api 开发，技术栈主要是：typescript+taro+taro-ui+redux+react-hooks,目前主要是着重小程序端的展示，主要也是借此项目强化下上述几个技术栈的使用，打造一个最佳实践项目，通过这个项目也可以帮助你快速使用Taro开发一个属于你自己的小程序，此项目会持续更新，欢迎watch和star～

快速开始

注意事项

taro3.3.14 已迁移完毕，目前大多数页面可以正常运行，迁移后性能比之前的taro2.x有所提升，还有一些细节有待进一步完善，如需查看 taro2.x 版本可自行切换到feature_taro2.x该分支查看

目前已将taro的版本升级到最新版本3.3.14,确保你本地的taro-cli的版本也是这个版本，可以通过taro info查看版本号，如果不是最新的话，可以通过执行taro update self(mac或者linux前面需要加上sudo)以及taro update project进行cli与项目依赖的更新保持一致，否则将会导致项目无法正常运行，了解更多详情可查看Taro 环境及依赖检测

重要说明

安装@tarojs/cli的时候需要注意加上版本号，也就是需要按照下方说明来看下执行的命令是否正确

  如果之前有安装其他版本的@tarojs/cli，需要先全局卸载，执行下方命令,执行完后再执行下方两步
  npm uninstall -g @tarojs/cli
  rm -rf node_modules
  ---------------
  第一步
  npm install -g @tarojs/cli@3.3.14
  or
  cnpm install -g @tarojs/cli@3.3.14
  or
  yarn global add @tarojs/cli@3.3.14

  第二步
  npm install
  or
  cnpm install
  or
  yarn

首先需要在 src 目录下创建一个config.ts,这样可以根据自己的需要将其替换成线上地址，接口服务是使用的NeteaseCloudMusicApi

export const baseUrl: string = 'http://localhost:3000' // 这里配置的这个url是后端服务的请求地址，示例中代表在本地启用的服务端口是3000，如果希望在真机上调试，那么就需要将后端服务部署到一个云主机上

在运行本项目前，请先确保已经全局安装了 Taro，安装可见官网指导

启动后端接口服务

git clone https://github.com/Binaryify/NeteaseCloudMusicApi.git

cd NeteaseCloudMusicApi

npm i

npm run start

接下来启动前端项目

git clone https://github.com/lsqy/taro-music.git

cd taro-music

npm i

npm run dev:weapp

功能列表

目录结构简要介绍

这里主要介绍下src目录，因为开发主要是在这个目录下进行的

- src
 - actions // `redux`中的相关异步操作在这里进行
 - assets // 静态资源目录，这里引入了所需的图片资源，以及`fontawesome`字体图标资源
 - components // 封装的项目中可复用的组件，目前只是抽象了`CLoading`(加载效果组件)、`CLyric`(歌词组件)、`CMusic`(正在播放组件)、`CSlide`(滑块组件)、`CTitle`、`CUserListItem`
 - constants // 项目中的常量定义，目前定义了`typescript`的公共定义、`reducers`的名称定义、状态码的定义
 - pages // 项目中的业务页面都在这个目录中
 - reducers // `redux`中的相关同步操作在这里进行
 - services // 可复用的服务可以放在这个目录中，目前只是封装了接口请求的公共服务，可以根据自己项目的需要进行其他服务的扩充
 - store // redux的初始文件
 - utils // 可以复用的工具方法可以放到这个目录当中，目前封装了格式化、歌词解析的相关方法
  - decorators // 抽象的装饰器，主要为了解决在切换页面之后仍然可以继续保持播放状态，因为目前`taro`不支持全局组件
 - app.scss // 全局样式
 - app.tsx // 全局入口文件
 - base.scss // 基础样式
 - config.ts // 项目的全局配置，目前只是配置了`baseUrl`是后端服务的基准请求地址