Verteilen Sie App-Bundle-Releases an Tester – Codelab

1. Übersicht

image10.png

In diesem Codelab erfahren Sie, wie Sie Android App Bundle-Releases mithilfe von Firebase App Distribution und dem Gradle-Plugin an Tester verteilen. App Distribution bietet Ihnen einen zentralen Hub für die Verwaltung von Vorabversionen Ihrer App und der Tester, die Sie zu jeder Version einladen.

Was Sie lernen werden

  • So verknüpfen Sie Ihre Firebase-App mit Google Play
  • So verpacken und erstellen Sie Ihre App als App-Bundle
  • So erstellen Sie eine Veröffentlichung und teilen sie mit Live-Testern
  • So laden Sie als Tester neue Versionen herunter und testen sie

Was du brauchen wirst

  • Neueste Android Studio- Version
  • Eine signierte Bundle-Datei, die Sie aus Android Studio generiert haben
  • Ein Google Play-Entwicklerkonto, dessen Eigentümer oder Administrator Sie sind
  • Ihre App in Google Play ist im Google Play-App-Dashboard eingerichtet und hat den folgenden Status :
    • Die App wird an einen der Google Play-Tracks verteilt (interner Test, geschlossener Test, offener Test oder Produktion).
    • Die Prüfung der App bei Google Play ist abgeschlossen und die App veröffentlicht. Ihre App wird veröffentlicht, wenn in der Spalte „App-Status“ einer der folgenden Status angezeigt wird: Interner Test (kein interner Testentwurf), geschlossener Test, offener Test oder Produktion.
  • Eine E-Mail-Adresse, die Sie als Tester verwenden können, um neue Build-Einladungen von Firebase zu erhalten

2. Erstellen Sie ein Firebase-Projekt

  1. Melden Sie sich bei Firebase an.
  2. Klicken Sie in der Firebase-Konsole auf Projekt hinzufügen und nennen Sie Ihr Projekt dann „AppBundlesCodelab“. Merken Sie sich die Projekt-ID für Ihr Firebase-Projekt. Wenn Sie die Projekt-ID nicht bearbeiten, weist Firebase Ihrem Projekt automatisch eine eindeutige ID zu.

    image8.png
  3. (Optional) Aktivieren Sie Google Analytics, wenn Sie dazu aufgefordert werden.
  4. Führen Sie die verbleibenden Schritte aus und klicken Sie dann auf Projekt erstellen .

Fügen Sie Ihr App-Bundle zum Projekt hinzu

  1. Klicken Sie in der Firebase-Konsole auf App hinzufügen .

    image5.png
  2. Stellen Sie bei der Registrierung Ihrer App sicher, dass Sie denselben Paketnamen verwenden wie die App, die in Ihr Google Play-Entwicklerkonto hochgeladen wird. Klicken Sie abschließend auf App registrieren .
  3. Führen Sie die verbleibenden Schritte aus, um die Firebase-Konfigurationsdatei Ihrer App ( google-services.json ) zu Ihrer App hinzuzufügen. Beachten Sie, dass App Distribution für Android kein Firebase SDK zum Hinzufügen zu Ihrer App bietet.
  4. Klicken Sie auf Weiter zur Konsole .
  1. Gehen Sie in der Firebase-Konsole zu Ihren Projekteinstellungen .

    image2.png
  2. Klicken Sie auf der Registerkarte „Integrationen“ auf der Google Play- Karte auf „Link“ .
  3. Befolgen Sie die Anweisungen auf dem Bildschirm, um die App Distribution-Integration zu aktivieren, und wählen Sie dann Ihre neu erstellte Firebase-App aus, um sie mit Google Play zu verknüpfen.

Nachdem Sie diese Schritte ausgeführt haben, wird Ihre Firebase-App mit Ihrer App in Ihrem Google Play-Entwicklerkonto verknüpft, sofern die Paketnamen der Apps übereinstimmen.

3. Fügen Sie App Distribution zu Ihrem Projekt hinzu

Fügen Sie das App Distribution Gradle-Plugin hinzu

Jetzt verwenden Sie Android Studio, um App Distribution und das zugehörige Gradle-Plugin zu Ihrer App hinzuzufügen.

  1. Fügen Sie in Ihrer Gradle-Datei auf Projektebene ( android/build.gradle.kts ) das App Distribution Gradle-Plugin zum plugins Block hinzu.
    plugins {
         //...
    
         // Add the App Distribution Gradle plugin
         id("com.google.firebase.appdistribution") version "4.0.0" apply false
    }
    
  2. Fügen Sie in Ihrer Gradle-Datei „Einstellungen“ auf Projektebene ( android/settings.gradle.kts ) das Maven-Repository von Google zum pluginManagement Block hinzu.
     pluginManagement {
         // Check that you have Google's Maven repository (if not, add it).
         repositories {
             google()
             mavenCentral()
         }
     }
    
  3. Fügen Sie in Ihrer Gradle-Datei auf App-Ebene ( android/app/build.gradle.kts ) das App Distribution-Plugin zum plugins Block hinzu.
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. Wenn Sie sich hinter einem Unternehmens-Proxy oder einer Firewall befinden, fügen Sie die folgende Java-Systemeigenschaft hinzu, die es App Distribution ermöglicht, Ihre Distributionen in Firebase hochzuladen:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Authentifizieren Sie Ihr Firebase-Projekt

