Android Builds

Mit Capgo’s dedizierter Infrastruktur Apps für Google Play Store erstellen und hochladen.

Was Sie lernen werden

• Sie lernen, wie Sie Ihre App über Capgo Native build hochladen können
• Sie lernen, wie Sie die Zugangsdaten für Capgo Native Build konfigurieren können

Voraussetzungen

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

Hinweis

Ich werde das 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-Zertifikatsdaten (Keystore + Google Play-Dienstkonto) für Sie – dies ist die empfohlene Vorgehensweise:

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

Der folgende manuelle Leitfaden ist nur für diejenigen gedacht, die die Zertifikatsdaten selbst einrichten möchten oder genau wissen möchten, was Capgo unter der Haube macht.

Der erste manuelle Build

Bevor wir mit dem Aufbau der App mit Capgo beginnen können, sollten wir sie zunächst einrichten und einen ersten Android-Build manuell durchführen. Es gibt einige Vorteile daran, einen manuellen Build vorher durchzuführen:

• Sie werden die Zertifikatsdaten für den späteren Capgo-Build vorbereiten
• Sie erstellen ein Verzeichnis im Google Play Store Console

Die Anwendung manuell mit Android Studio erstellen

Bevor wir mit Capgo beginnen können, müssen wir die Anwendung manuell mit Android Studio erstellen.

1. Android Studio öffnen

   Ausführen 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

Ein Keystore erstellen

Sie haben derzeit den Keystore-Datei fehlend. Diese Datei wird verwendet, um Ihre App zu signieren, was Google wissen lässt, dass Sie die App erstellt haben. Um sie zu generieren, verwenden wir die GUI-Methode, die von Android Studio bereitgestellt wird. Es gibt auch eine Möglichkeit, dies mit der Befehlszeile zu tun, aber wir werden dies in diesem Tutorial nicht behandeln.

1. Klicken Sie auf Create new

2. Speicherort des Schlüssel Speichers ausfüllen

   Vorsicht

   Dies IST ZU SPEICHERN - es wird später verwendet

3. Setze das Key Store-Passwort

   Hinweis

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

   Vorsicht

   Dies SPEICHERN - es wird später verwendet Fülle den Rest des Formulars aus

4. Halte das Key Alias unverändert (key0)

   1. __CAPGO_KEEP_0__
   2. Füllen Sie die Zertifikatsdetails. Ich habe es mit Falschinformationen 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 Popup zeigt an, dass die Build erfolgreich war.
   2. Klicken Sie auf den locate Knopf - dies öffnet den Dateimanager und Sie sollten das Build dort sehen.

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

Erstellen Sie die App im Google Play Store Console

1. Gehe zu Google Play Console

2. Wählen Sie das richtige Entwicklerkonto

3. Klicken Sie 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

Erstellung der internen Testgruppe

Da du nun die App erstellt hast, kannst du eine interne Testgruppe erstellen. Da ich die App nicht wirklich 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, deine Play-verteilte Build vor einer realen Veröffentlichung zu testen.

Wenn Ihr Entwicklerkonto ein persönliches Konto ist, das nach dem 13. November 2023 erstellt wurde, ersetzt die interne Testung nicht die geschlossene-Testanforderung für Produktionszugriff. Sie werden immer noch einen geschlossenen Test mit mindestens 12 sich freiwillig anmeldenden Testern für 14 aufeinanderfolgende Tage benötigen, bevor Sie in die Produktion gehen. Zum Klicken Sie auf

1. __CAPGO_KEEP_0__ internal testing __CAPGO_KEEP_0__ Test and release -> Testing -> Internal testing

   

2. Klicken Sie auf Testers

3. Klicken Sie auf Create email list

4. Benennen Sie die E-Mail-Liste

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

Da Sie nun 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 Schaltfläche

3. Klicken Sie auf Create new release

4. Klicken Sie auf Upload

5. Wählen Sie das AAB-Datei

   Vorsicht

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

6. Warten Sie, bis die AAB-Datei hochgeladen ist

7. Klicken Sie auf Next

