使用 Gradle 將 Android 應用分發給測試人員

您可以使用 App Distribution Gradle 插件將 App Distribution 集成到您的 Android 構建過程中。該插件允許您在應用程序的build.gradle文件中指定測試人員和發行說明，讓您為應用程序的不同構建類型和變體配置分發。

本指南介紹瞭如何使用 App Distribution Gradle 插件將 APK 分發給測試人員。

在你開始之前

如果您還沒有，請將 Firebase 添加到您的 Android 項目中。

如果您不使用任何其他 Firebase 產品，則只需創建一個項目並註冊您的應用程序。但是，如果您決定將來使用其他產品，請務必完成上面鏈接頁面上的所有步驟。

步驟 1. 設置您的 Android 項目

1. 在您的根級別（項目級別） Gradle 文件（ <project>/build.gradle或<project>/build.gradle.kts ）中，將 App Distribution Gradle 插件添加為 buildscript 依賴項：

   時髦的

   buildscript {
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   
     dependencies {
         ...
         classpath 'com.android.tools.build:gradle:7.2.0'
   
         // Make sure that you have the Google services Gradle plugin dependency
         classpath 'com.google.gms:google-services:4.3.15'
   
         // Add the dependency for the App Distribution Gradle plugin
         classpath 'com.google.firebase:firebase-appdistribution-gradle:4.0.0'
     }
   }
   

   科特林

   buildscript {
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   
     dependencies {
         ...
         classpath("com.android.tools.build:gradle:7.2.0")
   
         // Make sure that you have the Google services Gradle plugin dependency
         classpath("com.google.gms:google-services:4.3.15")
   
         // Add the dependency for the App Distribution Gradle plugin
         classpath("com.google.firebase:firebase-appdistribution-gradle:4.0.0")
     }
   }
   

2. 在您的模塊（應用程序級） Gradle 文件（通常<project>/<app-module>/build.gradle或<project>/<app-module>/build.gradle.kts中，添加 App Distribution Gradle 插件：

   時髦的

   plugins {
     id 'com.android.application'
   
     // Make sure that you have the Google services Gradle plugin
     id 'com.google.gms.google-services'
   
     // Add the App Distribution Gradle plugin
     id 'com.google.firebase.appdistribution'
   }
   

   科特林

   plugins {
     id("com.android.application")
   
     // Make sure that you have the Google services Gradle plugin
     id("com.google.gms.google-services")
   
     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution")
   }
   

3. 如果您在公司代理或防火牆後面，請添加以下Java 系統屬性，使 App Distribution 能夠將您的分發上傳到 Firebase：

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

第 2 步：使用 Firebase 進行身份驗證

在使用 Gradle 插件之前，您必須先通過以下方式之一對您的 Firebase 項目進行身份驗證。默認情況下，如果沒有使用其他身份驗證方法，Gradle 插件會從 Firebase CLI 中查找憑據。

第 3 步。配置您的分發屬性

在您的模塊（應用程序級） Gradle 文件（通常<project>/<app-module>/build.gradle或<project>/<app-module>/build.gradle.kts中，通過至少添加配置 App Distribution一個firebaseAppDistribution部分。

例如，要將release分發給測試人員，請遵循以下說明：

android {

  // ...

  buildTypes {
      release {
          firebaseAppDistribution {
              artifactType="APK"
              releaseNotesFile="/path/to/releasenotes.txt"
              testers="ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      release {
          firebaseAppDistribution {
              artifactType = "APK"
              releaseNotesFile = "/path/to/releasenotes.txt"
              testers = "ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

您可以為構建類型和產品風格配置 App Distribution。

例如，要分發“演示”和“完整”產品風格的debug和release版本，請遵循以下說明：

android {

  // ...

  buildTypes {
      debug {...}
      release {...}
  }

  flavorDimensions "version"
  productFlavors {
      demo {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for demo version"
              testers="demo@testers.com"
          }
      }
      full {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for full version"
              testers="full@testers.com"
          }
      }
  }

  // ...
}

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("debug") {...}
      getByName("release") {...}
  }

  flavorDimensions += "version"
  productFlavors {
      create("demo") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for demo version"
              testers = "demo@testers.com"
          }
      }
      create("full") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for full version"
              testers = "full@testers.com"
          }
      }
  }

  // ...
}

