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 benötigen ein aktives Google-Entwicklerkonto
• Sie benötigen Android Studio installiert
• Ihre App muss erfolgreich mit Android Studio erstellt werden können

Hinweis

Für diese Anleitung werde ich folgende App verwenden: https://github.com/Cap-go/capgo-native-build-tutorial-app

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.

• You will prepare the credentials for the later Capgo build
• Sie werden die Zugangsdaten für den späteren __CAPGO_KEEP_0__-Build vorbereiten und

Die App manuell mit Android Studio erstellen

Bevor wir mit Capgo die App erstellen 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

Eine Keystore erstellen

Sie fehlen derzeit dem Keystore-Datei. Diese Datei wird verwendet, um Ihre App zu signieren, was Google wissen lässt, dass Sie die App erstellt haben.

1. Klicken Sie auf Create new

2. Füllen Sie den Pfad der Key Store ein

   Dies

   SICH FÜR SPOREN LASSEN - es wird später verwendet Legen Sie den Key Store-Passwort fest

3. Set the Key Store password

   Hinweis

   Ich empfehle, denselben Schlüssel für den Schlüsseltresor und den Schlüsselalias zu verwenden.

   Vorsicht

   Dies WICHTIG - ES WIRD SPÄTER BENÖTIGT - es wird später verwendet

4. Füllen Sie den Rest des Formulars aus

   1. Halten Sie den Schlüsselalias unverändert (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-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 die Erstellung 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 aus

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

Die interne Testgruppe erstellen

Nachdem Sie die App erstellt haben, können Sie eine interne Testgruppe erstellen. Da ich die App nicht 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 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 Google Play Console gehen Auf

1. Klicken Sie auf internal testing Zum internen Testen im Google Play Console gehen Test and release -> Testing -> Internal testing

   

2. Klicken Sie auf 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

Die App im internen Testgruppen hochladen

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 Button

3. Klicken Sie auf Create new release

4. Klicken Sie auf Upload

5. Wählen Sie das AAB-File aus

   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 bei dieser Stufe 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 Dies wird die App in die interne Testgruppe veröffentlichen.

10. Bestätigen Sie die 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 Button
   2. Klicken Sie auf den install Button
   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 Einrichtung 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 des Schlüssels im Keystore.	Ja
Keystore-Schlüsselpassword	--keystore-key-password <password>	Das Passwort für den Schlüssel. Wenn Schlüssel-/Speicherpaswörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich die Notiz unten an
Keystore-Speicherpaswort	--keystore-store-password <password>	Das Passwort für den Keystore. Wenn Schlüssel-/Speicherpaswörter übereinstimmen, können Sie nur eines bereitstellen.	Schauen Sie sich die Notiz unten an
Google Play-Dienstkontoinformationen	--play-config <path>	JSON-Dienstkontoinformationen-Datei für Play Store-Uploads.	Ja

bunx @capgo/cli 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. 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.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-Dienstkontokonto

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 Entwicklerkontossein. 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.

1. Gehe zu Google Cloud Console

2. Klicken Sie auf den Projekt-Selektor

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

5. Klicken Sie auf Create service account

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

   1. Ich empfehle, den Namen auf Capgo Native Build Service Account
   2. Für die Service-Account-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 die neu erstellte Dienstkonten Sie sollten nun die neu erstellte Dienstkonten 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 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 eine neue Schlüssel erstellen und das JSON-Datei herunterladen Sie auf Ihrem lokalen Computer.

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

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

Zugriff auf die Dienstkontoinstanz API für Google Play Store gewähren

Das neu erstellte Dienstkonto hat noch keinen Zugriff auf das Google Play Store API. Um es zu gewähren, gehen Sie zum Google Play 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 des Dienstkontos
6. Gehe zu Account permissions und gewähre die erforderlichen Mindestrechte:
   • In App permissions, gewähre deinem App Zugriff.
   • 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 danach.
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 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 fertig sind Sicherheitskasten, Sicherheitskasten-Passwort, Sicherheitskasten-Schlüsselpasswort, Sicherheitskasten-Alias und Google Play-Dienstkontoinformation, Sie haben bereits alles, was für CI/CD benötigt wird. Diese Abschnitt behandelt nur, wie Sie diese Werte als GitHub Actions-Secrets und Umgebungsvariablen übergeben.

1) Konvertieren Sie die Zugriffsdateien 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-Secrets 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 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-Passwort identisch 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 ${{ 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 die Anmeldeinformationen nur über Umgebungsvariablen. Sie müssen keine Signierungsdateien committen oder als Workflow-Artikel hochladen.

Build ausführen

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

Ausführen:

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

Und das startet den Build-Prozess 🍾🥂