一键编译!K230 Docker环境正式上线

Viewed 25

问题描述


还在为K230/K230D编译环境搭建头疼?依赖冲突、配置繁琐、系统兼容问题反复踩坑?
今天正式宣布——K230 RTOS和Linux系统全面支持Docker编译!无需复杂配置,一条命令搞定环境,让开发效率直接拉满!
image.png

一、重磅更新: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

1 Answers

嘉楠开发者公众号原文:https://mp.weixin.qq.com/s/lzJkxWmTwSu6UvwSZsl5DQ