- vue-cli4 vuex cmui html5 css3 typescript electron
- 一次开发,同时打包成Android版app、iOS版app、H5版、微信小程序版、支付宝小程序版、头条小程序、PC安装包平台这几个平台,界面统一,功能一致。
- 新引入electron用于支持打包PC端(Windows、Mac、Linux)安装包, 后续也关注鸿蒙系统
- cmui仓库为https://github.com/aiplat/cmui.git
- 代码示例为 https://aiplat.com 的版本 http://uniapp.aiplat.com
- 基于 https://uniapp.dcloud.io/ 的uni-app
- 基于本仓库所开发的‘娱乐计分器’已经成功上线微信、头条、支付宝三大程序,暂不开源。各框架在升级中。
- dist ------打包目录
- public index.html ------入口公共html
- screenshot ------运行环境截图
- src
- assets ------静态css文件目录
- builds ------运行构建时目录(git已忽略,不可手动修改)
- components ------公共组件目录
- electron ------electron目录, 用于支持打包PC安装包
- pages ------视图目录
- aiplat ------aiplat项目视图目录
- common ------公共页面目录
- *** ------若有多个项目,请在这新增不同目录区分
- plugins ------公共函数或插件目录
- lib ------第三方库目录
- cmapp.class.ts ------公共$cmapp配置
- uniAjax.ts ------公共$uniAjax配置
- projects ------多个小程序各配置目录
- aiplat ------aiplat配置信息目录
- *** ------若有多个项目,请在这新增不同目录区分
- service ------配置目录
- apis ------api扩展配置目录
- config ------config扩展配置目录
- api.ts ------公共$api配置
- config.ts ------公共$config配置
- static ------静态资源目录
- vuex ------vuex目录
- App.vue ------vue应用承载文件
- lib.d.ts ------typescript声明文件
- main.ts ------vue应用入口文件
- manifest.json ------应用配置文件(运行构建时生成,git已忽略,不可手动修改)
- pages.json ------页面配置文件(运行构建时生成,git已忽略,不可手动修改)
- plugins.d.ts ------typescript声明文件
- sfc.d.ts ------typescript声明文件
- src-builds ------框架运行构建时修改配置目录
- config.ts ------修改配置文件
- electron.ts ------electron相关执行文件
- utils.ts ------公共工具类
- $ git clone https://github.com/aiplat/uniapp.git
- $ cd uniapp
- $ npm install
- $ npm run dev (默认h5开发) h5运行默认打开 http://localhost:2016/#/
- $ npm run dev:mp-weixin (微信小程序开发)
- 打开微信开发者工具->小程序->导入项目->选择dist/dev/mp-weixin
- 若有多个项目同一个仓库,$ npm run dev --env=uat --type=** 区分
- $ npm run build (默认构建h5)
- $ npm run build:mp-weixin (微信小程序构建)
- 单个项目(默认aiplat)代码打包到了dist/build/mp-weixin
- 若有多个项目同一个仓库,$ npm run build --env=uat --type=** 区分
- 开发工具为任意,不一定要HbuilderX.如果也要同时打包成app,再导入项目到HbuilderX打包。
- 开发或构建成其他平台命令:
- dev为开发模式,build为构建模式
- 参数--env=uat为环境参数,默认uat。
- 参数--type=aiplat为项目名,默认aiplat。
- 例如:
- $ npm run dev:mp-weixin --env=uat --type=** 为微信小程序平台->uat环境(测试环境)->开发模式
- $ npm run dev:mp-weixin --env=ver --type=** 为微信小程序平台->ver环境(预生产环境)->开发模式
- $ npm run dev:mp-weixin --env=pro --type=** 为微信小程序平台->pro环境(生产环境)->开发模式
- $ npm run build:mp-weixin --env=uat --type=** 为微信小程序平台->uat环境(测试环境)->构建模式
- $ npm run build:mp-weixin --env=ver --type=** 为微信小程序平台->ver环境(预生产环境)->构建模式
- $ npm run build:mp-weixin --env=pro --type=** 为微信小程序平台->pro环境(生产环境)->构建模式
- app-plus: android、ios
- electron: PC安装包平台
- h5: h5(pc web、mobile web)
- mp-alipay: 支付宝小程序
- mp-toutiao: 头条小程序
- mp-weixin: 微信小程序
- 注意:百度小程序、QQ小程序、快应用、360小程序这4个平台uni-app也是支持的,本示例没有运行与构建这4个平台论证。
- manifest目录下还有uat/ver/pro(三个环境目录)
- manifest.json -- uni-app应用的配置文件,用于指定应用的名称、图标、权限等。运行微信和头条小程序时请先将其中的appid改为自己可用的。
- selfConfig.ts -- aiplat配置信息
- selfPages.json -- 用于对 uni-app 进行全局配置,决定页面文件的路径、窗口表现、设置多 tab 等
- 运行构建APP前先执行一次dev或build命令,使src目录里有以上对应的三个文件。
- 开发命令为npm run dev --env=uat --type=jifenqi
- 构建命令为npm run build --env=uat --type=jifenqi
h5运行默认http://localhost:2016/#/
- $ npm run dev:h5 --env=uat --type=aiplat
- $ npm run dev:electron --env=uat --type=aiplat
- 此时h5运行时项目运行到electron环境
- $ npm run build:h5 --env=uat --type=aiplat
- $ npm run build:electron --env=uat --type=aiplat
- 此时h5构建时项目运行到electron环境