English | 简体中文

该工具包旨在快速开发内核模块，但不保证内核模块能够完全兼容对应版本的内核。

如果需要完全兼容性，请下载完整内核代码并自行编译，具体方法请参考相关文档。

如果不想下载 Clang，可以使用 NDK Clang 进行编译，但可能会导致编译产物的结构体偏移有所不同。

submodule 下的 prebuilts tarball 文件很大，非必要不要 clone submodules

内核模块开发模板：

Github

CNB

把下面内容放置到 .devcontainer/devcontainer.json

可以修改 features 的内容来自由组装想要的镜像，可以选择的版本参考 ddk image versions

参考：

• ddk-clang
• ddk-src

对于 M1 Mac + orbstack 用户，参考 module_template/.devcontainer 下的配置可以开发，还需要提取拉取镜像

docker run --platform linux/amd64 --rm -it docker.cnb.cool/ylarod/ddk/ddk-builder:latest

对于 x86_64 用户：

{
  "name": "ddk-module-dev",
  "image": "docker.cnb.cool/ylarod/ddk/ddk-builder:latest",
  "features": {
    "ghcr.io/ylarod/ddk/features/ddk-clang:latest": {
      "clangVer": "clang-r416183b",
      "setDefault": true
    },
    "ghcr.io/ylarod/ddk/features/ddk-src:latest": {
      "androidVer": "android12-5.10",
      "withKdir": true,
      "setDefault": true
    }
  },
  "remoteUser": "root",
  "postCreateCommand": "echo Devcontainer ready",
  "customizations": {
    "vscode": {
      "extensions": [
        "github.copilot",
        "github.copilot-chat",
        "github.vscode-github-actions",
        "llvm-vs-code-extensions.vscode-clangd",
        "ms-azuretools.vscode-containers",
        "ms-azuretools.vscode-docker",
        "ms-ceintl.vscode-language-pack-zh-hans"
      ]
    }
  }
}

推荐先安装便捷脚本 ddk（封装常用 docker 命令，强制 --platform linux/amd64 并将当前目录挂载为容器内的 /build）。

安装（macOS/Linux）：

# 将 ddk 安装到 /usr/local/bin 并赋予可执行权限
sudo curl -fsSL https://raw.githubusercontent.com/Ylarod/ddk/main/scripts/ddk -o /usr/local/bin/ddk
sudo chmod +x /usr/local/bin/ddk

用法示例：

# 拉取镜像
ddk pull android12-5.10

# 进入项目目录
cd /path/to/source

# 构建
ddk build --target android12-5.10

# 传递 make 参数
ddk build --target android12-5.10 -- CFLAGS=-O2

# 清理
ddk clean --target android12-5.10

# 交互式 shell
ddk shell --target android12-5.10

如果你不想在每次命令中传入 target，可以设置环境变量 DDK_TARGET：

export DDK_TARGET=android12-5.10
ddk build   # 会使用 DDK_TARGET

参考下面的文件构建：

• 通用 Matrix 构建模板：ddk-lkm.yml
• Module Template 构建：module.yml

把下面内容放置到 .devcontainer/devcontainer.json

可以修改 image 的内容来选择对应的版本开发，可以选择的版本参考 ddk image versions

{
  "name": "ddk-module-dev",
  "image": "ghcr.io/ylarod/ddk:android16-6.12",
  "remoteUser": "root",
  "postCreateCommand": "echo Devcontainer ready",
  "customizations": {
    "vscode": {
      "extensions": [
        "github.copilot",
        "github.copilot-chat",
        "github.vscode-github-actions",
        "llvm-vs-code-extensions.vscode-clangd",
        "ms-azuretools.vscode-containers",
        "ms-azuretools.vscode-docker",
        "ms-ceintl.vscode-language-pack-zh-hans"
      ]
    }
  }
}

• 感谢 cnb.cool 提供的 计算资源