8. Beheben Sie die Fehler

   Persönlich sehe ich in dieser Phase diesen Fehler

   

   Dies 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 Dies wird die App in der internen Testgruppe veröffentlichen.

10. Bestätigen Sie die Veröffentlichung

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

12. Erhalten Sie Ihren temporären App-Namen

Die Einladung zur internen Testgruppe akzeptieren

Nachdem Sie die App in der internen 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 Ihren Telefon, öffnen Sie ihn im Browser und klicken Sie auf Accept

5. Bestätigen Sie, dass die Einladung angenommen wurde und klicken Sie auf “herunterladen es im Play Store”

6. Installieren Sie die App

   1. Wenn Sie die App vorher mit Android Studio installiert hatten, 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 das App nicht im Play Store sehen, stellen Sie sicher, dass Sie das richtige Konto im Play Store ausgewählt haben.

Konfiguration von Capgo Native Build (Android)

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

Anforderung	Flagge	Beschreibung	Erforderlich
Keystore-Datei	--keystore <path>	Pfad zu Ihrer .jks/.keystore Datei, die zum Signieren des APK/AAB verwendet wird.	Ja
Keystore-Alias	--keystore-alias <alias>	Aliasname der Schlüssel im Keystore.	Ja
Keystore-Schlüsselpasswort	--keystore-key-password <password>	Das Passwort für die Schlüssel. Wenn Schlüssel-/Speicher-Passwörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich den unten stehenden Hinweis an.
Keystore-Speicherpasswort	--keystore-store-password <password>	Das Passwort für den Keystore. Wenn Schlüssel-/Speicher-Passwörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich den unten stehenden Hinweis an.
Google Play-Dienstkontokonto	--play-config <path>	JSON-Dienstkontenfile 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

Hinweis

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

Sicherheitszertifikat, Sicherheitszertifikatspasswort, Sicherheitszertifikatschlüsselpasswort, Sicherheitszertifikatsalias

Wenn Sie die Anweisungen zum manuellen Build folgt haben Anleitung zum manuellen BuildSie sollten bereits einen Keystore erstellt haben. Wenn Sie die Anweisungen nicht befolgt haben, bitten wir Sie, sie zu befolgen, um den Keystore zu erstellen.

Google Play-Dienstkonten

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

• Sie context NEED um derBesitzer des Entwicklerkontos
• zu sein. Ansonsten werden Sie nicht in der Lage sein, das Dienstkonto einzurichten.

Sie müssen ein neues Google Cloud Projekt erstellen (getrennt von Ihrem Google Play-Konto)

1. Los geht's. Bitte fahren Sie fort. Google Cloud Console

2. Klicken Sie auf den Projektselector

3. Wenn Sie bereits ein Projekt haben, wählen Sie es aus. Ansonsten erstellen Sie ein neues Projekt:

   Hinweis

   Die folgenden Screenshots sind nur beispielhaft - verwenden Sie einen Namen, der Ihrem Projekt angemessen ist.

   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. Klicken wir auf die Suchleiste und suchen wir nach service accounts und klicken wir darauf

5. Klicken wir auf Create service account

6. Füllen Sie das Formular für das Dienstkonto aus und klicken Sie auf Done

   1. Ich empfehle, den Namen auf Capgo Native Build Service Account
   2. Für die Dienstkonto-ID empfehle ich, sie auf capgo-native-build-service-acc
   3. Was die Beschreibung angeht, müssen Sie sie nicht ausfüllen, aber ich empfehle, 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.

   Anmerkung

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

8. Klicken Sie auf die 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 einen neuen Schlüssel erstellen und das JSON-File herunterladen Sie auf Ihr lokales Gerät.

    Sie müssen das JSON-File an einem sicheren Ort speichern. Es WIRD wird später verwendet.

11. JSON-Datei herunterladen Die JSON-Datei sollte automatisch heruntergeladen worden sein. Sie können auf close klicken, um das Fenster zu schließen.

Zugriff auf die Dienstkontoinformationen im Google Play Store API erteilen

Das neu erstellte Dienstkonto hat noch keinen Zugriff auf das Google Play Store API. Um es zu gewähren, gehen Sie zur Google Play Console.

