Verteilen von App-Bundle-Releases an Tester - Codelab

image10.png

In diesem Codelab erfahren Sie, wie Sie mit Firebase App Distribution und dem Gradle-Plug-in Android App Bundle-Versionen an Tester verteilen. App Distribution bietet einen zentralen Hub, über den Sie Vorabversionen Ihrer App und die Tester verwalten können, die Sie zu jedem Release einladen.

Was du lernst

  • So verknüpfen Sie Ihre Firebase-App mit Google Play
  • So verpacken und erstellen Sie Ihre App als App Bundle
  • So erstellen Sie ein Release und teilen es mit Live-Testern
  • Wie man als Tester neue Releases herunterlädt und testet

Was du brauchen wirst

  • Android Studio v4.0+
  • Eine signierte Bundle-Datei, die Sie aus Android Studio generiert haben
  • Ein Google Play-Entwicklerkonto, dessen Inhaber oder Administrator Sie sind
  • Ihre App in Google Play ist Setup auf der Google Play App Armaturenbrett , und es hat den folgenden Status :
    • Die App ist in einem veröffentlichten Zustand, was bedeutet , dass es nicht in Entwurf und die Überprüfung abgeschlossen ist (die Update - Status - Spalte in der Google Play - Konsole ist leer).
    • Die App wird auf einem der folgenden Google Play-Tracks verteilt: interner Test, geschlossener, offener Test oder Produktion.
  • Eine E-Mail-Adresse, die Sie als Tester verwenden können, um Einladungen zu neuen Builds von Firebase zu erhalten
  1. Melden Sie sich in Firebase .
  2. In der Firebase Konsole, klicken Sie auf Projekt hinzufügen, benennen Sie Ihr Projekt „AppBundlesCodelab.“ Merken Sie sich die Projekt-ID Ihres Firebase-Projekts. Wenn Sie die Projekt-ID nicht bearbeiten, weist Firebase Ihrem Projekt automatisch eine eindeutige ID zu.

    image8.png
  3. (Optional) Wenn Sie gefragt werden , aktivieren Sie Google Analytics.
  4. Führen Sie die verbleibenden Schritte, klicken Sie dann auf Projekt.

Fügen Sie Ihr App Bundle zum Projekt hinzu

  1. In der Konsole Firebase, klicken Sie auf Hinzufügen App.

    image5.png
  2. Wenn Ihre App registrieren, stellen Sie sicher , das gleiche Paket Namen wie die App zu nutzen , die zu Ihrem Google Play - Entwicklerkonto hochgeladen wird . Klicken Sie abschließend auf Register App.
  3. Führen Sie die verbleibenden Schritte Ihrer App Firebase - Konfigurationsdatei (hinzufügen google-services.json ) , um Ihre Anwendung. Beachten Sie, dass App Distribution für Android kein Firebase SDK zum Hinzufügen zu Ihrer App hat.
  4. Klicken Sie auf Weiter zu trösten.
  1. In der Firebase - Konsole zu Ihren Projekteinstellungen.

    image2.png
  2. Im Register Integrationen, klicken Sie auf Link auf der Google Play - Karte.
  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 abgeschlossen haben, wird Ihre Firebase-App mit Ihrer App in Ihrem Google Play-Entwicklerkonto verknüpft, solange die Paketnamen der Apps übereinstimmen.

Fügen Sie das Gradle-Plug-in für die App-Verteilung hinzu

Jetzt verwenden Sie Android Studio, um App Distribution und das dazugehörige Gradle-Plug-in als Buildscript-Abhängigkeiten zu Ihrer App hinzuzufügen.

  1. In Ihrer Projektebene Gradle Datei ( android/build.gradle ), fügen Sie die App Verteilung Gradle Plugin und Maven - Repository von Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. In der App-Ebene Gradle Datei ( android/app/build.gradle ), fügen Sie die App Verteilung Plugin:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Wenn Sie hinter einem Unternehmens - Proxy oder Firewall sind, dann fügen Sie die folgende Java - Systemeigenschaft , die App Verteilung ermöglicht Ihre Ausschüttungen an Firebase zu laden:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Authentifizieren Sie Ihr Firebase-Projekt

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

  1. Führen Sie den folgenden Befehl an der Wurzel Ihres Android - Projekt:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Wenn der Befehl einen Authentifizierungslink druckt, öffnen Sie ihn in einem Browser. Melden Sie sich bei Aufforderung bei Ihrem Google-Konto an und erteilen Sie die Berechtigung zum Zugriff auf Ihr Firebase-Projekt. Der Befehl Gradle druckt ein Aktualisierungstoken, das das App Distribution-Plug-in verwendet, um sich bei Firebase zu authentifizieren.
  3. Setzen Sie die Umgebungsvariable FIREBASE_TOKEN auf das Token aus dem vorherigen Schritt:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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

In Ihrem app/build.gradle , fügen Sie einen firebaseAppDistribution Abschnitt und umfasst die folgenden Parameter:

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

Zum Beispiel:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

Als Option können Sie außer Kraft setzen auch die in der festgelegten Werte build.gradle durch Befehlszeilenargumente in Form der Weitergabe -PappDistribution- property-name = property-value .

  1. Führen Sie das bundle Variant Gradle Aufgabe App bündelt - Datei zu erstellen:
    $ ./gradlew :base:bundleRelease
    
  2. Suchen Sie das Bündel in Ihrer Anwendung Build - Verzeichnis (das Standardverzeichnis ist app/build/outputs/bundle/release ).
  3. Um die Veröffentlichung zu verteilen, bauen die Ziele bundleRelease und appDistributionUploadRelease mit Ihrem Projekt Gradle - Wrapper. Fügen Sie das Firebase-Token hinzu (dasjenige, 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 nun den Bau in dem Releases Registerkarte der Verteilungs - Dashboard App überwachen.

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. Als Option können Sie auch Firebase App Tester herunterladen, die verhindert , dass Meldungen aus zu Ihrem Gerät hinzugefügt heruntergeladen Downloads - Ordner. Außerdem werden zusätzliche Informationen zu Releases angezeigt, z. B. der Download-Fortschritt und die Release-Version.

    image9.png
  3. Tippen Sie auf Download auf der Freisetzung 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 Freigabe automatisch als Verknüpfung auf dem Startbildschirm Ihres Geräts angezeigt.

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

Nächste Schritte