收集測試人員的意見回饋

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

事前準備

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

步驟 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 實作 (選用)。
,瞭解如何調查及移除這項存取權。

僅限 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」中登入。

  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);
    }
}

方法 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
    

端對端測試

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

如要使用 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 快訊的說明文件。