Android-Builds

Mit Capgo’s dedizierter Infrastruktur Android-Anwendungen für den 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 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. Capgo's Einrichtung erstellt und konfiguriert Ihre Android-Signierungsanmeldeinformationen (Keystore + Google Play-Dienstkontoinformation) für Sie — dies ist der empfohlene Weg:

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

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

Die erste manuelle Erstellung

Bevor wir mit der Erstellung der App mit Capgo beginnen können, sollten wir sie zunächst einrichten und eine erste Android-Erstellung manuell durchführen. Es gibt einige Vorteile daran, eine manuelle Erstellung vorher durchzuführen:

• Sie werden die Anmeldeinformationen für die späteren Capgo-Erstellung vorbereiten
• Sie werden ein Eintrag auf dem Google Play Store Console erstellen

Die App manuell mit Android Studio erstellen

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

1. Öffnen Sie Android Studio

   Ausführen bunx cap open android Um die App mit Android Studio zu öffnen.

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

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

Erstellen Sie einen Keystore

Derzeit 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, 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 das in diesem Tutorial nicht behandeln.

1. Klicken Sie auf Create new

2. Eingabe des Pfads zum Key Store

   Vorsicht

   Dieses IST ZU SPEICHERN - es wird später verwendet

3. Keystore-Passwort festlegen

   Achtung

   Ich empfehle Ihnen, dass Sie für das Key Store und das Key Alias das gleiche Passwort verwenden.

   Achtung

   Dies ZU SPEICHERN Es wird später verwendet

4. Füllen Sie den Rest der Form

   1. Behalten Sie den Key Alias bei (key0) wie er ist
   2. Füllen Sie die Zertifikatsdetails aus. Ich habe es mit Falschdetails 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 die 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 Klicken Sie auf den 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

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

Erstellen Sie die internen Testgruppe

Erstelle nun eine interne Testgruppe, nachdem du die App erstellt hast. Da ich die App nicht für alle auf dem Play Store veröffentlichen werde, benötige ich eine interne Testgruppe.

Hinweis

Interne Tests sind immer noch die schnellste Möglichkeit, Ihre Play-verteilte Build zu testen, bevor es zu einem realen Launch kommt.

Wenn Ihr Entwicklerkonto ein persönliches Konto ist, das nach dem 13. November 2023 erstellt wurde, führt internes Testen Gehe zu replace the closed-testing requirement for production access. You will still need a closed test with at least 12 opted-in testers for 14 consecutive days before production.

1. Gehe zu internal testing Klicken Sie auf 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

Nachdem 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 Knopf

3. Klicken Sie auf Create new release

4. Klicken Sie auf Upload

5. Wählen Sie das AAB-File

   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, bis das AAB-File hochgeladen ist

7. Klicken Sie auf Next

8. Beheben Sie die Fehler

   Persönlich sehe ich in diesem Stadium 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

Akzeptieren Sie die Einladung zur internen Testgruppe

Jetzt, dass Sie die App in die interne Testgruppe hochgeladen haben, können Sie die Einladung zur internen Testgruppe annehmen.

1. Gehe 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 akzeptiert wurde, und klicken Sie auf „Herunterladen auf 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 die 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 die richtige Konto in Play Store ausgewählt haben.

Konfiguration von 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>	Path zu Ihrem .jks/.keystore Datei, die zur Signierung der APK/AAB verwendet wird.	Ja
Keystore-Alias	--keystore-alias <alias>	Name des Schlüssels innerhalb des Keystores.	Ja
Keystore-Schlüsselpassword	--keystore-key-password <password>	Passwort für die Schlüssel. Wenn Schlüssel/Lagertresorschlüssel übereinstimmen, können Sie nur eines bereitstellen.	Siehe den Hinweis unten
Keystore-Speicherpaswort	--keystore-store-password <password>	Das Passwort für den Keystore. Wenn Schlüssel-/Speicherpaswörter übereinstimmen, können Sie nur eines bereitstellen.	Siehe den Hinweis unten
Google Play-Dienstkontoinformationen	--play-config <path>	JSON-Dienstkontofiles 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 ihnen an --keystore-key-password oder --keystore-store-password.

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

