I wrote a Bitcoin Node setup post recently (hopefully you had a go?) and thought I’d show you how to setup an Android Open Source Project (AOSP) development environment and how to download the AOSP.
This tutorial will be for a Ubuntu 18.04 machine only. Other systems should be ok, such as ElementaryOS or newer versions of Ubuntu, but I’ve not tried any other. Feel free to get in touch if there is an OS you’d like me to demonstrate or if you’re having any issues
First things first, open a terminal using ctrl+tab+t and type the following:
sudo apt-get update
sudo apt-get upgrade
Once they are done we will have an up to date machine and should be good to get stuck into setting up for AOSP.
Our plan is to get the official AOSP source on our machines, if you want to check it out now you can visit https://android.googlesource.com/ for more on what we’re going to download.
If you popped by the link you’ll see there are a lot of repos available to you. Don’t manually download each one, we’ll get to that using the repo tool.
We need to install some packages to get our machine ready, so run:
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
Let’s install repo then:
sudo apt-get install curl
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
Now that we have the repo tool we need to make it executable
chmod a+x ~/bin/repo
Incase you run into any problems I had to update my repo so it called python3 instead of python. To do this navigate to ~/bin, open repo, and run edit the first line from
This tool will allow us to pull from multiple git repos to create our Android™ distribution.
We tell it the repos we want to pull using a manifest.xml file, which describes the projects to pull and their locations.
Now we want to get git, run the following:
sudo apt-get install git
Moving on to the reason we are here getting ourselves a copy of the AOSP:
First, lets create our directory.
mkdir -p ~/android/android-9.0.0_r50
Next up, navigate to the new directory
Then download the version of the source you want, see below for more details
repo init -u https://android.googlesource.com/platform/manifest.git -b android-9.0.0_r50
Then finally sync it, this will take a while.
Same as above and worth considering is using the -j flag with your sync, it allows you to sync repos in parallel. By default it will do 4 parallel downloads.
To get a different version of the AOSP visit https://source.android.com/setup/start/build-numbers#source-code-tags-and-builds and pick the one you’re after. Simply update ‘android-9.0.0_r50’ above with the Tag of the build you choose.
Great, so now we have our Android™ repos downloaded.
We’ll leave it at that for this post but I’ll be putting another out soon where we will build and create our own Android™ Distribution to run on an emulator.
Android is a trademark of Google LLC.