更新日志

minapp.json 更新指南

  • Deprecated: compiler.px2rpxcompiler.rpx2px 已经废弃了,需要使用 compiler.unitTransformer 来替换,因为,v1.x 默认会开启 px2rpx 和 rpx2px,而在 v2.x 中,需要手动配置。详情参考此

  • Deprecated: compiler.devServer 中配置 porthost 将会无效,需要使用命令行配置,如 minapp dev —port 9000,或者使用 webpack.minapp.js 配置;另外,webpack4 会自动判断端口是否占用,如果占用会自动使用相邻的未占用的端口。

  • Added: compiler 下添加新的配置项:srcDir, distDir, npmOutputFolder, staticFileExtensions, staticOutputName, staticOutputFolder,详情查看自动补全

package.json 更新指南

  • Breaks: v2 不再使用 awesome-typescript-loader,改用了 ts-loader,所以 ts 项目需要在本地安装 ts-loader

  • Breaks: 使用 less 的项目需要额外安装 lessless-loader;而使用了 sass 的项目需要额外安装 node-sasssass-loader

  • Breaks: @minapp/core 中不再自带 wxwxp 模块,这些模块单独移动到 @minapp/wx 中了,所以当更新 @minapp/core 到 2.x 后,还需要安装 @minapp/wx

从 2.0.0 开始,@minapp/wx 以后会跟着官方 api 的版本号走,可能不会再和 @minapp/core 的版本保持一致,而要和小程序配置文件 project.config.json 中的 libVersion 版本号保持一致

快速更新 package.json:

  • ts 项目
    • 使用了 sass: npm i —save @minapp/core@2 @minapp/wx@2 && npm i —save-dev ts-loader sass-loader node-sass
    • 使用了 less: npm i —save @minapp/core@2 @minapp/wx@2 && npm i —save-dev ts-loader less-loader less
    • 使用了 css/wxss: npm i —save @minapp/core@2 @minapp/wx@2 && npm i —save-dev ts-loader
  • js 项目
    • 使用了 sass: npm i —save @minapp/core@2 @minapp/wx@2 && npm i —save-dev sass-loader node-sass
    • 使用了 less: npm i —save @minapp/core@2 @minapp/wx@2 && npm i —save-dev less-loader less
    • 使用了 css/wxss: npm i —save @minapp/core@2 @minapp/wx@2

webpack.config.js 或 webpack.config.ts 更新指南

完全兼容,可以不做修改;只是加了一个参数,和一个新的函数

  • Added: 修改 webpack 配置的函数添加第三个 env 参数,可以获取当前环境相关的数据,详情参考此
  • Added: 新添加一个函数 updateLoaders,可以修改 loader 或 loader 的配置,详情参考此

其它

  • 新添加命令 minapp clear,可以快速清空 dist 目录
  • 可以将 @minapp/cli 安装在本地,即使全局安装了 @minapp/cli,也会优先使用本地的命令行