墨客云科技微信小程序简易开发框架使用指南
简介
微信小程序开发简易框架,100%兼容原生微信小程序,用于配合 mobox 使用。
获取体验
git clone http://internal.mokyun.com:5000/noreply/mp-template-public.git
环境配置
yarn install
框架目录结构
mp-template
├─ build // 编译脚本
├─ src // 业务代码
│ ├─ app.json
│ ├─ app.ts // 即app.js文件
│ ├─ app.wxss
│ ├─ config
│ │ └─ index.js // 配置已订阅的 mobox 服务的域名和 moboxID
│ ├─ lib
│ │ ├─ canvas.ts // 生成海报
│ │ └─ qiniu.ts // 上传七牛云文件
│ ├─ mb-lib
│ │ ├─ acorn.js
│ │ ├─ cache.ts // 加入缓存
│ │ ├─ date.ts // 日期格式
│ │ ├─ eval.js
│ │ ├─ mp-message.ts
│ │ ├─ runtime-lib.ts
│ │ ├─ runtime.ts
│ │ ├─ upload.ts // 上传文件
│ │ └─ util.ts // 工具类
│ ├─ pages
│ ├─ polyfill
│ ├─ sitemap.json
│ ├─ static
│ └─ wxs
├─ typings
├─ commitlint.config.js
├─ package.json
├─ project.config.json
├─ README.md
├─ tsconfig.json
├─ .eslintignore
├─ .eslintrc.js
├─ .gitignore
├─ .prettierignore
├─ .prettierrc
├─ .vscode
└─ yarn.lock
创建微信小程序
入门
- 初始化项目:
yarn reset,其中 agentUrl 为mobox服务 的负载地址, boxId 为mobox服务 的唯一标识,请向mobox开发者索要。 - 开始使用:
yarn serve; - 编码格式:我们建议使用VisualStudioCode为编码 IDE,并确认安装插件
Vetur、ESLint、Prettier; - 如何发布:
yarn build后通过微信开发者工具进行提交发布; - 修改配置:更改 agentUrl 及 boxId 请参见 src/config/index.js 文件;
- 更多命令:查看 package.json 文件;
进阶
- 更新接口文档:
yarn sync-doc; - 查阅接口文档:参见 typings/mobox-api.d.ts 文件;
常见问题
- 安装第三方组件,请使用文件形式引入,并且保证为
ES5文件,暂不支持npm形式安装组件; - 微信开发者工具中的本地设置请不要勾选
ES6转ES5以及更改默认的编译方式;