Bearbeiten von „CustomROM kompilieren“

Einer der wichtigsten Pluspunkte von Android ist die Quelloffenheit. Durch die Lizenzierung unter der Apache Lizenz 2.0<ref>{{Internetquelle|titel = Licenses {{!}} Android Open Source Project|url = http://source.android.com/source/licenses.html|zugriff = 2015-12-01|werk = source.android.com}}</ref> und der öffentlichen Verfügbarkeit des Quellcodes, ist es grundsätzlich jedem erlaubt, sein eigenes Android-System zu erstellen, zu verändern und zu veröffentlichen. Daraus sind einige bekannte CustomROMs entstanden, bspw. den CyanogenMod. Das '''Kompilieren einer ROM''' ist grundsätzlich kein Hexenwerk, erfordert allerdings Zeit und Interesse, die investiert werden sollte, um auch die Hintergründe und Funktionsweisen zu verstehen. Diese Seite dient lediglich als kurze Schritt-für-Schritt-Hilfe.<ref>{{Internetquelle|titel = Custom ROM kompilieren|url = http://www.handy-faq.de/forum/custom-rom-kompilieren-t318233/|zugriff = 2015-12-01|sprache = de-DE|werk = Handy-FAQ.de}}</ref>

== System-Anforderungen ==

* PC oder Laptop mit mindestens 4GB RAM
* Mindestens 100GB Speicherplatz
* 64-Bit Linux oder Mac OS

== Vorbereitungen ==

Zum Kompilieren werden einige Tools benötigt, die in einem [[Linux]]-Derivat (bspw. Ubuntu) in der Regel in den vorinstallierten Paketquellen zu finden sind. Diese können bspw. mit diesem Befehl installiert werden, welcher in der Kommandozeile ausgeführt werden muss. Der aktuell angemeldete Nutzer muss selbstredend ein Nutzer sein, der berechtigt ist, Befehle als Root-User mit <code>[[Wikipedia:de:Sudo|sudo]]</code> sein.<syntaxhighlight lang="bash">
sudo apt-get install git-core gnupg ccache lzop flex bison gperf build-essential zip curl zlib1g-dev zlib1g-dev:i386 libc6-dev lib32ncurses5 lib32z1 lib32bz2-1.0 lib32ncurses5-dev x11proto-core-dev libx11-dev:i386 libreadline6-dev:i386 lib32z-dev libgl1-mesa-glx:i386 libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc readline-common libreadline6-dev libreadline6 lib32readline-gplv2-dev libncurses5-dev lib32readline5 lib32readline6 libreadline-dev libreadline6-dev:i386 libreadline6:i386 bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev lib32bz2-dev libsdl1.2-dev libesd0-dev squashfs-tools pngcrush schedtool libwxgtk2.8-dev python git
</syntaxhighlight>Für die Quellcode-Verwaltung von [[Android]] wird eine eigens entwickelte Anwendung, mit dem Namen ''[[repo]]'', entwickelt, die die Verwaltung der verschiedenen Git-Repositories erleichtert. Die Anwendung basiert auf ''git'', dessen Client bereits mit dem obigen Befehl installiert wurde.<ref>{{Internetquelle|titel = <nowiki>git-repo -
 
 
 repo - The multiple repository tool - Google Project Hosting</nowiki>|url = https://code.google.com/p/git-repo/|zugriff = 2015-12-01|werk = code.google.com}}</ref> Es wird empfohlen, repo im Heimverzeichnis des Benutzers zu installieren. Hierfür muss sichergestellt sein, dass ein '''bin'''-Verzeichnis vorhanden und in der [https://wiki.ubuntuusers.de/Umgebungsvariable#PATH-erweitern PATH]-Umgebungsvariable hinterlegt ist, in welches repo anschließend installiert wird. Die folgenden Befehle müssen einfach Zeile für Zeile in der Kommandozeile ausgeführt werden, Zeilen, welche mit ''//'' starten, sind Kommentare:<syntaxhighlight lang="bash">
// bin-Verzeichnis im Heimverzeichnis erstellen
$ mkdir ~/bin
// und zur PATH-Umgebungsvariable hinzufügen
$ PATH=~/bin:$PATH
// repo in das gerade erstellte bin-Verzeichnis herunterladen
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
// Rechte für repo setzen: a -> alle Gruppen/Nutzer; x -> ausführbar
$ chmod a+x ~/bin/repo
</syntaxhighlight>Anschließend steht der Befehl ''repo'' für den angemeldeten Nutzer global zur Verfügung.

== Quellcode herunterladen ==
Der Quellcode der zu kompilierenden [[CustomROM]] muss nun lokal heruntergeladen und gespeichert werden. Idealerweise wird hierfür ein entsprechender Ordner mit dem Namen des CustomROM im Heimverzeichnis des Nutzers erstellt und in diesen wechselt. Für [[CyanogenMod]] bspw.:<syntaxhighlight lang="bash">
$ mkdir ~/CyanogenMod && cd ~/CyanogenMod
</syntaxhighlight>Der Quellcode selbst wird mit Hilfe vom eben installierten Tool ''repo'' heruntergeladen und vorbereitet. Hierfür genügt es, den entsprechend richtigen Befehl der folgenden Tabelle (jeweils für Android {{Android|5.1}}im Terminal (im entsprechenden Ordner im Heimverzeichnis) auszuführen, um das Repository zu initialisieren:
{| class="wikitable"
!CustomROM
!Befehl für das Terminal
|-
|CyanogenMod
|<nowiki>repo init -u git://github.com/CyanogenMod/android.git -b cm-12.1</nowiki>
|-
|BlissPop
|<nowiki>repo init -u https://github.com/TeamBliss-LP/android.git -b lp5.1</nowiki>
|-
|Resurrection
|<nowiki>repo init -u https://github.com/ResurrectionRemix/platform_manifest.git -b lollipop5.1</nowiki>
|}

Um den Quellcode nun herunter zu laden, muss das Repository mit synchronisiert werden. In der Kommandozeile geschieht das durch den Befehl<syntaxhighlight lang="bash">
$ repo sync -j18
</syntaxhighlight>Das Herunterladen kann je nach CustomROM und verfügbarer Internetverbindung einige Zeit in Anspruch nehmen.

Nahezu jedes Gerät erfordert, neben den Quellcode-Repositories, die in der sog. ''default manifest'' genannt sind, noch weitere, gerätespezifische Daten aus anderen Repositories um auf diesem speziellen Gerät problemlos zu funktionieren. Diese Abhängigkeiten können in einer sogenannten '''local manifest''' Datei hinterlegt werden, die beim Synchronisieren mit ''repo'' ebenfalls heruntergeladen werden. Die gerätespezifische ''[https://wiki.cyanogenmod.org/w/Doc:_Using_manifests local_manifest.xml]'' kann i.d.R. durch eine kurze Google-Suche gefunden werden. Diese muss anschließend in ein neu zu erstellendes Verzeichnis ''local_manifests'' im ''.repo'' Verzeichnis des Repositories kopiert werden. Ist die ''local_manifest.xml'' für das entsprechende Gerät im Heimverzeichnis gespeichert, kann dieses bspw. mit diesen Befehlen an die korrekte Stelle kopiert werden (der erste Befehl ist ein Beispiel-Befehl für das Herunterladen einer Manifest-Datei und kann, sofern die local_manifest bereits existiert, ignoriert werden):<syntaxhighlight lang="bash">
$ wget -O ~/local_manifest.xml https://raw.github.com/bruce2728/local_manifest/kitkat-mr0/bruce2728_manifest.xml
$ cd .repo && mkdir local_manifests && cd local_manifests && cp ~/local_manifest.xml ./
</syntaxhighlight>Durch das erneute Synchronisieren der Repositories werden auch die in der ''local_manifest.xml'' genannten Abhängigkeiten heruntergeladen:<syntaxhighlight lang="bash">
$ repo sync
</syntaxhighlight>

== Kompilieren der ROM ==
Das Kompilieren der ROM kann durch folgende Befehle vorbereitet und gestartet werden. Auch hier gilt: Die Zeit, die dies in Anspruch nimmt, hängt grundsätzlich von der Größe der ROM, sowie der zur Verfügung stehenden Rechenleistung ab.<syntaxhighlight lang="bash">
// Build vorbereiten
$ . build/envsetup.sh
// {GEARÄTENAME} ist der Name des Gerätes, ohne {}
$ breakfast {GERÄTENAME}
// Build starten
$ brunch {GERÄTENAME}
</syntaxhighlight>

Um weitere "Custom-ROMS" aus der Source Fehlerfrei zu Kompilieren ist es wichtig, diese Befehle im Terminal durchzuführen.
<syntaxhighlight lang="bash">
// "Output" Ordner löschen
$ make clobber
// Quell-Code auffrischen, durch Änderungen.
$ Repo sync -j4
// Build vorbereiten
$ . build/envsetup.sh
// Build starten - {GEARÄTENAME} ist der Name des Gerätes, ohne {}
$ brunch {GERÄTENAME} 
</syntaxhighlight>

== Einzelnachweise ==
<references />