本帖最后由 keer_zu 于 2022-4-25 09:34 编辑
4.部署开发板支持包到Studio SDK Manager简述rt-thread studio 作为一款支持众多芯片厂商的IDE,必不可少地具备了资源包管理的功能。rt-thread studio 采用SDK manager 在线管理资源包。目前包含以下类型的资源包。 [td]资源包名 | 内容 | Board Support Packages | 开发板支持包,rt-thread studio 新建开发板工程时使用的模板 | Chip Support Packages | 芯片支持包,rt-thread studio 新建芯片工程时使用的模板 | Debugger | 调试器后端,如J-Link,PyOCD等 | RT-Thread Source Code | RT-Thread 源码包 | ThirdParty Support Packages | 第三方工具支持包:例如 PlatformIO | Tool Chain | 工具链支持包 |
SDK manager 通过 SDK index(托管在github) 查找各个资源包的下载地址,下载至本地并解压,因此整个资源包上线的过程就是完善SDK-index中对应信息的过程。 上线流程- 在github.com 新建一个仓库,存储制作好的开发板支持包,需要满足以下格式
- 将开发板支持包 push 到建好的 github 仓库中,并发布一个 release,需满足以下条件
新建芯片厂商文件夹,名字于上述添加字段相同,如 STMicroelectronics,文件夹中新建index.json,并在此文件中添加此芯片厂商包含的开发板支持包,对于已存在的芯片厂商只需要在已存在的 index.json 中添加新的开发板字段,例如ST {
"name": "STM32 Series Board Support Packages",
"dvendor": "STMicroelectronics",
"description": "STM32 series Board Support Packages",
"index": [
"STM32F072-ST-NUCLEO",
"STM32F091-ST-NUCLEO",
"STM32F103-DOFLY-M3S",
"STM32F103-DOFLY-LYC8"
]
}
新建开发板支持包文件夹,名字与上述index.json中对应字段相同,如 STM32F072-ST-NUCLEO,并在文件夹中新建index.json,在此文件中添加对应开发板信息,如 STM32H750-RT-ART-Pi ,url 为 release 时的 Source code的下载链接 {
"name": "STM32H750-RT-ART-Pi", // 开发板支持包名称
"vendor": "RealThread", // 开发板厂商
"description": "STM32H750-RT-ART-Pi Board Support Packages", // 资源包描述
"license": "", // license 描述
"repository": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi.git", // 资源包仓库URL
"releases": [
{
"version": "1.1.0",
"date": "2020-12-01",
"description": "released v1.1.0",
"size": "152 MB",
"url": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi/archive/1.1.0.zip"
},
{
"version": "1.0.1", // 资源包版本号
"date": "2020-10-23", // 发布日期
"description": "released v1.0.1", // 版本描述
"size": "136 MB", // 资源包大小
"url": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi/archive/1.0.1.zip" // 资源包下载URL(包格式为zip)
}
]
}
- 注意事项:
- 索引仓库中不要出现非ascii 字符
- 开发板支持包名称 name字段 保持大写字母和中划线组合
- 上述json编写规范见下节
- 将改好的 sdk-index 仓库 push 到 github,并向官方 sdk-index 提出 PR
- PR 合并后,开发板支持包将会更新在 Studio 的 SDK Manager 界面里
index.json 编写规范 {#1}索引库按照资源包类型进行目录划分,各级目录下有对应的 index.json 作为索引,下面以添加 STMicroelectronics 的 STM32F746-ST-DISCO 开发板支持包为例,简述编写规范 目录结构如下,并在 STM32F746-ST-DISCO 目录下新建 index.json sdk-index/Board_Support_Packages/STMicroelectronics/STM32F746-ST-DISCO/index.json {
"name": "STM32F746-ST-DISCO", // 开发板支持包名称
"vendor": "RealThread", // 开发板厂商
"description": "STM32F746-ST-DISCO Board Support Packages", // 资源包描述
"license": "", // license 描述
"repository": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32f746-st-disco.git", // 资源包仓库URL
"releases": [
{
"version": "1.0.0", // 资源包版本号
"date": "2021-02-23", // 发布日期
"description": "released v1.0.0", // 版本描述
"size": "7 MB", // 资源包大小
"url": "https://github.com/RT-Thread-Studio/sdk-bsp-stm32f746-st-disco/archive/1.0.0.zip" // 资源包下载URL(包格式为zip)
}
]
}
注: 注:注意 json 和 yaml 文件的语法格式是否正确,可以在以下两个网站进行检查:
|