xuguanglang / tmac-music

基于Vue全家桶打造一个媲美原生体验的移动端Web App

基于Vue全家桶打造一个媲美原生体验的移动端Web App

项目说明：

• 项目来源于imooc，本着加深对Vue理解的目的，基于Vue全家桶从脚手架搭建到项目部署上线，打造一个媲美原生体验的功能完善、多屏适配的响应式移动端音乐项目！
• 使用qq音乐的播放源，由于其限制越来越严格，播放源经常变更或加验证导致部分无法播放，会随之修复

项目预览:

• 上线demo >>
• 扫码体验：（若微信扫描请点下方访问原网页）

• 图片演示：

• 推荐页 / 歌手页

• 播放器页 / 歌手详情页

• 播放列表页 / 用户中心页

Update

• 使用viewport单位方案实现移动端适配
• 利用postcss工具，处理浏览器兼容以及1px边框等常见移动端问题，可专注于业务逻辑开发，加快开发速度

module.exports = {
  "plugins": {
    "postcss-aspect-ratio-mini": {}, 
      "postcss-write-svg": {
        utf8: false
      },
      "postcss-cssnext": {},
      "postcss-px-to-viewport": {
        viewportWidth: 375,     // (Number) The width of the viewport.
        viewportHeight: 667,    // (Number) The height of the viewport.
        unitPrecision: 3,       // (Number) The decimal numbers to allow the REM units to grow to.
        viewportUnit: 'vw',     // (String) Expected units.
        selectorBlackList: ['.ignore', '.hairlines'],  // (Array) The selectors to ignore and leave as px.
        minPixelValue: 1,       // (Number) Set the minimum pixel value to replace.
        mediaQuery: false       // (Boolean) Allow px to be converted in media queries.
      }, 
      "postcss-viewport-units":{},
      "cssnano": {
        preset: "advanced",
        autoprefixer: false,
        "postcss-zindex": false
      },
  }
}

• Vuex + Stylus + localstorage实现颜色及图片背景换肤功能
  • stylus函数设置各皮肤样式
  • vuex定义各组件切换皮肤相应class的全局变量
  • 利用Vue.minx全局混入vuex全局变量
  • App.vue组件控制皮肤切换功能
  • 监控touch事件，水平滑动超过半屏则触发换肤事件
  • 用户当前选择皮肤保存在localstorage
• bug fixed : 部分不支持auto play、播放源受限、快速切歌歌词异常、词曲不同步等
  • fix(player): fix部分浏览器不支持auto play 使用空音频测试是否支持自动播放，不支持则监听document点击事件播放或者进入播放界面后切换成暂停状态提示用户点击
  • fix(player): fix music api qq音乐对audio播放源限制，需vkey验证，添加获取vkey的api
  • fix(player): fix播放bug 修正后播放源受限/网络错误时，清除歌词，进度条不可拖动，给出tip 针对快速切换歌曲添加timer

技术栈

技术

item	MVVM框架	状态管理	前端路由	js新标准	css 预编译	版本管理	构建工具	包管理	脚手架
技术	Vue.js（2.x）	Vuex	Vue Router	ES6	stylus	git	webpack 2.0	yarn	vue-cli

其他技术&工具

• Jsonp
  • 跨域来请求数据
• vue-axios
  • 数据请求 通讯
• Node.js
  • 利用Express搭建代理服务器，转发本地请求返回数据实现跨域
  • 项目编译打包后搭建本地测试服务器，回归测试
• vue-router
  • 结合 Vue 的异步组件和 Webpack 的代码分割功能，实现路由组件的懒加载以优化性能，加快首屏加载
• vue-lazyload
  • 实现图片懒加载，节省用户流量，优化页面加载速度
• better-scroll
  • 移动端滚动插件，使移动端滑动体验更加流畅
• shell
  • 编写自动化发布脚本
• nginx
  • 项目部署上线反向代理
• fastclick
  • 解决移动端300ms延迟
• charles
  • 移动端抓包，查看数据收发
  • 代理转发，部署上线前使用map local代理本地文件 map remote代理接口进行回归测试，防止代码压缩后网页显示效果不一致
• lyric-parser
  • 歌词解析
• Js-Base64

• Base64编码与解码

• iconfont
  • 图标库
• good-storage
  • 直接从storage存取数据，无需转换

项目运行

Clone项目

[email protected]:T-Macgrady/tmac-music.git

运行

• 安装nodejs环境,使用v6.12.3
• 安装包管理工具[email protected]
• 在项目根目录执行yarn初始化yarn / yarn install
• 启动项目
• 开发模式 : yarn run dev 生产模式 : yarn run dist
• 开发模式下预览项目

说明

• 如果对您有帮助，您可以点 "Star" 支持一下 十分感谢!

相关链接

本人博客