公告：App老版“自定义组件编译模式”将于2020年4月的HBuilderX 2.7版本下线

从2018年至今，uni-app的编译器历经了3代发展：非自定义组件模式、自定义组件模式、v3编译器。

在经历了3次重写编译器后，v3的出现，代表着uni-app进入成熟期。

关于v3编译器的新特性介绍，详见：https://ask.dcloud.net.cn/article/36599

v3编译器凝集了DCloud团队在2年的uni-app开发历程中的所有经验和教训，吸收了数百万开发者在实践中的反馈，在架构层面堪称完美。

在可预见的将来，DCloud不会立项开发v4编译器，而是将在v3的架构上持续迭代完善。

目前“非自定义组件模式”已经下线，“自定义组件模式”也走到生命周期的尾声。

为了集中精力、减少包体积，2020年4月发布的HBuilderX 2.7版本起，及对应的App SDK包，将不再提供“自定义组件模式”。（uni小程序sdk本身也仅支持v3）。

届时新版uni-app里将没有各种编译器的概念，包括v3的概念也没有，manifest里会取消所有编译器设置，项目默认运行在v3编译器下。对于新的开发者，他将无需理解这些编译器名称、区别。

与非自定义组件升级自定义组件不同，自定义组件升级v3正常没有需要改代码的地方，在设计上是完全向下兼容的。

如果你的App之前正常，但勾选v3编译器后异常，有2种可能：

1. v3编译器有bug，请在社区单独发帖，提供重现方式。DCloud会优先解决，保障v3的向下兼容性。
2. 你的应用之前使用了不推荐的写法，比如一些hack方式。此时需要你更正为正确的写法。如果正常写法无法满足你的需求，请发帖告知我们。

因v3的升级是app-vue端的，如果你之前的应用不涉及App端，或者App是纯nvue的，那么不受“自定义组件模式”下线的影响。

详细的过渡调整方案如下：

• HBuilderX 2.6.9开始，manifest.json的默认值从非v3调整为v3，即不写"compilerVersion" : 3,，也是v3编译模式。如果需要降级为非v3，请在manifest可视化界面-App其他常用配置 中去掉v3编译器的勾选。

• HBuilderX 2.7开始，将移除非v3编译器，只保留v3编译模式。如果开发者使用老版HBuilderX，也仍然可使用非v3编译器。本地打包可以通过使用老版的sdk来继续使用非v3。然后云打包将于5月底不再支持非v3的打包。

不管HBuilderX新版怎么调整，开发者已经发布在线上的App不会受到影响。

最后，再次强调，官方之所以敢于下线老版，是因为这2个编译器的差异没有那么大。正常老应用应该都是可以兼容的。如果在发布2.7版本前，v3的向下兼容性问题没有修复完毕的话，是不会强制下线的。

目前已知的主要问题就是subnvue的postmessage通信写法不再支持，建议使用新的页面通信方式https://uniapp.dcloud.io/collocation/frame/communication，更新常见问题排查：https://ask.dcloud.net.cn/article/37342。

另，最新的HBuilderX 修复了很多v3的bug，如果要报新bug，请体验新版后再报。

注意：我们强烈建议开发者尽快升级v3版本，因为后续新增功能仅支持v3版本，非v3版本将不再维护。如果您坚持使用老的编译器，有两个方案：

1. 离线打包
2. 使用HBuilderX 2.6.16 版（参考https://ask.dcloud.net.cn/article/37302下载历史版本），该版本将继续支持云端打包，其它老的HBuilderX版本将不再支持云端打包。注意，2.6.16版目前仅支持非v3打包，如果是v3版，请正常升级最新HBuilderX。