Verteilen Sie Android-Apps an Tester mit fastlane

Dieses Handbuch beschreibt , wie AAB Tester baut mit verteilen fastlane , eine Open - Source - Plattform , die automatisiert den Aufbau und iOS und Android Apps veröffentlichen. Es folgt einfach den Anweisungen in einem definierten Fastfile . Nachdem Sie Fastlane und Ihre einrichten Fastfile , können Sie App Verteilung mit fastlane Konfiguration integrieren.

Um dieser Anleitung folgen zu können, benötigen Sie Zugriff auf ein Google Play-Konto, dessen Administrator oder Inhaber Sie sind, sowie auf eine App, die im Play-Konto veröffentlicht wurde.

Informationen zum Verteilen von Android App Bundles

App Distribution lässt sich in den internen App-Sharing-Dienst von Google Play integrieren, um die von Ihnen hochgeladenen AABs zu verarbeiten und APKs bereitzustellen, die für die Gerätekonfigurationen Ihrer Tester optimiert sind. Wenn Sie AABs verteilen, können Sie:

  • Führen Sie optimierte APKs aus (von Google Play bereitgestellt), die für die Geräte Ihrer Tester optimiert sind.
  • Aufdecken und Debuggen gerätespezifischer Probleme.
  • Test - App Bundle Features wie Feature - Lieferung Wiedergabe und Play - Asset - Lieferung
  • Reduzieren Sie die Downloadgröße für Ihre Tester.

Bevor Sie beginnen

  1. Wenn Sie nicht bereits haben, fügen Sie Firebase zu dem Android - Projekt .

    Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie sich jedoch entscheiden, in Zukunft zusätzliche Produkte zu verwenden, führen Sie alle Schritte auf der oben verlinkten Seite aus.

  2. Verbinden Sie Ihr Firebase-Projekt mit Ihrem Google Play-Konto. Nach der Verbindung werden Apps, die die folgenden Anforderungen erfüllen, automatisch zwischen Ihrem Firebase-Projekt und Ihrem Google Play-Konto verknüpft:

    • Die App, die Sie bei Google Play hochladen, und Firebase müssen denselben Paketnamen haben.

    • Die App in Google Play muss sich in einem veröffentlichten Zustand befinden. Eine App wird veröffentlicht, wenn ihr App-Store-Eintrag fertiggestellt und genehmigt wurde und die App an einen der folgenden Google Play-Tracks verteilt wurde: intern, geschlossen, Produktion oder offener Test.

    So verbinden Sie Ihr Firebase-Projekt:

    1. Stellen Sie sicher, dass Sie der Inhaber Ihres Firebase-Projekts und der Kontoadministrator oder Inhaber Ihres Google Play-Kontos sind.

    2. In Ihrem Projekt Firebase, Navigieren Sie zu (Settings), und klicken Sie auf Einstellungen Projekt> Integrationen.

    3. Wenn Sie nicht bereits haben, aktivieren Sie über die Google Analytics - Karte Google Analytics. Dies ist erforderlich, um Ihr Projekt mit Google Play zu verknüpfen.

    4. Klicken Sie auf Link auf der Google Play - Karte.

Schritt 1. Fastlane einrichten

  1. Installieren und Einrichten von fastlane .

  2. Um App Distribution zu Ihrer Fastlane-Konfiguration hinzuzufügen, führen Sie den folgenden Befehl im Stammverzeichnis Ihres Android-Projekts aus:

    fastlane add_plugin firebase_app_distribution

    Wenn der Befehl fordert Sie mit einer Option, wählen Sie Option 3: RubyGems.org .

Schritt 2. Mit Firebase authentifizieren

Bevor Sie das Fastlane-Plug-in verwenden können, müssen Sie sich zunächst bei Ihrem Firebase-Projekt authentifizieren. Es gibt drei Möglichkeiten, dies zu erreichen:

