Skip to content

guide_zh

Jump to bottom
Finn.Zhang edited this page Jul 2, 2026 · 4 revisions

Cix Linux Opensource

English | 简体中文 |

权限要求

  • 编译需要在特权模式下进行（root 用户或具有 sudo 权限）

一、环境初始化

1. 安装基础依赖

一次性安装所有必需的系统和编译工具：

apt update
apt install -y git curl sudo wget python3-pip python-is-python3 \
             lsb-release p7zip-full p7zip-rar bison build-essential jq

2. 配置 Git 用户信息

git config --global user.name "your_account_name"
git config --global user.email "your_email@example.com"

3. 安装 Repo 工具

curl https://storage.googleapis.com/git-repo-downloads/repo -o repo
chmod +x repo
mv ./repo /usr/bin/

注意：repo 工具依赖 python3，上述步骤已安装 python-is-python3 确保 python 命令可用。

二、代码下载与工作空间设置

1. 创建并初始化工作空间

mkdir workspace
cd workspace
repo init -b cix_p1_k6.6_master https://github.com/cixtech/cix-manifest/

2. 同步代码

repo sync

同步最后一个仓库时耗时可能较长，且受网络波动影响，请耐心等待直至完成。

三、编译环境准备

1. 加载环境变量

source ./build-scripts/envtool.sh

2. 初始化环境

说明：

  • 26Q2 及之后版本：非 root 用户无需额外配置，只要当前用户具有 docker 权限即可正常初始化。建议不要直接使用 root 用户运行编译流程。
  • 25Q4 版本：需要执行以下命令完成初始化： 
    export USER=root
newer_env

26Q2 及之后版本已无需执行 newer_env，可直接进入下一步。

3. 下载编译资源

source ./build-scripts/envtool.sh
updateres
  • 资源包体积较大，下载时间较长属正常现象
  • 如果执行过程中报错提示"资源不完整"或解压失败，请重复执行该命令，直到成功为止

四、执行编译

1. 开始编译

source ./build-scripts/envtool.sh
build all

2. 编译产物

编译成功后，生成的镜像文件位于：

./output/cix_evb/images/

Clone this wiki locally