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

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

准备工作

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

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

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

开发

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

发布

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

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

平台差异

这里只列出一些比较重要的差异，更多差异和细节请参考 uni-app文档 以及 字节跳动小程序 的文档。

组件

不支持的组件

• movable-area
• movable-view
• cover-view
• cover-image
• audio
• camera
• live-player
• map

不支持的 API

• WebSocket 的支持度较弱，详细请参考文档。
• getImageInfo
• getBackgroundAudioManager
• createVideoContext
• createCameraContext
• 文件部分只有一个 saveFile
• chooseLocation
• createMapContext
• 蓝牙
• 低功耗蓝牙
• iBeacon
• 设置 TabBar

其它差异

• 头条小程序的主体颜色是红色，具体表现在 button 的 default 类型。
• 没有分包
• rich-text 中的元素不能通过 class 来设置样式。

目前已知的就是这些，小伙伴们如果有其它发现，欢迎在社区向我们反馈，共同完善 uni-app 生态。

最后

更多实现的细节，还在持续完善中。如果在开发过程中遇到一些问题或发现差异，在向我们反馈之前，建议阅读下相应平台的文档，以便更加精准地定位问题。

• uni-app 开发支付宝/百度小程序注意事项
• 字节跳动小程序文档