Bevor Sie das Gradle-Plugin verwenden können, müssen Sie Ihr Firebase-Projekt authentifizieren. Für dieses Codelab melden Sie sich mit der Firebase-CLI bei Ihrem Google-Konto an.

Führen Sie den folgenden Befehl im Stammverzeichnis Ihres Android-Projekts aus:

~/your-android-project$ firebase login

Weitere Einzelheiten finden Sie in der Referenzdokumentation .

4. Konfigurieren Sie Ihre Bundle-Eigenschaften in Android Studio

In diesem Schritt fügen Sie sich selbst als Tester für den Build hinzu, den Sie später verteilen. Sobald Sie den Build verteilen, erhalten Tester E-Mail-Benachrichtigungen von Firebase, in denen sie zum Testen des neuen Builds eingeladen werden.

Fügen Sie in Ihrer app/build.gradle.kts einen Abschnitt firebaseAppDistribution hinzu und schließen Sie die folgenden Parameter ein:

  • appID : Die Firebase-App-ID Ihrer App. Sie finden es auf der Registerkarte „Allgemein“ Ihrer Projekteinstellungen .
  • artifactType : Der Dateityp Ihrer App ( AAB ).
  • testers : Die E-Mail-Adressen Ihrer Tester. Fügen Sie für dieses Codelab Ihre eigene E-Mail-Adresse hinzu, damit Sie Ihren Build testen können, sobald er verteilt ist.

Zum Beispiel:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

Optional können Sie auch die in Ihrer build.gradle.kts festgelegten Werte überschreiben, indem Sie Befehlszeilenargumente in der Form -PappDistribution- property-name = property-value übergeben.

5. Erstellen und verteilen Sie ein Release

  1. Führen Sie die bundle Variant Gradle-Aufgabe aus, um Ihre App-Bundles-Datei zu erstellen:
    $ ./gradlew :base:bundleRelease
    
  2. Suchen Sie das Bundle im Build-Verzeichnis Ihrer Anwendung (der Standardspeicherort ist app/build/outputs/bundle/release ).
  3. Um die Veröffentlichung zu verteilen, erstellen Sie die Ziele bundleRelease und appDistributionUploadRelease mit dem Gradle-Wrapper Ihres Projekts. Fügen Sie das Firebase-Token hinzu (das, das Sie in Schritt 3: App-Verteilung zu Ihrer App hinzufügen) erhalten haben.
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

Tester erhalten nun E-Mail-Einladungen zum Herunterladen und Testen des Builds. Als Entwickler können Sie den Build jetzt auf der Registerkarte „Releases“ des App Distribution-Dashboards überwachen.

6. Laden Sie Ihre Version herunter und testen Sie sie

In diesem Abschnitt werden Sie als Tester eingerichtet, um die von Ihnen verteilte Version herunterzuladen. Als Tester müssen Sie Ihr Testgerät authentifizieren und die interne App-Freigabe in der Google Play Store-App aktivieren.

  1. Melden Sie sich auf Ihrem Testgerät bei Ihrem Tester-E-Mail-Konto an und öffnen Sie die Einladung von Firebase.

    image6.png
  2. Melden Sie sich mit Ihrem Google-Konto an und nehmen Sie die Einladung zum Testen der verteilten Version an. Optional können Sie auch Firebase App Tester herunterladen, der verhindert, dass heruntergeladene Versionen zum Downloads Ordner Ihres Geräts hinzugefügt werden. Außerdem werden zusätzliche Informationen zu Releases angezeigt, z. B. der Download-Fortschritt und die Release-Version.

    image9.png
  3. Tippen Sie in der Version auf „Herunterladen“ , um sie aus dem Play Store zu installieren.
  4. Wenn Sie dazu aufgefordert werden, führen Sie die verbleibenden Schritte aus, um die interne App-Freigabe zu aktivieren (die Anweisungen werden auf Ihrem Testgerät angezeigt und müssen nur einmal ausgeführt werden).

Sobald der Download abgeschlossen ist, wird Ihre Veröffentlichung automatisch als Verknüpfung auf dem Startbildschirm Ihres Geräts angezeigt.

7. Herzlichen Glückwunsch!

Sie haben gerade Firebase App Distribution verwendet, um ein App-Bundle hochzuladen und eine Version an Tester zu verteilen.

Nächste Schritte