问题描述
还在为K230/K230D编译环境搭建头疼?依赖冲突、配置繁琐、系统兼容问题反复踩坑?
今天正式宣布——K230 RTOS和Linux系统全面支持Docker编译!无需复杂配置,一条命令搞定环境,让开发效率直接拉满!
一、重磅更新:Docker编译,开发门槛大降
官方内置Docker编译方案,预配置k230-builder镜像,集成所有工具链、依赖库与编译脚本,跨系统可用、环境隔离、一次配置永久使用。不再因为本机安装多套构建系统互相影响而烦恼,不再因为缺少没有工具而东奔西走联系服务器管理员。只要你能执行docker, 新手也能10分钟上手编译!
二、Docker编译核心优势
✅ 极简部署,告别依赖噩梦无需手动装gcc、cmake、python库等依赖,拉取镜像即自带完整编译环境,杜绝“本地能编、服务器编不了”的兼容问题。
✅ 一条命令,全程自动化 从镜像拉取、代码同步、工具链下载到固件编译,全流程命令化,无需复杂配置,新手友好。
✅ 环境隔离,稳定不冲突Docker容器独立运行,不污染本地系统,多版本SDK切换无压力,团队协作环境完全一致。
✅ 全平台适配,Windows也能编 支持Windows(WSL2)、macOS、Linux,只要装了Docker,任意系统都能编译K230/K230D 固件。
三、保姆级编译步骤(直接复制执行)
1.前提准备
安装docker, 确认能使用非root用户直接执行。配置好Git的设置,确保Git能正常拉取代码。
# 1. 安装Docker(Ubuntu示例)
sudo apt install docker.io
sudo usermod -aG docker $USER && newgrp docker
# 2. 配置Gitee SSH密钥(代码下载必需)
# 3. 配置Git用户信息
git config --global user.email "你的邮箱"
git config --global user.name "你的用户名"
2. 安装k230 wrapper
curl -fsSL https://www.kendryte.com/misc/install.sh | bash
source ~/.bashrc
3.下载代码和编译
所有命令和原本机编译一致,仅需要在原命令前加上 k230, 即可通过docker执行。下述示例以k230_rtos_sdk的下载和编译举例说明(Linux SDK参见文档说明):
# 1. 创建工作目录并进入
mkdir -p ~/rtos_k230 && cd ~/rtos_k230
# 2. 拉取官方Docker镜像
k230 pull
# 3. 下载工具链(首次执行一次)
# RTOS SDK下载 TC1和TC3
k230 download-toolchains TC1 TC3
# 4. 初始化并同步代码(国内Gitee)
k230 repo init -u git@gitee.com:canmv-k230/manifest.git --repo-url=git@gitee.com:canmv-k230/git-repo.git
k230 repo sync -j$(nproc)
# 5. 选择板级配置(示例:01Studio)
k230 make k230_rtos_01studio_defconfig
# 6. 开始编译
k230 make
# 7. 查看编译产物(镜像目录)
ls -lh output/k230_rtos_01studio_defconfig/images/
4. 编译产物说明
生成的固件位于output/[配置名]/images/:
- .img:SD卡烧录镜像
- .kdimg:USB烧录/OTA升级镜像
四、常见问题速解
❌ k230命令未找到 → 执行source ~/.bashrc或重启终端。
❌ repo sync失败 → 检查Gitee SSH密钥,重试k230 repo sync -j4。
❌ 工具链下载失败 → 分批下载:k230 download-toolchains TC1再TC3。
五、总结
K230支持Docker编译,新手10分钟上手,老开发效率翻倍。赶紧更新体验,开启高效开发之旅~
官方参考文档:https://www.kendryte.com/k230_rtos/zh/main/userguide/how_to_build.html
https://www.kendryte.com/k230_linux/zh/main/userguide/how_to_build.html
