环境搭建

本文描述如何搭建蓝牙子设备开发框架的编译环境。

安装 Git

前往 Git 官网 下载最新版本，进行默认安装。

安装 Python

前往 Python 官网 下载 3.8.10 版本，进行默认安装。

注意：Windows 下安装 Python 后，在安装路径下默认是 python.exe，需要复制一份并重命名为 python3.exe。如果 python3.exe 已存在，请忽略该步骤。

安装完成后，进行验证。

安装 Visual Studio Code

前往 Visual Studio Code 官网 下载最新版本，进行默认安装。非常建议安装以下 Visual Studio Code 插件：

安装 Tuya Wind IDE

Visual Studio Code 安装完成后，在插件栏搜索 Tuya Wind IDE 并进行安装。更多信息，参考 Tuya Wind IDE。

安装完成后，采用账号登录（同涂鸦开发者平台账号）。如果没有账号，请前往 涂鸦开发者平台 进行账号注册。

安装芯片依赖环境

参考 开发平台 子目录下相应开发平台文档的 软件环境 章节。

获取开发框架

1. 在 Visual Studio Code 下登录 Tuya Wind IDE 账号，然后选择 新建开发框架 进行开发包选择。

   

2. 选择到合适的开发包后，单击 完成 并开始拉取，拉取完成即可进行相关功能的开发。

   

3. 等待开发框架拉取完成。

   

编译开发框架

1. 找到 Demo 所在目录，在该目录上右键选择 Build Project。

   注意：编译之前，务必按照以上教程完成所有 搭建软件环境 的步骤。

   

2. 手动输入版本号。该版本号即为编译生成的固件版本号，用于授权和 OTA 升级。

   

3. 等待编译成功。

   

使用第三方开发工具

使用 Keil 等第三方开发工具编译前，必须要使用 Visual Studio Code 进行一次编译。

打开 Keil 等第三方开发工具前，首先关闭 Visual Studio Code，防止两个软件发生冲突。

在以下目录找到 Keil 等第三方开发工具的工程文件，打开后可以进行正常的编译和调试。

添加文件

切勿使用 Keil 进行源文件和头文件的添加操作。

1. 在如下目录下添加源文件。

   

2. 在如下目录下添加头文件。

   

3. 源文件/头文件添加完成后，至少使用 Visual Studio Code 进行一次代码编译，之后可继续使用 Visual Studio Code 或者切换到 Keil 等第三方开发工具进行代码调试工作。

注意事项

• 第一次编译必须使用 Visual Studio Code，脚本会自动构建编译环境，之后您可以打开 IAR 或者 Keil 等第三方开发工具进行调试。

• Visual Studio Code 下的脚本会递归遍历 tuyaos_demo_ble_peripheral 文件夹，自动添加该文件下所有的源文件和头文件到编译环境。

• Visual Studio Code 在每次编译前，都会重新构建编译环境，以下操作要特别注意：

  • 在使用 IDE 编译时，请关闭 IAR 或者 Keil 等第三方开发工具，否则可能会导致文件占用的问题。

  • 在使用 IAR 或者 Keil 等第三方开发工具进行调试的时候，禁止手动添加头文件或者源文件到工程项目中。