Git Setup für Android: Identität und Repository sauber einrichten

Bevor du deine erste Zeile Kotlin schreibst, brauchst du ein Sicherheitsnetz für deinen Code. Genau das ist Git: ein Versionskontrollsystem, das jede Änderung an deinem Android-Projekt nachvollziehbar speichert. Wenn du Git von Anfang an sauber einrichtest, sparst du dir später viel Frust mit verlorenen Dateien, kaputten Branches oder unklaren Commit-Historien. In diesem Artikel gehst du durch die wichtigsten Schritte: Identität konfigurieren, ein Repository initialisieren oder klonen und die typischen Stolperfallen vermeiden, die Anfänger im Android-Umfeld erwischen.

Was ist das?

Git Setup bedeutet, dein lokales Git so zu konfigurieren, dass jeder Commit klar dir zugeordnet werden kann und dein Repository von Anfang an in einem sauberen Zustand startet. Du legst dabei zwei Dinge fest: deine Identität als Autor und den Ort, an dem dein Projekt versioniert wird. Ohne diese Grundlage funktioniert zwar git commit, aber deine Commits tauchen entweder anonym auf oder unter einem zufälligen Hostnamen, der nichts mit dir zu tun hat.

Im Android-Kontext ist Git nicht optional. Android Studio setzt Git voraus, wenn du Features wie Versionsvergleich, lokale Historie über Commits hinaus oder die Integration mit GitHub, GitLab oder Bitbucket nutzen willst. Auch der offizielle Kurs „Android Basics with Compose” geht davon aus, dass du deinen Code regelmäßig committest, um Lernfortschritt und Experimente sauber zu trennen. Für jedes ernsthafte Android-Projekt – egal ob du allein lernst oder im Team arbeitest – ist ein konfiguriertes Git der erste Schritt, noch vor dem ersten MainActivity.kt.

Stell dir Git als Tagebuch deines Projekts vor: Jeder Commit ist ein Eintrag mit Zeitstempel, Autor und einer Notiz, was du geändert hast. Dieses Tagebuch lebt zuerst nur auf deinem Rechner. Erst wenn du es mit einem Remote wie GitHub verbindest, wird daraus auch ein Backup und eine Plattform für Zusammenarbeit.

Wie funktioniert es?

Git arbeitet mit einer dreistufigen Logik: Working Directory, Staging Area und Repository. Im Working Directory bearbeitest du deine Dateien ganz normal. Mit git add markierst du Änderungen für den nächsten Commit, sie wandern damit in die Staging Area. Mit git commit schreibst du diese Änderungen dauerhaft in dein lokales Repository, also in den versteckten .git-Ordner deines Projekts.

Damit Git weiß, wer einen Commit erstellt hat, brauchst du eine Identität. Diese setzt du einmalig global mit zwei Befehlen:

git config --global user.name "Dein Name"
git config --global user.email "[email protected]"

Die Option --global speichert diese Werte in der Datei ~/.gitconfig und nutzt sie für alle Repositories auf deinem Rechner. Willst du in einem bestimmten Projekt eine andere Identität verwenden – etwa eine Firmen-Mail für Arbeit und eine private für Hobby-Projekte – setzt du die Werte ohne --global direkt im Projektordner. Git nimmt dann den lokalen Wert vor dem globalen.

Für ein neues Projekt gibt es zwei Wege, ein Repository zu starten. Entweder du beginnst auf der grünen Wiese und initialisierst Git in einem Ordner, oder du klonst ein bestehendes Projekt von einem Remote. Beide Wege sind für Android-Lernende relevant: Den ersten brauchst du für eigene Übungs-Apps, den zweiten, wenn du Beispielprojekte aus dem Compose-Kurs oder von Codelabs lokal nachvollziehen willst.

Beim Initialisieren erstellt Git den .git-Ordner und markiert das Verzeichnis als Repository, ohne deine Dateien zu verändern. Beim Klonen lädt Git das komplette Projekt inklusive Historie herunter und richtet automatisch den Remote namens origin ein, sodass du später mit git pull und git push arbeiten kannst.

Wichtig ist auch der Standard-Branch. Moderne Git-Versionen verwenden main statt master. Du kannst diesen Standard explizit setzen, damit jedes neue Repository sofort den richtigen Namen verwendet:

git config --global init.defaultBranch main

Authentifizierung gegenüber Remotes

Wenn du mit GitHub oder GitLab arbeitest, brauchst du eine Authentifizierungsmethode. HTTPS funktioniert mit einem Personal Access Token, SSH mit einem Schlüsselpaar. Für Android-Projekte, an denen du regelmäßig arbeitest, ist SSH komfortabler: Ein einmal hinterlegter Schlüssel erspart dir das ständige Eintippen von Tokens. Die E-Mail in deinem Git-Setup sollte dabei mit der E-Mail deines Remote-Kontos übereinstimmen, damit Commits korrekt deinem Profil zugeordnet werden.

