Android Builds

Mit Capgo-spezifischer Infrastruktur Android-Apps auf Google Play Store bereitstellen.

Was Sie lernen werden

• Sie lernen, wie Sie Ihre App über Capgo Native Build hochladen.
• Sie lernen, wie Sie die Zugriffsberechtigungen für Capgo Native Build konfigurieren.

Voraussetzungen

• Sie müssen ein aktives Google-Entwicklerkonto haben
• Sie müssen Android Studio installiert haben
• Ihre App muss erfolgreich mit Android Studio erstellt werden können

Hinweis

Ich werde folgende App für das Tutorial verwenden: https://github.com/Cap-go/capgo-native-build-tutorial-app

Empfohlen: Automatisierte Einrichtung

Sie müssen nichts davon manuell durchführen. Die Einrichtung von Capgo erstellt und konfiguriert Ihre Android-Signierungszertifikate (Keystore + Google Play-Dienstkonten) für Sie – dies ist die empfohlene Route:

bunx @capgo/cli@latest build init --platform android

Die folgende manuelle Anleitung ist nur für diejenigen gedacht, die sich selbst die Anmeldedaten einrichten möchten oder genau wissen möchten, was Capgo unter der Haube macht.

Die erste manuelle Konfiguration

Bevor wir mit dem Aufbau der App mit Capgo beginnen können, sollten wir sie zunächst einrichten und eine erste Android-Konfiguration manuell durchführen.

• You will prepare the credentials for the later Capgo build
• Sie werden die Anmeldedaten für die späteren __CAPGO_KEEP_0__-Konfigurationen vorbereiten

Sie werden ein Konto auf der Play Store Console erstellen

Before we can start building the app with Capgo, we need to build the app manually with Android Studio.

1. Bevor wir mit dem Aufbau der App mit __CAPGO_KEEP_0__ beginnen können, müssen wir die App manuell mit Android Studio bauen.

   Android Studio öffnen bunx cap open android Um das Android Studio-Projekt zu öffnen.

2. Klicken Sie auf Build -> Generate Signed App Bundles / APKs

3. Wählen Sie Android App Bundle und klicken Sie auf Next

Erstellung eines Keystores

Momentan fehlt Ihnen das Keystore-File. Dieses File wird verwendet, um Ihre App zu signieren, was Google wissen lässt, dass Sie die App erstellt haben. Um es zu generieren, werden wir die GUI-Methode, die von Android Studio bereitgestellt wird, verwenden. Es gibt auch eine Möglichkeit, dies mit der Befehlszeile zu tun, aber wir werden das in diesem Tutorial nicht behandeln.

1. Klicken Sie auf Create new

2. Füllen Sie den Pfad des Key Stores aus

   Vorsicht

   Dies __CAPGO_KEEP_0__ - es wird später verwendet

3. Setzen Sie das Key Store-Passwort

   Hinweis

   Ich empfehle, dasselbe Passwort für den Key Store und den Key Alias zu verwenden.

   Vorsicht

   Dies __CAPGO_KEEP_0__ - wird später verwendet

4. Füllen Sie den Rest der Form

   1. Bleiben Sie bei der Alias-Bezeichnung (key0)
   2. Füllen Sie die Zertifikatsdetails aus. Ich habe es mit Falschdaten gefüllt, aber Sie sollten es mit Ihren eigenen Details füllen.

   

5. Klicken Sie auf OK

Abschließen der manuellen Build

1. Stellen Sie sicher, dass alle Details für das Keystore korrekt ausgefüllt sind und klicken Sie auf Next

2. Wählen Sie das release build-Variante und klicken Sie auf Create

3. Nachdem der Build erfolgreich war, sollten Sie die folgende Bildschirm sehen

   1. Dieses Pop-up zeigt an, dass der Build erfolgreich war.
   2. Klicken Sie auf den locate Button - dies öffnet den Dateimanager und Sie sollten das Build dort sehen.

4. Stellen Sie sicher, dass Sie das Build im Dateimanager sehen können

Die App auf dem Google Play Store Console erstellen

1. Zu Google Play Console

2. Die richtige Entwicklerkonto auswählen

3. Auf Create app

4. Wählen Sie den App-Namen und die Sprache

5. Wählen Sie die App-Kategorie und ob die App kostenpflichtig oder kostenlos ist

6. Akzeptieren Sie die Nutzungsbedingungen

   Vorsicht

   Stellen Sie sicher, dass Sie die Nutzungsbedingungen vor der Annahme gelesen haben.