Wenn Sie die Anweisungen befolgt haben Google Play-DienstkontoinformationenSie sollten bereits einen Keystore erstellt haben. Wenn Sie die Anweisungen nicht befolgt haben, folgen Sie ihnen bitte, um den Keystore zu erstellen.

Google Play-Dienstkontoinformation

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

• Sie context zu sein Besitzer des EntwicklerkontosAnsonsten wirst du die Dienstkonten nicht einrichten können.
• Sie müssen ein neues Google Cloud Projekt erstellen (getrennt von Ihrem Google Play-Konto).

Lassen Sie los.

1. haben Google Cloud Console

2. Klicken Sie auf das Projektmenü

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. Ensure that you are on the right project

4. Klicken wir auf die Suchleiste und suchen wir nach service accounts und klicken Sie darauf

5. Klicken wir auf Create service account

6. Besetzen Sie das Formular für das Dienstkonto und klicken Sie auf Done

   1. Ich empfehle, dem Namen 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.

   Achtung

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

8. Klicken Sie auf die Keys tab

9. Klicken Sie auf Add Key und Create new key

10. Klicken Sie auf JSON und Create

    Achtung

    Klicken Sie auf Create erstellt eine neue Schlüssel und lädt das JSON-File auf Ihrem lokalen Gerät herunter.

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

11. Herunterladen Sie das JSON-File Das JSON-File sollte automatisch heruntergeladen worden sein. Sie können auf close um das Fenster zu schließen.

Zugriff auf das Dienstkontoinetzwerk Play Store API gewähren

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

1. Gehe zu Google Play Console
2. Wähle 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ähren Sie die erforderlichen Berechtigungen:
   • In App permissions, Zugriff auf Ihre App gewähren.
   • In Releases, aktivieren Create, edit, and roll out releases.
   • Wenn Ihr Workflow Play App Signing verwendet, aktivieren Sie die zugehörige Signierungs-Erlaubnis.
   • 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

Die Anmeldeinformationen speichern

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 Aktionen)

Wenn Sie bereits abgeschlossen haben Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias and 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) Erstellen Sie Repository-Geheimnisse

In GitHub > Repository > Settings > Secrets and variables > Actions, add:

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 von Keystore, Keystore-Passwort, Keystore-Schlüsselpasswort, Keystore-Alias
KEYSTORE_KEY_PASSWORD	Keystore-Schlüssel-Schlüssel
KEYSTORE_STORE_PASSWORD	Keystore-Speicher-Schlüssel
PLAY_CONFIG_JSON	Inhalt von play_config_base64.txt

Hinweis

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

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

Tip

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

Die Ausführung des Builds

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

Ausführen:

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

Und das startet den Konstruktionsprozess

Submit the Play release for review

Standardmäßig laden Android-Release-Konstruktionen bei Google Play hoch und bleiben dort inaktiv, bis Sie die Veröffentlichung in Play Console abgeschlossen haben. Wenn Ihre CI-Konstruktion die Play-Veröffentlichung automatisch einreichen soll, übergeben Sie --submit-to-store-review mit einer Release-Konstruktion:

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"

Achtung

Bei Android-Geräten --submit-to-store-review standardmäßig auf Produktion mit release_status: completed wenn Sie keinen Track festlegen. Dies kann live zu 100% der Benutzer gehen. Passen Sie --android-track internal (oder alpha / beta— oder setzen Sie PLAY_STORE_TRACK in CI — um den fertigen Release auf einem nicht-produktiven Track zu behalten. Verwenden Sie --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 Uploadweg (PLAY_CONFIG_JSON in CI oder gespeicherte Android-Anmelddaten lokal). --store-release-name wird als Google Play version_name. --store-release-notes ist die Ausfallsicherheit für Play-Changelogs, und jede --store-release-notes-locale "locale=notes" Eintrag schreibt ein lokalisiertes Play-Changelog 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.

Weitermachen von Android Builds

Wenn Sie Capgo verwenden Android-Builds zur Planung der CI/CD-Automatisierung, mit ihm verbinden Capgo CI/CD zum Produktworkflow in Capgo CI/CD, Capgo nativee Native Builds zum Produktworkflow in Capgo Native Builds, Capgo Integrations zum Produktworkflow in Capgo Integrations, CI/CD-Integration zum Implementierungsdetail in CI/CD-Integration, und GitHub Actions-Integration zum Implementierungsdetail in GitHub Actions-Integration.