zmkfirmware/zmk-dev-xtensa-sample_controller

xtensa-sample_controller开发镜像

镜像概述

该镜像为xtensa-sample_controller目标架构专用的开发镜像，旨在为开发者提供完整、预配置的开发环境，支持基于该架构的应用程序开发、编译、调试及测试全流程。镜像集成了xtensa-sample_controller架构所需的专用工具链、依赖库及开发工具，简化环境配置步骤，确保开发环境一致性。

核心功能与特性

• 架构专用支持：针对xtensa-sample_controller架构深度优化，提供匹配的指令集支持和硬件特性适配
• 完整工具链：包含架构专用编译器、链接器、汇编器及调试器，支持C/C++等主流开发语言
• 预配置依赖：集成架构相关的系统库、头文件及开发依赖包，无需手动安装基础组件
• 开发便捷性：内置代码构建工具（如make、cmake）和版本控制工具（如git），支持一站式开发
• 环境隔离：通过容器化方式提供独立开发环境，避免与主机系统依赖冲突

使用场景

• 开发者在xtensa-sample_controller架构上进行应用程序开发、调试和测试
• 团队协作时统一开发环境，确保编译结果一致性
• CI/CD流程中集成作为构建节点，自动化完成xtensa-sample_controller架构的应用编译

使用方法

基本使用

通过docker run命令启动容器，挂载本地代码目录进行开发：

bash
docker run -it --rm -v /本地代码路径:/workspace docker.xuanyuan.run/xtensa-sample_controller-dev-image:latest

参数说明：

• -it：以交互终端模式运行容器，支持命令行操作
• --rm：容器退出后自动删除，释放资源
• -v /本地代码路径:/workspace：将本地代码目录挂载到容器内/workspace目录，实现代码共享与持久化

典型开发流程示例

1. 启动容器并挂载代码目录：

   bash
   docker run -it --rm -v /home/user/xtensa-project:/workspace docker.xuanyuan.run/xtensa-sample_controller-dev-image:latest
   

2. 在容器内进入工作目录并编译代码：

   bash
   cd /workspace
   make  # 或使用cmake等构建工具
   

3. 运行编译产物或进行调试：

   bash
   ./build/app  # 运行应用
   gdb ./build/app  # 使用gdb调试（若镜像包含gdb）
   

配置说明

当前镜像默认提供基础开发环境，暂无需额外配置。如需扩展功能（如添加特定库或工具），可基于该镜像构建自定义镜像：

dockerfile
# 自定义Dockerfile示例
FROM docker.xuanyuan.run/xtensa-sample_controller-dev-image:latest

# 安装额外依赖
RUN apt-get update && apt-get install -y 额外依赖包名称

# 添加自定义工具
COPY ./custom-tool /usr/local/bin/

构建自定义镜像：

bash
docker build -t custom-xtensa-dev-image -f Dockerfile .