向測試人員分發 app bundle 版本 - Codelab

1. 概述

圖片10.png

在此 Codelab 中,您將學習如何使用 Firebase App Distribution 及其 Gradle 插件向測試人員分發 Android App Bundle 版本。 App Distribution 為您提供了一個中央樞紐來管理您的應用程序的預發布版本以及您邀請參與每個版本的測試人員。

你會學到什麼

  • 如何將您的 Firebase 應用鏈接到 Google Play
  • 如何將您的應用程序打包並構建為應用程序包
  • 如何創建發布並與實時測試人員共享
  • 作為測試人員如何下載和測試新版本

你需要什麼

  • 安卓工作室 v4.0+
  • 您從 Android Studio 生成的簽名包文件
  • 您是所有者或管理員的 Google Play 開發者帳戶
  • 你在谷歌Play應用程式是在谷歌Play應用程式儀表盤安裝,它具有以下狀態
    • 該應用程序是在已發布的狀態,這意味著它不是在草案和審查已完成(在谷歌的更新狀態欄播放控制台為空)。
    • 該應用程序在以下 Google Play 軌道之一上分發:內部測試、封閉式、開放式測試或生產。
  • 您可以用作測試人員以接收來自 Firebase 的新構建邀請的電子郵件地址

2. 創建一個 Firebase 項目

  1. 登錄火力地堡
  2. 在火力地堡控制台中,單擊添加項目,然後將項目命名為“AppBundlesCodelab。”記住您的 Firebase 項目的項目 ID。如果您不修改項目 ID,Firebase 會自動為您的項目分配一個唯一 ID。

    圖像8.png
  3. (可選)當提示,使谷歌Analytics(分析)。
  4. 完成其餘的步驟,然後單擊創建項目

將您的應用程序包添加到項目中

  1. 在火力地堡控制台中,單擊添加應用程序

    圖像5.png
  2. 當註冊您的應用,確保使用相同的包名稱作為影片上傳到您的谷歌Play開發者帳戶的應用程序。最後,點擊註冊應用
  3. 完成剩餘的步驟,將您的應用程序的火力地堡配置文件(添加google-services.json )到您的應用程序。請注意,對於 Android,App Distribution 沒有可添加到您的應用的 Firebase SDK。
  4. 點擊繼續安慰
  1. 在火力地堡控制台,轉到您的項目設置

    圖像2.png
  2. 集成選項卡,單擊谷歌播放卡上的鏈接
  3. 按照屏幕上的說明啟用 App Distribution 集成,然後選擇您新創建的 Firebase 應用以鏈接到 Google Play。

現在您已完成這些步驟,只要應用程序包名稱匹配,您的 Firebase 應用程序就會關聯到您的 Google Play 開發者帳戶中的應用程序。

3. 將 App Distribution 添加到您的項目中

添加 App Distribution Gradle 插件

現在,您將使用 Android Studio 將 App Distribution 及其 Gradle 插件作為 buildscript 依賴項添加到您的應用程序中。

  1. 在項目級搖籃文件( android/build.gradle ),添加應用程序分發搖籃插件和谷歌的Maven倉庫。
    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. 在您的應用程序級的搖籃文件( android/app/build.gradle ),添加應用程序分發插件:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. 如果你落後企業的代理服務器或防火牆,添加以下Java系統屬性,使應用程序分發到您的分發上傳到火力地堡:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

驗證您的 Firebase 項目

在使用 Gradle 插件之前,您需要對 Firebase 項目進行身份驗證。對於此代碼實驗室,您將使用插件的登錄操作登錄您的 Google 帳戶。

  1. 在你的Android項目的根目錄中運行以下命令:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. 當命令打印身份驗證鏈接時,請在瀏覽器中打開它。出現提示時,登錄您的 Google 帳戶並授予訪問 Firebase 項目的權限。 Gradle 命令會打印一個刷新令牌,App Distribution 插件使用它來對 Firebase 進行身份驗證。
  3. 設置環境變量FIREBASE_TOKEN從上一步令牌:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

4. 在 Android Studio 中配置您的包屬性

在此步驟中,您將自己添加為稍後分發的構建的測試員。分發構建後,測試人員會收到來自 Firebase 的電子郵件通知,邀請他們測試新構建。

在您的app/build.gradle ,添加firebaseAppDistribution部分,包括以下參數:

  • appID :應用程式的火力地堡的App ID。您可以在找到常規選項卡項目設置
  • artifactType :您的應用程序的文件類型( AAB )。
  • testers :測試人員的電子郵件地址。對於此代碼實驗室,請添加您自己的電子郵件,以便您可以在發布後測試您的構建。

例如:

android {

   // ...

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

// ...
}

作為一個選項,你也可以覆蓋在你設定的值build.gradle通過將命令行參數的形式-PappDistribution- property-name = property-value

5. 構建和分發版本

  1. 運行bundle Variant搖籃任務來構建應用程序捆綁的文件:
    $ ./gradlew :base:bundleRelease
    
  2. 找到你的應用程序的構建目錄捆(默認位置為app/build/outputs/bundle/release )。
  3. 要分發的發布,建立目標bundleReleaseappDistributionUploadRelease在項目的搖籃包裝。包括 Firebase 令牌(您在第 3 步中收到的令牌:將應用分發添加到您的應用)。
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

測試人員現在將收到電子郵件邀請以下載和測試構建。作為開發人員,你現在可以監視應用程序分發儀表盤的發布選項卡中的版本。

6. 下載並測試您的版本

在本節中,您將被設置為測試人員,以便下載您分發的版本。作為測試人員,您需要驗證您的測試設備並在 Google Play 商店應用中啟用內部應用共享。

  1. 在您的測試設備上,登錄您的測試人員電子郵件帳戶並打開來自 Firebase 的邀請。

    圖片6.png
  2. 使用您的 Google 帳戶登錄並接受測試分佈式版本的邀請。作為一個選項,你還可以下載應用程序火力地堡測試儀,防止下載的版本中被添加到您的設備Downloads文件夾中。它還顯示有關發布的其他信息,例如下載進度和發布版本。

    圖像9.png
  3. 在釋放點擊下載從Play商店安裝。
  4. 出現提示時,完成剩餘步驟以啟用內部應用程序共享(說明顯示在您的測試設備上,只需完成一次)。

下載完成後,您的版本將自動顯示為設備主屏幕中的快捷方式。

7. 恭喜!

您剛剛使用 Firebase App Distribution 上傳了一個 app bundle 並向測試人員分發了一個版本。

下一步