CarbonROM Source

Thanks for choosing CarbonROM experimental!

Getting Started

To get started with the CarbonROM sources, you'll should be familiar with Git and Repo.

Create the Directories

You will need to set up some directories in your build environment. One is your local binaries folder (to install repotool) and the other is for your CarbonROM source.

To create them run:

mkdir -p ~/bin
mkdir -p ~/carbon

Install dependencies

Building Android has many dependencies that you need. Just stick this in your terminal and run it.

sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev libgl1-mesa-dev libxml2-utils xsltproc unzip python git-lfs

Install repo tool

Enter the following to download the "repo" binary and make it executable:

curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo

You will need to add the ~/bin folder to your path if you've not done so before.

Open your .bashrc file in your favourite editor, and add PATH=~/bin:$PATH to the end of it on a new line, then run source ~/.bashrc to update your environment.

sudo gedit ~/.bashrc
# add the line PATH=~/bin:$PATH to it
source ~/.bashrc

Initialising the repository

Move to the CarbonROM working directory and initialise the repo using the manifest located here, then sync the repos. You may get a prompt about using color. Just choose yes or no and hit enter.

cd ~/carbon
repo init -u https://github.com/carbonROM-experimental/android.git -b cr-8.0 --git-lfs
repo sync -j8

Yes, the branch is cr-8.0. That's CarbonROM 8, which runs on Android 10. Not Oreo. 10. Ten. T-E-N. TEN.

Troubleshooting

If you get an error about not locating your git details/email/name, you'll need to configure your details in the git config.

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

Building the system

macOS Users: you are required to install coreutils from MacPorts before you continue.

Initialize the environment with the envsetup.sh script. Note that replacing "source" with a single dot saves a few characters, and the short form is more commonly used in documentation.

. build/envsetup.sh
lunch

Enter the number of the build you want to start and press Enter.

After, run the make command. The top one will build at a speed that is most suitable for your device. You can manually set a number of threads to build with by replacing 12 in the bottom command with the number of threads to use.

make carbon -j$(nproc --all)
# or
make carbon -j12

Attention Themers

You can find all CarbonROM Resources that need to be themed here Let us know when there is anything else we can help with, we will gladly do.

Translating CarbonROM

We use crowdin for our ROMs translation. If you want to help with that, you can do so here. https://crowdin.com/project/carbonrom

The available projects to translate will be updated when new things come into Carbon, so be sure to keep on checking the page.

Many thanks to those who have helped translate the ROM!