2.0迁移指南

    新创建的项目不用关心迁移问题,直接开发即可,使用1.0时期的包等都不受影响。

    老项目可以有两种升级方式:

    一个有所变化的地方在于,新项目的打开项目方式发生了一些变化,原本用微信开发者工具打开项目目录变为了用开发者工具打开构建结果目录(dist或dist/wx,取决于是否用跨平台构建),变化的原因详情见下方 部分。

    如果你的项目之前就是手工配置的或者被个性化再次修改过或者对webpack配置非常熟练了解,也可以按照以下内容参考自行手工升级。

    • @mpxjs/webpack-plugin由1.x升级至2.0
    • 废弃,使用@mpxjs/api-proxy代替
    • 废弃,合入到@mpxjs/webpack-plugin中维护

    文件结构区别

    使用@mpxjs/cli脚手架生成的项目在1.0版本时期和2.0版本时期有些区别。

    早先因社区同学的建议使用了在项目根目录下的project.config.json文件中通过指定miniprogramRoot字段为dist,好处是不用复制,在微信小程序开发工具里可以用编辑器直接修改保存project.config.json文件。但跨小程序平台支持下,我们可能会在dist文件夹下再深一个层级区分不同小程序比如会有/dist/wx,/dist/ali,/dist/swan这样,出于打开项目体验的一致性等方面考量,决定这个微信特有的文件还是复制进构建结果里,不通过miniprogramRoot指定。