字节跳动小程序依托字节系全生态产品，为用户提供更智能、高效的链接内容与服务的方式。开发者能够利用字节跳动小程序丰富的基础能力，快速接入并完成小程序服务搭建。

在正式开发小程序之前，你需要先了解注册账号、安装开发者工具、创建小程序等几个步骤。

安装开发者工具

在开发之前，你需要安装小程序开发工具。安装完成后即可打开小程序开发者工具，目前支持手机登录、邮箱登录和抖音 APP 扫码登录。

更详细的的操作指南，可以参考小程序开发者工具概述。 小程序具体能力说明可查看框架列表。 有问题请在抖音开放平台社区中查询及反馈。

开发你的字节小程序

在开发者工具登录平台账号。开发者工具支持手机号登录、邮箱登录、抖音扫描登录。

开发者工具支持以下四种方式创建开发项目，同时提供了相关的开发工具辅助开发者提升开发效率。

1. 新建项目
2. 导入已有项目
3. 通过模板创建
4. 从微信小程序工程导入

新建项目

点击「新建」，即可新建工程。根据提示设置项目名称、 根目录、AppID。点击「新建项目」，进入主界面。

查找 AppID 有以下几种情况：

1. 已创建小程序：可前往「抖音开放平台」-「控制台」- 我的应用下，查找需要开发的小程序 AppID。
2. 已入驻抖音开放平台但未创建小程序：若控制台下无小程序，请先创建小程序。
3. 未入驻抖音开放平台：可点击下方“测试号”自动填充测试 AppID。

导入已有项目

1. 导入项目包中，需含有 project.config.json 文件。
2. 若导入的项目是有效的字节小程序项目，将自动填充项目名称与 AppID。
3. 若未自动填充，只需手动填写项目名称和 AppID，即可将项目导入到 IDE 中打开。

通过模板创建

1. 在小程序界面的选择模板页，可选择适用的模板，基于模板更快捷地创建小程序。
2. 小程序能力展示模板：提供了丰富的前端组件和通用的接口能力。
3. 图文详情模板：通用的图文详情模板，如文章标题、作者、正文、banner 等。

从微信小程序工程导入

帮助开发者将微信小程序快速迁移到字节小程序。详情请参考本文档【开发辅助】-【一键搬家工具】。

编译预览

点击工具栏上的编译按钮，可以在工具的左侧模拟器界面看到小程序的渲染结果，也可以点击预览按钮，通过今日头条、抖音等 App 的扫一扫在手机上体验你的第一个小程序。

上传

点击工具栏的上传按钮，填写本次上传版本号和更新日志。此外还支持上传 sourcemap。

• 上传版本：符合 semver 规则的版本号字符串，且高于线上已有版本号。（初次上传时，符合规则的任意版本均可）。
• sourcemap：sourcemap 的同步上传有助于线上代码的错误堆栈分析。具体使用路径在「应用详情页」 -「开发」-「开发日志」-「错误列表」-「查看详情」- 「详细信息」 中。