Skip to content

Latest commit

 

History

History
133 lines (113 loc) · 6.51 KB

README.md

File metadata and controls

133 lines (113 loc) · 6.51 KB
Raw

uniapp vue-cli4 typescript版本

代码目录结构

  • 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 ------公共工具类

clone

安装依赖

  • $ 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环境(生产环境)->构建模式

运行环境截图，screenshot目录，示例为aiplat项目

平台标识: 后面主要适配这几个平台, 如果也能适配到鸿蒙系统是最好

  • app-plus: android、ios
  • electron: PC安装包平台
  • h5: h5(pc web、mobile web)
  • mp-alipay: 支付宝小程序
  • mp-toutiao: 头条小程序
  • mp-weixin: 微信小程序
  • 注意：百度小程序、QQ小程序、快应用、360小程序这4个平台uni-app也是支持的，本示例没有运行与构建这4个平台论证。

projects -- 多个小程序各配置目录

默认aiplat,文件结构

  • manifest目录下还有uat/ver/pro(三个环境目录)
    • manifest.json -- uni-app应用的配置文件，用于指定应用的名称、图标、权限等。运行微信和头条小程序时请先将其中的appid改为自己可用的。
  • selfConfig.ts -- aiplat配置信息
  • selfPages.json -- 用于对 uni-app 进行全局配置，决定页面文件的路径、窗口表现、设置多 tab 等
  • 运行构建APP前先执行一次dev或build命令，使src目录里有以上对应的三个文件。

当有其他项目时如jifenqi(娱乐计分器,后续开源):

  • 开发命令为npm run dev --env=uat --type=jifenqi
  • 构建命令为npm run build --env=uat --type=jifenqi

关于electron运行、构建、打包

h5运行默认http://localhost:2016/#/

运行：首先运行h5版本，再运行electron

运行h5,单独git bash窗口1

  • $ npm run dev:h5 --env=uat --type=aiplat

运行h5之后，单独git bash窗口2

  • $ npm run dev:electron --env=uat --type=aiplat
  • 此时h5运行时项目运行到electron环境

构建：首先构建h5版本，再构建electron，再打包（待添加完善）

构建h5

  • $ npm run build:h5 --env=uat --type=aiplat

构建h5之后继续执行

  • $ npm run build:electron --env=uat --type=aiplat
  • 此时h5构建时项目运行到electron环境

打包PC安装包（待添加完善）