# 开始
# 创建新项目(暂不可用)
执行命令:
npx cheers-mp create 项目名字
按提示选择自己需要的配置即可.
模板仓库传送门
自动创建项目功能未完善暂不可用,可先 clone typescript 仓库 demo 体验
# 已有的原生小程序使用
- 将源码放入
src
目录下,但是小程序的项目配置文件project.config.json
要放在项目根目录下; - 修改
project.config.json
中的miniprogramRoot
字段修改为dist/
- 确保项目根目录下有
package.json
文件,没有则运行npm init
命令初始化一个; - 执行命令安装核心包:
npm i cheers-mp-service -D
- 在
package.json
的scripts
字段中配置命令:
"scripts": {
"dev": "cheers-mp-service serve --open",
"build": "cheers-mp-service build --upload",
}
- 项目根目录下新增
cheers.config.js
配置文件
# 维护的仓库包
包名 | 描述 |
---|---|
cheers-mp-service | 核心包,脚手架入口,注册了一系列编译相关的命令、加载自定义插件 |
cheers-mp-cli | 负责创建新项目,初始化项目模板的程序(核心包已内置) |
cheers-mp-devtools-ci | 负责调用微信小程序开发者工具相关的 CI 命令,比如构建 NPM、上传(核心包已内置) |
cheers-mp-images | 负责将图片上传到阿里云或者七牛云 OSS (核心包已内置) |
gulp-cdnify-plus | gulp 插件,负责替换样式文件、wxml 文件中的图片地址 (核心包已内置) |
https://github.com/bigmeow/cheers-mp-template | 初始化项目具体的模板 |
# 项目推荐目录结构
├─dist # 编译后输出目录
├─docs # 项目文档介绍
├─key # CI上传密钥
├─src # 源码目录
│ ├─assets # 静态资源
│ │ └─images
│ ├─components # 基础自定义小程序组件
│ ├─pages # 主包存放的小程序页面
│ │
│ ├─service # 业务相关 ts
│ │ ├─api # 所有的 api ts
│ │ └─store # 存储相关
│ ├─sub-package # 子包
│ │ └─pages
│ │ └─test
│ └─utils # 工具类
│ └─wxs
├─typings # 类型定义
│
├─.env # 环境变量配置
│
├─cheers.config.js # 脚手架自定义配置
│
├─package.json
│
├─project.config.json # 小程序开发者工具配置文件
│
└─tsconfig.json # typescript 配置