1. Gehe zu 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 des Dienstkontos
6. Gehe zu Account permissions und gewähre die erforderlichen Mindestrechte:
   • In App permissions, gewähre Zugriff auf deine App.
   • In Releases, aktiviere Create, edit, and roll out releases.
   • Wenn dein Workflow Play App Signing verwendet, aktiviere die zugehörige Signierungsrechte.
   • Wenn du unsicher bist, verwende Admin nur während der Einrichtung, reduziere die Rechte dann anschließend.
7. Klicke 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. Sie können die Anmeldeinformationen mit dem folgenden Befehl speichern:

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-Einrichtung (GitHub Actions)

Wenn Sie bereits abgeschlossen haben Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias und Google Play-Dienstkontoinformationen, Sie haben bereits alles, was Sie für CI/CD benötigen. Dieser Abschnitt behandelt nur, wie Sie diese Werte als GitHub Actions-Secrets und Umgebungsvariablen übergeben.

1) Konvertieren Sie die Zertifikatsdateien in eine einzelne Zeile Base64

# 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:

Geheimer Name	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 aus dem Keystore Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias
KEYSTORE_KEY_PASSWORD	Keystore-Schlüsselpasswort
KEYSTORE_STORE_PASSWORD	Keystore-Speicherpasswort
PLAY_CONFIG_JSON	Inhalt von play_config_base64.txt

Hinweis

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

3) Use env vars in your GitHub Actions workflow

Abschnitt mit dem Titel „3) Verwenden Sie Umgebungsvariablen in Ihrem github Actions-Auftrag“

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 }}

Tipp

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

Die Ausführung der Build

Herzlichen Glückwunsch! Sie sind jetzt bereit, Ihre erste Build auszuführen.

Ausführen:

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

Und das startet den Build-Prozess.

Die Play-Erweiterung zur Überprüfung einreichen

Standardmäßig laden Android-Releasebuilds auf Google Play hoch und bleiben dort inaktiv, bis Sie die Veröffentlichung im Play-Console abschließen. Wenn Ihre CI-Veröffentlichung die Play-Veröffentlichung automatisch einreichen soll, übergeben Sie --submit-to-store-review mit einer Releasebuild:

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --android-track production \
  --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"

Vorsicht

Bei Android-Geräten --submit-to-store-review standardmäßig auf Produktionsumgebung mitverfolgen release_status: completed wenn Sie keine Verfolgung festlegen. Dadurch kann die Veröffentlichung auf 100% der Benutzer zugänglich sein. Passen Sie --android-track internal oder — oder setzen Sie alpha / betain der CI — um die fertige Veröffentlichung auf einer nicht-Produktionsverfolgung zu belassen. Verwenden Sie PLAY_STORE_TRACK live_update_dynamic_label_production --android-release-status / PLAY_STORE_RELEASE_STATUS wenn Sie einen anderen Status benötigen als completed.

Dies erfordert die gleiche Google Play-Dienstkontoinstallation wie der normale Uploadpfad (PLAY_CONFIG_JSON in CI oder gespeicherte Android-Anmelddaten lokal). --store-release-name wird als Google Play version_name. --store-release-notes ist der Ausfallsicherheits-Play-Logbuch, und jeder --store-release-notes-locale "locale=notes" Eintrag schreibt ein lokalisiertes Play-Logbuch für diese Region. Capgo sendet das Play-Release als completed solange Sie nicht überschreiben --android-release-status; wenn Managed Publishing in Play Console aktiviert ist, kann Google immer noch auf Ihre manuelle Veröffentlichung nach Genehmigung warten.

Bleiben Sie bei Android Builds

Wenn Sie Android Builds um die CI/CD-Automatisierung zu planen, verbinden Sie es mit Capgo CI/CD zur Produktworkflow in Capgo CI/CD, Capgo Native Builds zur Produktworkflow in Capgo Native Builds, Capgo Integrations zur Produktworkflow in Capgo Integrations, CI/CD-Integration zur Implementierungsdetail in CI/CD-Integration, und GitHub Actions Integration zur Implementierungsdetail in GitHub Actions Integration.