In der Praxis

Stell dir vor, du startest dein erstes echtes Android-Projekt nach dem Compose-Kurs: eine kleine Notiz-App. So sieht ein sauberer Setup-Workflow aus, vom leeren Ordner bis zum ersten Commit:

# Identität einmalig global setzen
git config --global user.name "Lena Beispiel"
git config --global user.email "[email protected]"
git config --global init.defaultBranch main

# Ins Projektverzeichnis wechseln, das Android Studio angelegt hat
cd ~/AndroidStudioProjects/Notizen

# Repository initialisieren
git init

# .gitignore prüfen und ersten Commit erstellen
git status
git add .
git commit -m "Initialer Projekt-Setup mit Compose-Template"

Android Studio legt beim Anlegen eines neuen Projekts automatisch eine passende .gitignore an. Diese Datei sorgt dafür, dass Build-Artefakte wie der build/-Ordner, lokale IDE-Einstellungen aus .idea/ und der local.properties-Pfad zu deinem SDK nicht im Repository landen. Wirf vor dem ersten git add . einen Blick hinein. Falls du das Projekt manuell aufsetzt oder ein altes Projekt migrierst, hilft dir die offizielle Android-Vorlage von github.com/github/gitignore weiter.

Wenn du stattdessen ein bestehendes Projekt klonst – etwa eine Codelab-Vorlage – sieht der Workflow so aus:

cd ~/AndroidStudioProjects
git clone [email protected]:google-developer-training/basic-android-kotlin-compose-training-unscramble.git
cd basic-android-kotlin-compose-training-unscramble

Danach öffnest du den Ordner in Android Studio über „Open” und lässt Gradle synchronisieren. Dein lokaler Klon ist sofort ein vollwertiges Repository: Du kannst eigene Branches anlegen, Änderungen committen und – falls du Schreibrechte hast – zurück zum Remote pushen.

Eine konkrete Entscheidungsregel

Initialisiere Git bevor du anfängst, am Code zu arbeiten, nicht danach. Wenn du erst nach Stunden Coding ein Repository erstellst, hast du keine Historie deiner Lernschritte und keine Möglichkeit, einen kaputten Zwischenstand zurückzudrehen. Die Faustregel: Sobald Android Studio das Projekt erstellt hat, läuft als zweiter Schritt git init und der erste Commit. Erst dann öffnest du MainActivity.kt.

Typische Stolperfallen

Die häufigste Falle bei Anfängern: local.properties wird versehentlich committet. Diese Datei enthält den absoluten Pfad zu deinem Android SDK auf deinem Rechner. Auf einem anderen System ist dieser Pfad falsch, und das Projekt baut nicht mehr. Die Standard-.gitignore schließt die Datei aus, aber wenn du sie manuell mit git add local.properties hinzufügst, ignoriert Git die Regel. Prüfe nach dem ersten git status immer, welche Dateien wirklich gestaged sind.

Eine zweite Falle sind Secrets wie API-Keys für Firebase, Google Maps oder Backend-Dienste. Schreibe solche Werte niemals direkt in versionierte Dateien. Lege sie stattdessen in local.properties ab und lies sie über BuildConfig oder Gradle-Properties ein. So bleibt dein Schlüssel auf deinem Rechner und landet nicht im öffentlichen Repository.

Die dritte Falle: falsche Identität. Wenn du user.email nie gesetzt hast, verwendet Git eine generierte Adresse wie [email protected]. Auf GitHub erscheinen deine Commits dann nicht unter deinem Profil, und der grüne Contribution-Graph bleibt leer. Prüfe nach dem Setup mit git config --list, dass beide Werte korrekt gespeichert sind. Bei einem Test-Commit zeigt git log --pretty=full dir, mit welchem Namen und welcher Mail der Eintrag wirklich angelegt wurde.

Wenn du in mehreren Projekten arbeitest und versehentlich mit der falschen Identität committest, korrigierst du das nachträglich nur mit git commit --amend --reset-author für den letzten Commit oder mit einem Rebase für ältere. Beides ist nervig, also lieber einmal sauber konfigurieren.

Fazit

Git Setup klingt nach Beiwerk, ist aber das Fundament deiner Android-Arbeit. Mit drei Befehlen für die Identität, einem git init oder git clone und einem Blick auf die .gitignore legst du die Basis dafür, dass du jederzeit zu einem funktionierenden Stand zurückkehren kannst, dass deine Commits dir zugeordnet werden und dass keine Secrets nach außen gelangen. Mach jetzt den Praxis-Test: Lege ein neues Übungsprojekt in Android Studio an, prüfe mit git config --list deine Konfiguration, schau dir die generierte .gitignore an und erstelle einen ersten Commit mit einer aussagekräftigen Nachricht. Wenn git log dir danach deinen Namen und deine korrekte Mail zeigt, bist du startklar für alle weiteren Roadmap-Themen – von Branching-Strategien bis zu Pull Requests im Team.