使用以下參數配置分發：

appId="1:1234567890:android:321abc456def7890"

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

testersFile="/path/to/testers.txt"

groups="qa-team, android-testers"

groupsFile="/path/to/tester-groups.txt"

第 4 步。將您的應用程序分發給測試人員

1. 最後，要打包您的測試應用程序並邀請測試人員，請使用項目的 Gradle 包裝器構建目標BUILD-VARIANT和appDistributionUpload BUILD-VARIANT ，其中BUILD-VARIANT是您在上一步中配置的可選產品風格和構建類型。有關產品風格的更多信息，請參閱配置構建變體。

   例如，要使用release構建變體分發您的應用程序，請運行以下命令：

   ./gradlew assembleRelease appDistributionUploadRelease
   

   或者，如果您使用Google 帳戶進行身份驗證但未在 Gradle 構建文件中提供憑據，請包含FIREBASE_TOKEN變量：

   export FIREBASE_TOKEN=1/a1b2c3d4e5f67890
   ./gradlew --stop // Only needed for environment variable changes
   ./gradlew assembleRelease appDistributionUploadRelease
   

2. 您還可以通過以--<property-name>=<property-value>的形式傳遞命令行參數來覆蓋build.gradle文件中設置的值。例如：

   • 要將調試版本上傳到 App Distribution：

     ./gradlew bundleDebug appDistributionUploadDebug
         --artifactType="APK"
     

   • 要邀請其他測試人員或從您的 Firebase 項目中刪除現有測試人員：

     ./gradlew appDistributionAddTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     ./gradlew appDistributionRemoveTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     

     將測試人員添加到您的 Firebase 項目後，您可以將他們添加到單獨的版本中。被移除的測試人員將無法再訪問您項目中的發布，但可能仍會在一段時間內保留對您的發布的訪問權限。

   您還可以使用--file="/path/to/testers.txt"而不是--emails指定測試人員。

   appDistributionAddTesters和appDistributionRemoveTesters任務也接受以下參數：

   • projectNumber ：您的 Firebase 項目編號。

   • serviceCredentialsFile ：您的 Google 服務憑證文件的路徑。這與上傳操作使用的參數相同。

Gradle 插件在發布上傳後輸出以下鏈接。這些鏈接可幫助您管理二進製文件並確保測試人員和其他開發人員擁有正確的版本：

• firebase_console_uri - 指向顯示單個版本的 Firebase 控制台的鏈接。您可以與您組織中的其他開發人員共享此鏈接。
• testing_uri - 測試人員體驗（​​Android 本機應用程序）中發布的鏈接，可讓測試人員查看發布說明並將應用程序安裝到他們的設備上。測試人員需要訪問版本才能使用該鏈接。
• binary_download_uri - 直接下載和安裝應用程序二進製文件（APK 或 AAB 文件）的簽名鏈接。該鏈接將在一小時後過期。

分發構建後，它會在 Firebase 控制台的 App Distribution 儀表板中可用 150 天（五個月）。當構建距離到期還有 30 天時，控制台和測試人員在其測試設備上的構建列表中都會顯示到期通知。

未受邀測試應用程序的測試人員會收到開始測試的電子郵件邀請，而現有測試人員會收到新版本已準備好進行測試的電子郵件通知（閱讀測試人員設置指南，了解有關如何安裝測試應用程序的說明）。您可以在 Firebase 控制台中監控每個測試人員的狀態——他們是否接受了邀請以及是否下載了應用程序。

測試人員有 30 天的時間接受邀請，在邀請到期前測試該應用。當邀請還有 5 天到期時，Firebase 控制台中發布的測試人員旁邊會顯示到期通知。可以通過使用測試人員行上的下拉菜單重新發送邀請來續訂邀請。

下一步

• 實施應用內反饋，使測試人員可以輕鬆發送有關您的應用的反饋（包括屏幕截圖）。

• 了解如何在您的應用程序的新版本可供安裝時向您的測試人員顯示應用程序內提醒。

• 訪問Android App Bundle 代碼實驗室，了解如何逐步分發 App Bundle 版本。

• 了解使用 CI/CD 將 Android 應用分發給 QA 測試人員的最佳實踐。