收集測試人員的意見回饋

Firebase App Distribution Android SDK 是一種 Beta 版。這表示功能可能會在 回溯不相容的方法Beta 版不適用於任何服務水準協議，或 廢止政策，且可能部分或不提供支援服務。

本指南說明如何使用自選項目啟用應用程式內意見回饋功能 Firebase App Distribution Android SDK，以便測試人員提交意見回饋 (包括螢幕截圖)。

事前準備

如果您尚未將 Firebase 新增至 Android 專案，請先完成這項操作。

注意： 如果您的 Firebase 專案中有多個應用程式，請確認應用程式 檔案發布時，已有「App Distribution」專屬的 google-services.json 設定檔。若需更多資訊，請參閲 支援多個環境。

步驟 1：啟用 App Distribution Tester API

1. 開啟 Google Cloud 控制台。 然後選取 Firebase 專案

2. 按一下 Firebase App Testers API 下方的「啟用」。

步驟 2：將 App Distribution 新增至應用程式

App Distribution Android SDK 包含兩個程式庫：

• firebase-appdistribution-api：僅限 API 的程式庫，可納入 在所有建構變數中定義。
• firebase-appdistribution：完整的 SDK 實作 (選用)。

，瞭解如何調查及移除這項存取權。

注意： 如要支援功能，例如通知測試人員新版本， 完整的 App Distribution Android SDK 導入項目包含自行更新 可能會視為違反 Google Play 政策， 即使該程式碼並非在執行階段執行將應用程式提交給 Google 如未移除完整 SDK 導入項目，可能使應用程式 並從 Google Play 下架

僅限 API 的程式庫可讓程式碼呼叫 SDK。這些通話 如果沒有完整的 SDK 實作，則不會產生任何影響。

1. 宣告 App Distribution Android SDK 的依附元件 module (應用程式層級) Gradle 檔案 (通常為 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle)。

2. 為了避免包含完整 SDK 導入的自我更新功能 找出建構變數，包括 建構類型 或變種版本 將透過 App Distribution發布。

3. 宣告 App Distribution Android SDK 的依附元件 模組 (應用程式層級) Gradle 檔案 (通常為 app/build.gradle)。只在 將完整的 SDK 導入到 預先發布版測試：

   Kotlin+KTX

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta13")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13")
   }
   

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta13")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13")
   }
   

步驟 3：設定應用程式內意見回饋

如要收集測試人員的意見回饋，請將下列任一觸發條件設為 開放測試人員提供意見回饋：

• 內建通知觸發條件： App Distribution Android SDK 可顯示持續性通知， 測試人員可輕觸應用程式中的任一處。如要 且不需要自訂測試人員的方式 提供意見回饋。

• 自訂觸發條件：您可以自行提供觸發條件 例如輕觸應用程式中的按鈕或選單項目，或是搖動 裝置。

使用這些觸發條件且測試人員提交意見回饋時， Android SDK 會執行下列動作：

1. 擷取應用程式目前活動的螢幕截圖。

2. 執行檢查，確保測試人員已啟用 SDK 的測試功能。如果 未啟用測試功能，Android SDK 會提示測試人員簽署 透過個人 Google 帳戶在「App Distribution」中登入。

   注意： 測試功能在測試裝置上啟用是一次性程序。 並且持續更新到應用程式各更新之間測試功能維持不變 在測試裝置上啟用，直到測試人員解除安裝應用程式或 直到應用程式呼叫 signOutTester 方法為止。

3. 啟動一個全螢幕活動，讓測試人員編寫並提交 提供意見回饋。

選項 1：通知觸發條件

使用 showFeedbackNotification() 顯示永久或 持續進行 通知，讓使用者輕觸即可啟動意見回饋。 設定通知時，您必須提供 向測試人員提交意見回饋時顯示， 通知中斷 (對應通知管道的重要性)。如果您想 通知測試人員的 意見回饋資料，您可以使用該文字提供這類通知。

使用 showFeedbackNotification() 以及當應用程式前往 時，系統會隱藏通知。如要明確隱藏 請使用 cancelFeedbackNotification() 傳送通知。建議您 在主要活動的 onCreate() 中加入 showFeedbackNotification()。

Kotlin+KTX

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

注意： 在 Android 13 以上版本中，這個方法需要用到 傳送通知的執行階段權限：POST_NOTIFICATIONS。如果應用程式指定 Android 13 (API 級別 33) 或更高層級，您必須宣告權限，然後 在執行階段提出要求。

方法 2：自訂觸發條件

