Android Builds

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

Was Sie lernen werden

• Sie werden erfahren, wie Sie Ihre App über Capgo Native build hochladen können
• Sie werden erfahren, 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

Der folgende manuelle Leitfaden ist nur für diejenigen gedacht, die ihre Anmeldeinformationen 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 ersten manuellen Build durchzuführen:

• Sie werden die Anmeldeinformationen für den späteren Capgo-Build vorbereiten
• Sie werden ein Verzeichnis auf dem Play Store Console erstellen

Die App manuell mit Android Studio bauen

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

1. Android Studio öffnen

   Ausführen bunx cap open android um das Android Studio-Projekt zu öffnen.

2. Auf Build -> Generate Signed App Bundles / APKs

3. Auswählen Android App Bundle und auf Next

Erstellen eines Keystores

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

1. Klicken Sie auf Create new

2. Bitte den Pfad zum Key Store eintragen

   Vorsicht

   Dies Soll gespeichert werden - es wird später verwendet

3. Stellen Sie das Key Store-Passwort ein

   Hinweis

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

   Vorsicht

   Dies ZU SPEICHERN - es wird später verwendet

4. Füllen Sie den Rest der Form aus

   1. Bleiben Sie bei dem Key Alias (key0)
   2. Füllen Sie die Zertifikatsdetails aus. Ich habe es mit fiktiven Details 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-Varianten 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. 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 interne 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 zu rauchen-zuzustellen, bevor ein echter Launch stattfindet.

Wenn dein 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. Du wirst immer noch einen geschlossenen Test mit mindestens 12 sich freiwillig anmeldenden Testern für 14 aufeinanderfolgende Tage benötigen, bevor du in die Produktion gehst. Zu Klicke auf

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

   

2. Erstellung der internen Testgruppe Testers

3. Klicken Sie auf Create email list

4. Der E-Mail-Liste einen Namen geben

5. Die E-Mail-Adressen der Tester hinzufügen

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

Das Hochladen der App 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 Button

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 der Capgo-Native Build fehlschlagen.

6. Warten Sie, bis das AAB-File hochgeladen ist

7. Klicken Sie auf Next

8. Die Fehler beheben

   Persönlich, in dieser Phase sehe ich 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 die internen Testgruppe veröffentlichen.

10. Bestätigung der Veröffentlichung

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

12. Holen Sie sich Ihren temporären App-Namen

Die Einladung zur internen Testgruppe akzeptieren

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

1. Gehe zu Test and release -> Testing -> Internal testing

2. Klicke auf Testers

3. Klicke auf Copy link

4. Senden Sie den Link an Ihr Handy, öffnen Sie ihn im Browser und klicken 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 __CAPGO_KEEP_0__
   2. Klicken Sie auf den install __CAPGO_KEEP_0__
   3. Öffnen Sie die App und bestätigen Sie, dass sie erfolgreich heruntergeladen wurde

   Vorsicht

   If 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 Einrichtung von Capgo Native Build zu starten. Herzlichen Glückwunsch! 🎉

Anforderung	Flagge	Beschreibung	erforderlich
Keystore-Datei	--keystore <path>	Weg zu Ihrer .jks/.keystore Datei, die zum Signieren des APK/AAB verwendet wird.	Ja
Sicherheitspeckernamen	--keystore-alias <alias>	Name des Schlüssels innerhalb des Sicherheitspeckers.	Ja
Sicherheitspeckerschlüsselpasswort	--keystore-key-password <password>	Passwort für den Schlüssel. Wenn Schlüssel-/Sicherheitspeckerpaswörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich die folgende Anmerkung an
Sicherheitspeckerpaswort	--keystore-store-password <password>	Passwort für den Sicherheitspecker. Wenn Schlüssel-/Sicherheitspeckerpaswörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich die folgende Anmerkung an
Google Play-Dienstkontokonto	--play-config <path>	JSON-Kontodatei 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 Speicherpasswort 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, folgen Sie ihnen bitte, um den Keystore zu erstellen. Google Play-DienstkontoinformationenGoogle Play Dienstkontoinformationen

Google Play Dienstkontoinformationen

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 MUSSEN der Besitzer des Entwicklerkontos 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)
• Los geht's.

Gehe zu

1. Google Cloud Console Klicken Sie auf den Projektselector

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. Geben Sie Ihrem Projekt einen Namen und klicken Sie Create
   3. Stellen Sie sicher, dass Sie sich im richtigen Projekt befinden

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

5. Klicken wir auf Create service account

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

   1. Ich empfehle Ihnen, dem Namen Capgo Native Build Service Account
   2. Für die Dienstkonten-ID empfehle ich Ihnen, sie auf capgo-native-build-service-acc
   3. Wenn es um die Beschreibung geht, 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 die neu erstellte Dienstkonten Sie sollten nun die neu erstellte Dienstkonten in der Liste sehen. Klicken Sie darauf.

   Hinweis

   Diesen E-Mail-Adressen kopieren Sie auch, Sie benötigen sie später.

8. Klicken Sie auf das Keys Registerkarten-Icon

9. Klicken Sie auf Add Key und Create new key

10. Klicken Sie auf JSON und Create

    Achtung

    Klicken Sie auf Create wird eine neue Schlüssel erstellen und das JSON-Datei herunterladen auf Ihr lokales Gerät.

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

11. Die 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 Play Store API-Dienstkonten erteilen

Die neu erstellte Dienstkonten haben noch keinen Zugriff auf die Play Store API. Um es zu erteilen, gehen Sie zum Play Store Console.

1. Gehe zu Google Play Console
2. Wähle das richtige Entwicklerkonto aus
3. Klicken Sie auf Users and permissions
4. Klicken Sie auf Invite new users
5. Kopieren Sie die E-Mail-Adresse der Dienstkonten
6. Gehe zu Account permissions und erteilen Sie die erforderlichen Mindestberechtigungen:
   • 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 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

Tipps

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, 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 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 Speicherpasswörter gleich sind, können Sie nur eines bereitstellen 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 }}

Tipp

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

Die Verarbeitung der Build-Datei

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 wird den Build-Prozess starten 🍾🥂

Die Play-Veröffentlichung zur Überprüfung einreichen

Standardmäßig laden Android-Release-Builds bei Google Play hoch und bleiben dort inaktiv, bis Sie die Veröffentlichung in Play Console abgeschlossen haben. Wenn Ihre CI-Veröffentlichung die Play-Veröffentlichung automatisch einreichen soll, übergeben Sie --submit-to-store-review mit einer 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"

Dies erfordert die gleiche Google Play-Dienstkontoeinrichtung wie der normale Uploadpfad (PLAY_CONFIG_JSON in CI oder gespeicherte Android-Kredentials lokal). --store-release-name wird als Google Play-Veröffentlichungsname verwendet. --store-release-notes ist der Standard-Play-Changelogs, und jeder --store-release-notes-locale "locale=notes" Eintrag erstellt einen lokalisierten Play-Changelogs für diese Region. Capgo sendet die Play-Veröffentlichung als completed; 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 Android Builds zur Planung von CI/CD-Automatisierung verwenden, verbinden Sie es mit __CAPGO_KEEP_0__ CI/CD Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo Native Builds für den 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.