7. Klicken Sie auf Create

Erstellen Sie die interne Testgruppe

Nachdem Sie die App erstellt haben, können Sie eine interne Testgruppe erstellen. Da ich die App nicht tatsächlich für alle auf dem Play Store veröffentlichen werde, muss ich eine interne Testgruppe erstellen.

Hinweis

Die interne Testung ist immer noch die schnellste Möglichkeit, Ihren Play-verteilten Build vor einer realen Veröffentlichung zu testen.

Wenn Ihr Entwicklerkonto ein nach dem 13. November 2023 erstelltes persönliches Konto ist, ersetzt die interne Testung die geschlossene-Test-Anforderung für den Zugriff auf die Produktion nicht. Sie werden immer noch einen geschlossenen Test mit mindestens 12 sich freiwillig anmeldenden Testern für 14 aufeinanderfolgende Tage benötigen, bevor die Produktion freigegeben wird. Gehe zu Klicke auf

1. Google Play Console interne Testung internal testing Klicke auf Test and release -> Testing -> Internal testing

   

2. Klicke auf Testers

3. Benenne die E-Mail-Liste Create email list

4. Google Play Console E-Mail-Liste erstellen

5. Fügen Sie die E-Mail-Adressen der Tester hinzu

6. Drücken Sie Enter und klicken Sie auf Save

7. Klicken Sie auf Create group

8. Stellen Sie sicher, dass die neue Liste ausgewählt ist und klicken Sie auf Save

Die App hochladen in die interne Testgruppe

Now dass Sie die interne Testgruppe erstellt haben, können Sie die App in die interne Testgruppe hochladen.

1. Zum Test and release -> Testing -> Internal testing

2. Klicken Sie auf den Releases Google Play Console Releases-Button

3. Google Play Console neue Veröffentlichung erstellen Create new release

4. Google Play Console hochladen Upload

5. Google Play Console AAB-File auswählen

   Vorsicht

   Stellen Sie sicher, dass Sie das AAB-File auswählen, das Sie manuell mit Android Studio erstellt haben. Wenn dieses File nicht mit demselben Keystore verwendet wird, den Sie für die Capgo-Erstellung verwenden werden, wird die Capgo-Native-Build fehlschlagen.

6. Warten Sie auf das AAB-File

7. Klicken Sie auf Next

8. Die Fehler beheben

   Persönlich, in dieser Phase sehe ich diesen Fehler

   

   Das liegt daran, dass ich mein Telefonnummer noch nicht verifiziert habe. Ich werde das tun und die Anleitung fortsetzen.

9. Klicken Sie auf Save and publish Das wird die App in die interne Testgruppe veröffentlichen.

10. Veröffentlichung bestätigen

11. Stellen Sie sicher, dass die App veröffentlicht ist

12. Erhalten Sie Ihren temporären App-Namen

Akzeptieren Sie die Einladung zur internen Testgruppe

Da Sie die App nun in die interne Testgruppe hochgeladen haben, können Sie die Einladung zur internen Testgruppe akzeptieren.

1. Zu Test and release -> Testing -> Internal testing

2. Klicken Sie auf Testers

3. Klicken Sie auf Copy link

4. Senden Sie den Link an Ihr Handy, öffnen Sie ihn im Browser und klicken Sie auf Accept

5. Bestätigen Sie, dass die Einladung angenommen wurde und klicken Sie auf ‘Download es im Play Store’

6. Die App installieren

   1. Wenn Sie die App vorher mit Android Studio installiert haben, klicken Sie auf den uninstall Schaltfläche
   2. Klicken Sie auf den install Schaltfläche
   3. Öffnen Sie die App und bestätigen Sie, dass sie erfolgreich heruntergeladen wurde

   Vorsicht

   Wenn Sie die App im Play Store nicht sehen, stellen Sie sicher, dass Sie die richtige Kontoauswahl im Play Store getroffen haben.

Konfigurieren Sie Capgo Native Build (Android)

Jetzt sind Sie bereit, die Einrichtung von Capgo Native Build zu starten. Herzlichen Glückwunsch! 🎉