Schritt 3. Richten Sie Ihr Fastfile ein und verteilen Sie Ihre App

  1. In einer ./fastlane/Fastfile Spur, fügen Sie einen firebase_app_distribution Block. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:
    firebase_app_distribution-Parameter
    app

    Erforderlich: Ihre App Firebase App - ID. Sie können die App - ID in der Firebase - Konsole im finden Seite Allgemeine Einstellungen .

    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

    Ein Aktualisierungs - Token , dass gedruckt wird , wenn Sie das Plugin-Login Aktion ausführen (siehe Authentifizieren mit einem Google - Konto , oben), oder wenn Sie Ihre CI - Umgebung mit dem Firebase CLI (lesen Sie authentifizieren Verwenden der CLI mit CI - Systeme für weitere Informationen).

    service_credentials_file

    Der Pfad zur JSON-Datei Ihres Google-Dienstkontos. Siehe oben für , wie Anmeldeinformationen Dienstkonto zu authentifizieren .

    android_artifact_type

    Gibt den Android-Dateityp (APK oder AAB) an.

    android_artifact_path

    Ersetzt apk_path (veraltet). Absoluter Pfad zu der APK- oder AAB-Datei, die Sie hochladen möchten. Wenn nicht angegeben, bestimmt fastlane den Speicherort der Datei anhand der Spur, in der die Datei generiert wurde.

    release_notes
    release_notes_file

    Versionshinweise für diesen Build.

    Sie können die Versionshinweise entweder direkt angeben:

    release_notes: "Text of release notes"

    Oder geben Sie den Pfad zu einer Nur-Text-Datei an:

    release_notes_file: "/path/to/release-notes.txt"
    testers
    testers_file

    Die E-Mail-Adressen der Tester, die Sie einladen möchten.

    Sie können die Tester als durch Kommas getrennte Liste von E-Mail-Adressen angeben:

    testers: "ali@example.com, bri@example.com, cal@example.com"

    Oder Sie können den Pfad zu einer Nur-Text-Datei angeben, die eine durch Kommas getrennte Liste von E-Mail-Adressen enthält:

    testers_file: "/path/to/testers.txt"
    groups
    groups_file

    Die Tester Gruppen , die Sie einladen möchten (siehe Tester verwalten ). Gruppen werden mit . angegeben Gruppenaliase , die Sie in der Firebase-Konsole nachschlagen können.

    Sie können die Gruppen als durch Kommas getrennte Liste angeben:

    groups: "qa-team, trusted-testers"

    Oder Sie können den Pfad zu einer Nur-Text-Datei angeben, die eine durch Kommas getrennte Liste von Gruppennamen enthält:

    groups_file: "/path/to/groups.txt"
    debug

    Eine boolesche Flagge. Sie können diese Einstellung vornehmen , true ausführlichen Debug - Ausgabe zu drucken.

    Zum Beispiel:

    platform :android do
        desc "My awesome app"
        lane :distribute do
            build_android_app(task: "bundle", ...)
            # build_android_app is a built-in fastlane action.
            firebase_app_distribution(
                app: "1:123456789:android:abcd1234",
                testers: "tester1@company.com, tester2@company.com",
                release_notes: "Lots of amazing new features to test out!",
                android_artifact_type: "AAB"
            )
        end
    end

  2. Schließlich, um die Build zur Verfügung Tester zu machen, führen Sie Ihre Spur:
    fastlane <lane>

Sobald Sie Ihren Build verteilt haben, ist er 150 Tage (fünf Monate) im App-Verteilungs-Dashboard der Firebase-Konsole verfügbar. Wenn der Build 30 Tage vor dem Ablaufen liegt, wird sowohl in der Konsole als auch in der Build-Liste Ihres Testers auf seinem Testgerät eine Ablaufbenachrichtigung angezeigt.

Tester , die nicht eingeladen haben , um die Anwendung zu testen , erhalten E - Mail - Einladungen , um loszulegen, und bestehende Tester erhalten E - Mail - Benachrichtigungen , dass eine neue Build - Test (lesen Sie die bereit ist , Tester Set up Anleitung für Anweisungen, wie die Test - App installieren). Sie können den Status jedes Testers in der Firebase-Konsole überwachen – ob er die Einladung angenommen hat und ob er die App heruntergeladen hat.