[GUIDE][ICS] Compile Cyanogenmod 9 on Mac OS X Lion

DISCLAIMER: I'm not responsible if you blow yourself up, blah blah blah
However, I've tried to make this as noob friendly as possible because, well I'm a noob myself

• Open Terminal and run
  Code:

  java

  if you don't have Java, you will get a prompt asking you to download and install Java. Go ahead and install it.
• If you don't have adb and fastboot working, download the android-sdk from google (version r18 as of now) and put it in /usr/local/ and rename the folder to "android-sdk".
• Install the homebrew package manager
  Code:

  /usr/bin/ruby -e "$(/usr/bin/curl -fsSL https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)"

• To make sure that homebrew and android-sdk executables are in $PATH:
  Code:

  touch ~/.bash_profile && echo "PATH=/usr/local/bin:/usr/local/sbin:$PATH:/usr/local/android-sdk/tools:/usr/local/android-sdk/platform-tools" >> ~/.bash_profile

  Relaunch Terminal for the change to take effect.
• At this point you can run
  Code:

  brew doctor

  to detect any problems there might be (Homebrew may instruct you to use the xcode-select utility to select the xcode installation path). Hopefully, your system is raring to brew
• Now we have to install a bunch of packages:
  Code:

  brew install git coreutils findutils gnu-sed gnupg pngcrush repo

• We now need to create a couple of symlinks so that the gnu versions of 'sed' and 'find' are used rather than the osx provided versions :
  Code:

  ln -s /usr/local/bin/gfind /usr/local/bin/find && ln -s /usr/local/bin/gsed /usr/local/bin/sed && ln -s /usr/local/bin/gstat /usr/local/bin/stat

• It's time to create a case sensitive image which will hold our working directory:
  Code:

  hdiutil create -type SPARSE -fs "Case-sensitive Journaled HFS+" -size 40g -volname "android" -attach ~/Desktop/Android

  Now we have a disk image in ~/Desktop/Android. Mount it if it's not mounted already. (Don't be picky about the size, the image will only take as much as space as its contents).
• Now we need to create a working directory inside the mounted volume:
  Code:

  cd /Volumes/android && mkdir cm9 && cd cm9

• We can initialize and download the source now:
  Code:

  repo init -u git://github.com/CyanogenMod/android.git -b ics && repo sync && say 'finished'

• Now we need to get the required proprietry files for our device. We can get these from the device itself. Connect your phone (make sure USB Debugging is enabled) and run the following (for maguro):
  Code:

  cd /Volumes/android/cm9/device/samsung/maguro/ && ./extract-files.sh

  [If you see errors in the output from extract-files.sh, see the Troubleshooting section below]
  For Google devices,we can also get them directly from google. For maguro, download the 3 files and extract them to /Volumes/android/cm9. Then,
  
  Code:

  cd /Volumes/android/cm9
  /Volumes/android/cm9/extract-broadcom-maguro.sh
  /Volumes/android/cm9/extract-imgtec-maguro.sh
  /Volumes/android/cm9/extract-samsung-maguro.sh

• We also need the prebuilts (like ROM manager and Term.apk):
  Code:

  /Volumes/android/cm9/vendor/cm/get-prebuilts

• You can optionally tell the build to use the ccache tool. CCache acts as a compiler cache that can be used to speed-up rebuilds :
  Code:

  export USE_CCACHE=1 && /Volumes/android/cm9/prebuilt/darwin-x86/ccache/ccache -M 20G

  Default is 1GB. Anything between 20GB-50GB should be fine.