使用 startFeedback() 方法，即可透過 就是用哪一種烤箱或刀子都可以 那麼預先建構的容器或許是最佳選擇舉例來說，如要觸發意見回饋，可以 「提供意見」將選單項目加入應用程式動作選單 搖動裝置 或拍攝螢幕截圖。 觸發意見回饋時，請提供一些要向測試人員顯示的文字 瞭解使用者如何提交意見回饋如何通知測試人員 有關收集和處理他們的意見回饋資料，您可以使用這段文字 提供這類通知

Kotlin+KTX

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

步驟 4：建構並測試實作成果

本機測試

如果想在不發布應用程式的情況下測試實作結果， 步驟如下：

1. 在本機裝置上啟用開發人員模式：

   adb shell setprop debug.firebase.appdistro.devmode true
   

2. 將應用程式建構為含有完整 App Distribution 的預先發布版變化版本 程式庫，以及測試您是否可以透過機制觸發意見回饋 套用於 步驟 3：設定應用程式內意見回饋。意見回饋為 未提交要求。

3. 測試完畢後，您可以停用裝置上的開發人員模式：

   adb shell setprop debug.firebase.appdistro.devmode false
   

端對端測試

注意： 根據預設，新意見回饋會觸發所有使用者電子郵件和控制台內快訊 Firebase 專案擁有者和編輯者。

如要測試應用程式能否傳送意見回饋，請發布預先發布版應用程式 且包含完整的 App Distribution 程式庫的變化版本，並測試 導入步驟如下：

1. 將新的應用程式版本上傳至 App Distribution。

2. 將應用程式版本發行到您有權存取的帳戶。

3. 透過「App Distribution」的網頁或 Android 測試人員應用程式下載應用程式。

4. 透過 步驟 3：設定應用程式內意見回饋。

5. 請確認您登入的帳戶與您發行 發布及提交意見回饋

6. 前往新版本資訊卡，即可查看您的意見 Firebase 控制台。

，瞭解如何調查及移除這項存取權。

注意： 在 Google Play 商店發布應用程式前，請務必進行測試 應用程式，以確認您只納入僅限 API 的程式庫依附元件。 而且發布變化版本並未包含意見回饋機制 詳情請參閱「步驟 2：在應用程式中新增 App Distribution」。

瞭解如何解決常見問題 (例如測試人員無法開始意見回饋) 請參閱啟用 SDK 的測試功能。

步驟 5：管理測試人員的意見回饋

開放測試人員提供意見後，您就能使用下列功能 查看意見回饋並採取相關行動：

• Firebase 控制台

• 新意見回饋的電子郵件快訊

• 第三方工具

在 Firebase 控制台中查看及刪除意見回饋

你可以查看及刪除使用者意見回饋，包括 擷取螢幕畫面，方法是開啟特定版本下方的「測試人員意見回饋」分頁 Firebase 控制台。使用者意見回饋會按發布版本列出，方便你確認 意見回饋適用的版本

查看使用者意見回饋後，你可以按一下意見回饋圖示，刪除 「刪除意見回饋」按鈕。刪除的意見回饋會從 版本。

接收新意見回饋的電子郵件快訊

如要主動瞭解新的測試人員意見回饋，可以透過電子郵件 會在測試人員提交意見時收到快訊電子郵件快訊包括 測試人員提供的意見回饋，以及他們提交的螢幕截圖連結。

如要使用這個預設機制接收 App Distribution 電子郵件快訊，您必須 firebase.projects.update 權限。以下角色包括 預設必要權限：Firebase 管理員 或專案擁有者或編輯者。

根據預設，所有具備必要權限的專案成員都必須具備接收權限 有人提交新的意見回饋報告時，電子郵件快訊就會收到電子郵件快訊。 專案成員可個別選擇不接收這類快訊。

如要停用電子郵件快訊，請參閱「接收 Firebase 快訊」。

向第三方工具傳送新意見回饋

你也可以傳送 App Distribution 快訊，至團隊偏好的通知 使用 Cloud Functions for Firebase 管理頻道。例如，您可以用 這個函式會擷取應用程式內新意見回饋的快訊事件，並將 快訊資訊給第三方服務，例如 Discord、Slack 或 Jira。

注意： 如要使用進階快訊功能，您的 Firebase 專案必須使用 Blaze 定價方案。

如要使用 Cloud Functions for Firebase 設定進階快訊功能， 步驟如下：

1. 設定 Cloud Functions for Firebase、 其中包括下列工作：

   1. 下載 Node.js 和 npm。

   2. 安裝並登入 Firebase CLI。

   3. 使用 Firebase CLI 將 Cloud Functions for Firebase 初始化。

2. 編寫及部署函式 從 App Distribution 擷取應用程式內意見回饋快訊事件，並處理 將警示資訊張貼在 Discord)。

如要查看示範如何傳送新意見回饋給 Jira 的函式範例， 請參閱這個範例。

如要瞭解您可以擷取的所有警示事件，請參閱參考資源 App Distribution 快訊的說明文件。