ZMK固件开发：基于容器的本地工具链搭建指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00567/article/details/148578715

ZMK固件开发：基于容器的本地工具链搭建指南

zmk ZMK Firmware Repository 项目地址: https://gitcode.com/gh_mirrors/zm/zmk

前言

在嵌入式开发领域，搭建开发环境往往是最具挑战性的第一步。本文将详细介绍如何为ZMK固件项目搭建基于容器的本地开发环境，这种方法能有效解决环境依赖问题，让开发者专注于代码本身。

环境准备

获取源代码

首先需要获取ZMK固件的源代码。打开终端，导航到您希望存放项目的目录，执行以下命令：

git clone zmk.git

这将在当前目录下创建名为zmk的文件夹，包含完整的项目源代码。

开发工具安装

根据您的使用习惯，可以选择以下三种方式之一搭建容器环境：

1. VS Code方案（推荐）

这是最友好的图形化方案，适合大多数开发者：

安装Docker Desktop
安装VS Code编辑器
安装Remote - Containers扩展

2. Dev Container CLI方案

适合习惯命令行操作的中高级开发者：

安装Docker Desktop
安装Dev Container CLI工具

3. Podman方案

适合需要使用Podman替代Docker的场景：

根据系统安装Podman CLI或Podman Desktop
确保Podman machine正常运行

配置数据卷

为了在容器中访问配置文件和模块，需要创建数据卷：

对于Docker/Podman

配置目录

docker volume create --driver local -o o=bind -o type=none \
  -o device="/绝对路径/zmk-config/" zmk-config

模块目录

docker volume create --driver local -o o=bind -o type=none \
  -o device="/绝对路径/zmk-modules/父目录/" zmk-modules

在容器中，这些目录将被挂载到/workspaces/zmk-config和/workspaces/zmk-modules路径。

容器初始化

VS Code方案操作步骤

在VS Code中打开zmk目录
当出现"Reopen in Container"提示时点击确认
首次运行会自动下载Docker镜像并构建容器

CLI方案操作步骤

devcontainer up --workspace-folder "/绝对路径/zmk"

Podman方案操作步骤

podman build -t zmk-dev -f Dockerfile .devcontainer
podman run -it --rm \
  --security-opt label=disable \
  --workdir /workspaces/zmk \
  -v /路径/zmk:/workspaces/zmk \
  -v /路径/zmk-config:/workspaces/zmk-config \
  -v /路径/zmk-modules:/workspaces/zmk-modules \
  -p 3000:3000 \
  zmk-dev /bin/bash