小猴偷米 Web (PWA) 项目
推荐使用 yarn 安装依赖,再执行开发脚本。脚本将会监听本地 8080 端口。
yarn
npm run dev
我们建议在服务器端 git clone
,并在服务端执行部署脚本,这是比较优雅且更接近持续集成的部署方式。
yarn
npm run build
部署脚本将并打包生成文件到 dist
目录,若其中有旧版生成文件,打包速度将显著加快。
-
Service Worker (
sw.js
) 是 parcel-plugin-sw-cache 在 parcel 打包后才执行的,不被 parcel 打包; -
由于 parcel 环境与 webpack 不同,本项目 pug 中不支持使用驼峰属性名,需要手动改写成中划线,否则会变成全小写;如果要全项目排查驼峰属性名,可以用正则全文搜索
[a-z]*[A-Z][a-z]*=['"]
; -
package.json
中babel
的module-resolver
插件可以代替webpack
中的alias
功能,其中设置了@
代表src
文件夹,static
代表static
文件夹;之所以在那里配置"vue": "vue/dist/vue"
是因为vue
的package.json
会默认指向vue/dist/vue-common
,导致运行时错误。 -
static
文件夹并不是真的静态,其中的图片或其他资源需要 import,之后将会变成生成后的路径字符串,可以插入图片的src
中使用,这一点与 React 中的使用方式类似。
- 请使用 JavaScript Standard 代码规范;
- 请使用规范的
pug
/es2015+stage-0
/stylus
书写; - 请熟悉 Chrome 或 Safari 的移动端模拟调试功能,并至少同时对 桌面端、Pad 端、手机网页、小程序 四种环境进行测试;
- 项目代码 100% 面向业务逻辑,工具函数或工具类请做成轮子再使用或找相关轮子使用,不要随地堆放工具代码。
我们鼓励校内同学在本项目中以 Issue 的方式提出反馈,如有开发能力,欢迎提出 PR。