• Before starting the build, we need to workaround an issue with Lion and compiling the QEMU emulator.
  [This step doesn't seem to be needed anymore. QEMU is automatically ignored on OS X/Darwin]
• If you build now, you're probably gonna get kernel build errors regarding the missing elf.h header (this error might be device specific). Fortunately, we already have this file downloaded, so we only need to copy it to /usr/local/include:
  Code:

  cp /Volumes/android/cm9/external/elfutils/libelf/elf.h /usr/local/include

• FINALLY, we are ready to build:
  Code:

  cd /Volumes/android/cm9 && source build/envsetup.sh && brunch

  Pick your device from the list and enter the number. For maguro, you could use "brunch maguro" instead and skip the menu. Depending on your system, this will take 30min-4hours.
• You should now see a beautiful zip file waiting to be flashed:
  
  
  

• The extract script for maguro seems to be a little outdated, as it doesn't pull the gps proprietary blob. You can either use the google provided scripts, or add koush's git repository for your device to your local_manifest.xml.

• As explained above, the CM9 source is currently compatible with llvm-gcc. In the future, if llvm-gcc fails to build correctly, you should try installing and compiling using GCC4.2 (the Xcode 3 compiler). You can install apple-gcc4.2 from homebrew:
  
  Code:

  brew install https://raw.github.com/Homebrew/homebrew-dupes/master/apple-gcc42.rb

  This version of gcc can happily coexist with Xcode 4.x .
  So now you have GCC 4.2 installed, but it won't be used unless we update the corresposing environment variables:
  
  Code:

  export CC=/usr/local/bin/gcc-4.2 && export CXX=/usr/local/bin/g++-4.2

  Notice that using the export command is temporary. If you relaunch Terminal, you will need to set these again. However, this is a good thing, because changing these values permanently (by putting them in ~/.bash_profile) can interfere with other builds.
  If you use this method, the build might fail while compiling "external/zlib/x86/adler32.c". It appears that a recent change in zlib has introduced an incompatibility with gcc 4.2. you have to revert the following 2 commits:
  Code:

  cd external/zlib
  git revert dd6786cae3f4493faa6661d5f74db587932f15d7
  git revert 13bf40af68236c961542bdee1d4b7c0176bf15a0

  Alternatively, you can add topprospect's zlib on github (which has those commits reverted) to your local_manifast.xml. Simply run:
  
  Code:

  nano /Volumes/android/cm9/.repo/local_manifest.xml

  and add the following line
  
  Code:

  <project name="dferg/android_external_zlib" path="external/zlib" remote="github" />

• If you get a build error, and your error is not covered here, copy the last 20-30 lines of the build output AND the output from the following command into pastebin and post the link. Hopefully me or someone else will help you.
  Code:

  echo -e "\nENV:\n$(env)\n\nWHICH GCC\n:$(which gcc)\n\nWHICH G++:\n$(which g++)\n\nWHICH CC:\n$(which cc)\n\nWHICH C++:\n$(which c++)\n\nBREW DOCTOR:\n$(brew doctor)\n\nBREW LIST:\n$(brew list)\n\n/USR/BIN:\n$(ls -l /usr/bin | grep gcc)\n\n/USR/LOCAL/BIN:\n$(ls -l /usr/local/bin | grep gcc)\n\n"

• To quickly setup your environment, add an alias like the following to ~/.bash_profile:
  
  Code:

  alias cm9env="hdiutil attach PATH-TO-DISK-IMAGE -mountpoint /Volumes/android && cd /Volumes/android/cm9 && source ./build/envsetup.sh && export USE_CCACHE=1"
  alias cm9build="cm9env && make clobber && reposync && brunch maguro"

  Now you can save time by using "cm9env" to get your environment setup or "cm9build" to compile a clean updated build.
• To clear your output directory for a new build, run "make clobber". You probably don't need this if you've only changed a few lines of code.
• To cherry pick yet-to-be-merged changes from the gerrit instance:
  

  1. Pick an open commit from CM Gerrit
  2. Under list of Patch Sets pick the latest and open cherry-pick tab
  3. Check what Git repository the url is pointing e.g. http://review.cyanog...frameworks_base
  4. In your CM9 working tree go to the corresponding directory, which in this case is something like ~/your-working-directory/frameworks/base/
  5. Now simply paste the whole line seen in CM Gerrit cherry-pick tab e.g. "git fetch http://review.cyanog....rameworks_base refs/changes/00/13100/4 && git cherry-pick FETCH_HEAD"
  It should be now included in your next compiled build. When doing repo sync again, cherry picks will be lost.[CREDIT Fihlvein from xda]

  Click to expand...

  Click to collapse

  
  Enjoy your custom built CM9!

conantroutman said:

Nice work man. Very helpful.

Click to expand...

Click to collapse

grad061980 said:

Nice write up. Thanks.

Before I start again from scratch I have a question. Does this guide apply to previous versions of mac os x (mine is 10.6.8)? I used the official android initializing build environment page & cm7 wiki page for the instructions to setup my build environment.

Also, any tips to switch from macports to homebrew?

In the past I've had to cherry pick to get my OS X build environment set up for CM9. The compile from source fails because I started with macports instead of homebrew (bad idea). I tried to switch to homebrew without success. Any tips to switch from macports to homebrew?

For the sake of keeping this page on topic a pm response is ok if that is what you prefer.

Click to expand...

Click to collapse

WonkyYew said:

Hi thanks for this !! Helpful one question what do i change so i can do AOSP instead of cm9??

Click to expand...

Click to collapse

repo init -u https://android.googlesource.com/platform/manifest

make -j$(sysctl -n hw.ncpu)

topprospect said:

ArmanUV,

Thanks so much for posting this guide. Very helpful!

Are you having any trouble with errors like this?

Code:

external/zlib/x86/adler32.c: In function ‘adler32_MMX’:
external/zlib/x86/adler32.c:747: error: can't find a register in class ‘GENERAL_REGS’ while reloading ‘asm’
external/zlib/x86/adler32.c:747: error: ‘asm’ operand has impossible constraints

Googling for this error implies that the fix is to use a version of GCC > 4.2. But there does not seem to be a GCC 4.4 in Homebrew.

Thanks again for the guide!

EDIT: Sorry for the double post with empyyy. Seems like there is someone else having my same issue!

Click to expand...

Click to collapse

empyyy said:

Hi, thanks for your guide, setting up the repo was no problem at all!
But: I'm getting the following error when building.

Code:

external/zlib/x86/adler32.c: In function ‘adler32_MMX’:
external/zlib/x86/adler32.c:747: error: can't find a register in class ‘GENERAL_REGS’ while reloading ‘asm’
external/zlib/x86/adler32.c:747: error: ‘asm’ operand has impossible constraints
make: *** [out/host/darwin-x86/obj/STATIC_LIBRARIES/libz_intermediates/adler32.o] Error 1
make: *** Waiting for unfinished jobs....

Seems to be a problem with the compiler, but I'm on xcode 4.3 and I've installed gcc-4.2 and set the env vars. Any help?

Click to expand...

Click to collapse

topprospect said:

I am on Lion 10.7.4 with Xcode 4.3.2. Here is the output that you asked for:

Do I need to add something to PATH? I'm sure I just missed something obvious in your instructions.. Thanks for helping!

Click to expand...

Click to collapse

ln -s /usr/local/bin/gcc-4.2 /usr/local/bin/gcc
ln -s /usr/local/bin/gcc-4.2 /usr/local/bin/cc
ln -s /usr/local/bin/g++-4.2 /usr/local/bin/c++
ln -s /usr/local/bin/g++-4.2 /usr/local/bin/g++

topprospect said:

Okay, just tried this. I created a new dir (/Volumes/Android/bin) that simply houses those softlinks you recommended. Then I put /Volumes/Android/bin at the beginning of my PATH. That should fix it without breaking the rest of the system, e.g. homebrew.

The GENERAL_REGS problem still exists though. Pretty sure b/c gcc 4.2.1 doesn't understand this construct properly (need a newer version of gcc).

So I backed out the change that introduced this adler32.c.

https://github.com/CyanogenMod/android_external_zlib/commit/13bf40af68236c961542bdee1d4b7c0176bf15a0

The compile is getting farther now. I have to run to work so I'll post later if it succeeds.

The weird thing is: This change was made back in December. Why would it have worked for you?

Click to expand...

Click to collapse

topprospect said:

Build works (and boots!) with the following:

Code:

cd external/zlib
git revert dd6786cae3f4493faa6661d5f74db587932f15d7
git revert 13bf40af68236c961542bdee1d4b7c0176bf15a0

Note the 1st revert is just to avoid massive conflicts seen when reverting the 2nd one by itself. The 2nd revert is the one that really matters here.

So this isn't really a solution.. Seems like we need to move to a newer version of gcc or figure out a patch to adler32.c that makes it gcc 4.2 compatible.

Click to expand...

Click to collapse

brew install https://raw.github.com/Homebrew/homebrew-dupes/master/gcc.rb