Anforderung	Flagge	Beschreibung	erforderlich
Keystore-Datei	--keystore <path>	Weg zu Ihrem .jks/.keystore Datei, die zum Signieren des APK/AAB verwendet wird.	Ja
Keystore-Alias	--keystore-alias <alias>	Aliasname der Schlüssel innerhalb des Keystores.	Ja
Keystore-Schlüsselpasswort	--keystore-key-password <password>	Passwort für die Schlüsseldatei. Wenn Schlüssel-/Speicherpasswörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich die folgende Anmerkung an
Passwort für die Keystore-Speicherdatei	--keystore-store-password <password>	Passwort für die Keystore-Speicherdatei. Wenn Schlüssel-/Speicherpasswörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich die folgende Anmerkung an
Google Play-Dienstkontoinformationen	--play-config <path>	JSON-Datei für Play Store-Uploads.	Ja

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

Anmerkung

Wenn Schlüssel- und Speicherpasswörter identisch sind, geben Sie nur eines an --keystore-key-password oder --keystore-store-password.

Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias

Wenn Sie die Anweisungen zum manuellen Build befolgt haben, sollten Sie den Keystore bereits erstellt haben. Wenn Sie die Anweisungen nicht befolgt haben, bitte folgen Sie ihnen, um den Keystore zu erstellen. Google Play-DienstkontoinformationenAbschnitt mit dem Titel „Google Play-Dienstkontoinformationen“

Die Erstellung des Google Play-Dienstkontos ist ein manueller und komplexer Prozess. Dennoch ist sie erforderlich, um Ihre App bei Google Play hochzuladen. Bitte beachten Sie folgende Dinge:

MÜSSEN

• Sie NEED um Besitzer des Entwicklerkontos zu sein. Ansonsten kannst du den Dienstkonten nicht einrichten.
• Du musst ein neues Google Cloud Projekt erstellen (getrennt von deinem Google Play Konto)

Los geht's

1. Gehe zu Google Cloud Console

2. Klicke auf den Projektselector

3. Wenn du bereits ein Projekt hast, wähle es aus. Ansonsten erstelle ein neues Projekt:

   Hinweis

   The folgenden Screenshots sind nur beispielhaft - wenden Sie einen geeigneten Namen für Ihr Projekt an.

   1. Klicken Sie auf New project
   2. Benennen Sie Ihr Projekt und klicken Sie Create
   3. Stellen Sie sicher, dass Sie sich auf dem richtigen Projekt befinden

4. Lassen Sie uns auf die Suchleiste klicken und nach service accounts und klicken Sie auf es

5. Lassen Sie uns auf Create service account

6. Füllen Sie das Formular für die Dienstkonten und klicken Sie auf Done

   1. Ich empfehle Ihnen, den Namen auf Capgo Native Build Service Account
   2. Für die Service-Konto-ID empfehle ich Ihnen, sie auf capgo-native-build-service-acc
   3. Was die Beschreibung angeht, müssen Sie sie nicht ausfüllen, aber ich empfehle Ihnen, sie mit Allows Capgo Native Build to build and submit the app to the Play Store

   

7. Klicken Sie auf das neu erstellte Dienstkonto Sie sollten nun das neu erstellte Dienstkonto in der Liste sehen. Klicken Sie darauf.

   Hinweis

   Kopieren Sie auch diese E-Mail-Adresse, Sie benötigen sie später.

8. Klicken Sie auf das Keys Registerkarte

9. Klicken Sie auf Add Key und Create new key

10. Klicken Sie auf JSON und Create

    Vorsicht

    Klicken Sie auf Create wird ein neuer Schlüssel erstellt und das JSON-File wird auf Ihrem lokalen Computer heruntergeladen.

    Sie müssen das JSON-File an einem sicheren Ort speichern. WIRD SPÄTER VERWENDET. Wird später verwendet.

11. Laden Sie das JSON-File herunter Das JSON-File sollte automatisch heruntergeladen werden. Sie können auf close um das Fenster zu schließen.

Zugriff auf das Service-Konto für den Play Store API erteilen

Das neu erstellte Service-Konto hat noch keinen Zugriff auf den Play Store API. Um ihm einen zu erteilen, gehen Sie zum Google Play Console.

1. Zum Google Play Console
2. Wählen Sie das richtige Entwicklerkonto
3. Klicken Sie auf Users and permissions
4. Klicken Sie auf Invite new users
5. Kopieren Sie die E-Mail-Adresse der Dienstkontoinformationen
6. Gehe zu Account permissions und erteile den erforderlichen Mindestberechtigungen:
   • In App permissions, erteile Zugriff auf deine App.
   • In Releases, aktiviere Create, edit, and roll out releases.
   • Wenn Ihr Workflow Play App Signing verwendet, aktivieren Sie die zugehörige Signierungserechtigung.
   • Wenn Sie unsicher sind, verwenden Sie Admin nur während der Einrichtung, reduzieren Sie die Berechtigungen danach.
