uni-app 开发头条小程序注意事项

HBuilderX 1.6.0 开始，uni-app 支持开发头条小程序（字节跳动小程序）。

准备工作

首先，你需要下载相应的开发工具：

• HBuilderX
• 字节跳动开发者工具

下载安装完成后，打开 HBuilderX 配置菜单->工具->设置->运行配置->字节跳动开发者工具路径。
注意，需要配置到具体的执行文件，即 字节跳动开发者工具.exe 文件。

开发

• 选中 uni-app 项目，菜单->运行->运行到小程序模拟器->字节跳动开发者工具。
• 如果没有配置字节跳动开发者工具的路径，则会提示配置相关信息。
• 字节跳动开发者工具目前未支持直接唤醒并打开指定的项目，因此需要根据控制台提示的路径，再启动开发者工具后手动导入项目。
• appid 等信息，可以 manifest.json 的可视化界面中操作配置。

发布

开发模式下代码未压缩且含有 SourceMap 等资源，如果正式发布则需要使用发布功能。

• 填写 appid 等信息后，菜单->发行->小程序-字节跳动。
• 然后，请根据 HBuilderX 控制台的路径信息，在字节跳动开发者工具中导入最终的项目。
• 可能会存在重复的 appid 或项目名称，需要手动将之前开发模式的项目从字节跳动开发者工具中移除。
• 导入项目成功后，在字节跳动开发者工具中选择上传即可。

平台差异

• 头条小程序的主体颜色是红色，具体表现在 button 的 default 类型。
• 没有分包。但会自动处理流式加载。
• 今日头条、抖音、头条极速版，内置的小程序引擎功能略有差异，具体见https://developer.toutiao.com/dev/cn/mini-app/develop/multi-server-support/restrictions-for-apps