Home

Cix Android Opensource

English | 简体中文 |

---

Prerequisites

• Compilation must be performed with root or sudo privileges.

I. Environment Setup

Hardware Requirements

We recommend an Ubuntu machine with at least 32GB physical RAM and 32GB or more swap memory.

1. Install Dependencies

Install tools with apt-get (run as root or with sudo). Install all required system and build packages in one step:

sudo apt-get -y update
sudo apt-get -y install lsb-release autoconf autopoint bc \
    bison build-essential cpio curl device-tree-compiler \
    dosfstools doxygen fdisk flex gdisk gettext-base git \
    libncurses5 libssl-dev libtinfo5 m4 mtools pkg-config \
    python2 python3 python3-distutils python3-pyelftools \
    rsync snapd unzip uuid-dev wget scons perl libwayland-dev \
    wayland-protocols indent libtool dwarves libarchive-tools \
    xorriso jigdo-file python3-pip vim sudo parted cmake \
    golang libffi-dev u-boot-tools img2simg libxcb-randr0 \
    libxcb-randr0-dev libxcb-present-dev libxau-dev libelf-dev \
    python3-mako libglib2.0-dev-bin binfmt-support qemu \
    qemu-user-static debootstrap multistrap debian-archive-keyring \
    ser2net git-lfs zstd debhelper jq pigz zip

2. Install pip

wget https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py

3. Update Python Tools

pip uninstall pyOpenSSL
pip install --upgrade --force-reinstall 'requests==2.31.0' 'urllib3==1.26.0' 'meson==1.3.0' 'ply==3.11' 'cryptography==41.0.7' 'docutils==0.18.1' openpyxl nexus3-cli launchpadlib pyOpenSSL -i https://pypi.tuna.tsinghua.edu.cn/simple

4. Configure Git

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

5. Install the Repo Tool

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

Note: The repo tool requires Python 3, which is installed in step 1.

II. Code Download and Workspace Setup

1. Initialize the Workspace

mkdir workspace
cd workspace
repo init -b cix_android16_2025q3_dev https://github.com/cixtech/android-manifest

2. Sync the Codebase

repo sync

Optional flags for a slower but more conservative sync: -c -j1 --fail-fast (current branch only, one repo at a time, stop on first failure).

Android uses many repositories; syncing can take a long time and may fail. Retry if sync fails.

III. Build

1. Start the Build

source build/envsetup.sh

lunch sky1_evb-bp2a-userdebug

./build-android.sh -j<N>

Set -j<N> according to your host (for example -j10).

2. Build Artifacts

After a successful build, images are located at:

./out/target/product/sky1_evb/images