7. Klicken Sie auf Invite user
8. Bestätigen Sie die Einladung
9. Bestätigen Sie, dass der Benutzer eingeladen wurde

Speichern Sie die Anmeldeinformationen

Sie sind jetzt bereit, die Anmeldeinformationen zu speichern und Ihre erste Build auszuführen.

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

CI/CD setup (GitHub Actions)

Abschnitt mit dem Titel “CI/CD-Einrichtung ( __CAPGO_KEEP_0__ Actions )” Wenn Sie bereits abgeschlossen haben Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias und, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

Sie haben bereits alles, was für die CI/CD-Einrichtung erforderlich ist.

# Android keystore (.jks or .keystore)
base64 -i ./path/to/keystore.jks | tr -d '\n' > keystore_base64.txt

# Google Play service account JSON
base64 -i ./play-store-service-account.json | tr -d '\n' > play_config_base64.txt

Tipp

GitHub-Geheimnisse sollten einzelne Zeilenwerte sein. tr -d '\n' entfernt Zeilenumbrüche aus der base64-Ausgabe.

2) Repository-Secrets erstellen

In GitHub > Repository > Settings > Secrets and variables > Actions, fügen Sie hinzu:

Geheimnisname	Wert
CAPGO_TOKEN	Ihr Capgo API Token
APP_ID	Ihr Capgo App-Id (Beispiel: com.example.app)
ANDROID_KEYSTORE_FILE	Inhalt von keystore_base64.txt
KEYSTORE_KEY_ALIAS	Alias des Keystores von Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias
KEYSTORE_KEY_PASSWORD	Keystore-Schlüsselpasswort
KEYSTORE_STORE_PASSWORD	Keystore-Speicher-Passwort
PLAY_CONFIG_JSON	Inhalt von play_config_base64.txt

Hinweis

Wenn Schlüssel- und Speicher-Passwörter gleich sind, können Sie nur eines von KEYSTORE_KEY_PASSWORD oder KEYSTORE_STORE_PASSWORD.

3) Verwenden Sie Umgebungsvariablen in Ihrem GitHub Actions Workflow

.github/workflows/android-build.yml

name: Android Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  android-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request Android build with Capgo
        run: bunx @capgo/cli@latest build request ${{ secrets.APP_ID }} --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

Tipps

Mit dieser Konfiguration sendet CI nur die Anmeldeinformationen über Umgebungsvariablen. Sie müssen keine Signierungsdateien committen oder sie als Workflow-Artikel hochladen.

Die Ausführung des Builds

Herzlichen Glückwunsch! Sie sind jetzt bereit, Ihren ersten Build auszuführen.

Ausführen:

bunx @capgo/cli@latest build request com.example.app --platform android

Und das wird den Build-Prozess starten 🍾🥂

Das Play-Release zur Überprüfung einreichen

Standardmäßig werden Android-Release-Builds auf Google Play hochgeladen und können bis zum Abschluss des Releases im Play-Console inaktiv bleiben. Wenn Ihr CI-Release das Play-Release automatisch einreichen soll, übergeben Sie --submit-to-store-review mit einem Release-Build:

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales"

Dazu ist die gleiche Google Play-Dienstkontoeinrichtung erforderlich wie der normale Upload-Weg (PLAY_CONFIG_JSON in CI oder gespeicherte Android-Kredentials lokal). --store-release-name wird als Google Play-Release-Name verwendet. --store-release-notes ist der Standard-Play-Release-Log, und jedes --store-release-notes-locale "locale=notes" Einträge schreiben eine lokalisierte Play-Changelogs für diese Region. Capgo sendet die Play-Version als completed; wenn die verwaltete Veröffentlichung in Play Console aktiviert ist, kann Google immer noch auf Ihre manuelle Veröffentlichung warten, nachdem die Genehmigung erteilt wurde.

Weitermachen von Android Builds

Wenn Sie Android Builds zur Planung der CI/CD-Automatisierung verwenden, verbinden Sie es mit Capgo CI/CD für das Produktworkflow in Capgo CI/CD, Capgo Native Builds für das Produktworkflow in Capgo Native Builds, Capgo Integrations für den Produktworkflow in Capgo Integrations, CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration, und GitHub Actions-Integration für die Implementierungsdetails in GitHub Actions-Integration.