通知測試人員新版本

選用的 Firebase App Distribution iOS 和 Android SDK 在您的應用程式有新版本可供下載時，向測試人員傳送應用程式內快訊 安裝。本指南說明如何使用 App Distribution iOS 和 Android SDK 建立及自訂新的版本快訊給測試人員。

事前準備

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

步驟 1：啟用 App Distribution Tester API

1. 請在 Google Cloud 控制台。

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

步驟 2：在應用程式中新增 App Distribution

1. 開啟您為專案建立的 Podfile (或執行 pod init 來建立專案) one)，然後在目標區段中新增下列程式碼：

   pod 'FirebaseAppDistribution'

2. 在 Podfile 目錄中執行 pod install，然後開啟 已建立 .xcworkspace 個檔案。

3. 將 Firebase 模組匯入 App 結構或 UIApplicationDelegate：

   Swift

   import FirebaseCore
   import FirebaseAppDistribution
   

   Objective-C

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

4. 在應用程式委派項目中設定 FirebaseApp 共用例項 application(_:didFinishLaunchingWithOptions:) 方法：

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()
   

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];
   

5. 如果已停用滑動檢查功能，請將所有開啟的網址傳遞至 App Distribution SDK，方法如下： 您實作 application(_:open:options:) 的方法：

   Swift

   func application(_ app: UIApplication, 
                    open url: URL,
                    options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
      if AppDistribution.appDistribution().application(application, open: url, options: options) {
         return true
      }
   
      // Handle other non-Firebase URLs here.
   
      return false
   }
   

   Objective-C

   - (BOOL)application:(UIApplication *)app 
               openURL:(NSURL *)url 
               options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
      if ([[FIRAppDistribution appDistribution] application:app openURL:url options:options]) {
         return YES;
      }
   
      // Handle other non-Firebase URLs here.
   
      return NO;
   }
   

6. 最後，重新編譯應用程式。

步驟 3：設定應用程式內快訊

App Distribution SDK 提供兩種設定應用程式內建構快訊的方式： 您的測試人員：這是基本的快訊設定，隨附預先建構的應用程式更新 和登入對話方塊 (向測試人員顯示) 以及進階快訊 即可自訂使用者介面。三 建議您先使用基本快訊設定 App Distribution SDK。

基本設定

使用 checkForUpdate 顯示預先建立的啟用快訊對話方塊， 再檢查新版本 廣告。呼叫此方法時，會執行以下序列：

1. 提示測試人員登入帳戶，檢查是否已啟用快訊功能 App Distribution使用自己的 Google 帳戶。

2. 如果測試人員尚未啟用快訊，系統會顯示預先建構的對話方塊。

   快訊功能在測試裝置上只需啟用一次，將持續到 應用程式的更新測試裝置上的快訊會保持啟用狀態，直到 解除安裝應用程式，或直到呼叫 signOutTester 方法為止。 請參閱該方法的參考說明文件 (Swift 或 Objective-C) 瞭解詳情

3. 檢查可供測試人員安裝的新版本。

您隨時可以在應用程式中叫用 checkForUpdate()。舉例來說， 可讓測試人員在啟動時安裝新可用的版本，方法是 在應用程式根目錄的 onAppear(perform:) 中加入 checkForUpdate() 檢視畫面。

下列範例會檢查測試人員是否已啟用快訊 且可存取新建構作業，如果是的話，會在觸發 可用的版本：

AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
  if error != nil {
      // Handle error
      return
  }

  guard let release = release else {
    return
  }

  // Customize your alerts here.
  let title = "New Version Available"
  let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
  let uialert = UIAlertController(title: title,message: message, preferredStyle: .alert)

  uialert.addAction(UIAlertAction(title: "Update", style: UIAlertAction.Style.default) {
    _ in
    UIApplication.shared.open(release.downloadURL)
  })
  uialert.addAction(UIAlertAction(title: "Cancel", style: UIAlertAction.Style.cancel) {
    _ in
  })

  // self should be a UIViewController.
  self.present(uialert, animated: true, completion: nil)
})

[[FIRAppDistribution appDistribution]
  checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                 NSError *_Nullable error) {
  if (error) {
    // Handle error
    return;
  }

  if (release) {
    UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"New Version Available"
message:[NSString stringWithFormat:@"Version %@ (%@) is available.", release.displayVersion,
release.buildVersion] preferredStyle:UIAlertControllerStyleAlert];

    UIAlertAction *updateAction = [UIAlertAction actionWithTitle:@"Update"
style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
      [[UIApplication sharedApplication] openURL:release.downloadURL options:@{}
completionHandler:nil];
    }];
    UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:@"Cancel"
style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {}];
    [alert addAction:updateAction];
    [alert addAction:cancelAction];
    [self presentViewController:alert animated:YES completion:nil];
  }
}];

進階設定

signInTester() 和 isTesterSignedIn 方法讓你更有彈性 自訂測試人員的登入體驗，使其更符合 外觀和風格

下列範例會檢查測試人員是否已登入 Firebase App Distribution 測試人員帳戶，你可以選擇顯示 登入使用者介面。測試人員 登入後，您就能呼叫 checkForUpdate() 檢查測試人員是否已 取得新建構作業的存取權

// Sign in a tester without automatically checking for update
if (!AppDistribution.appDistribution().isTesterSignedIn) {
  AppDistribution.appDistribution().signInTester (completion: { error in
    // completion block for signInTester
     if (error != nil) {
       // handle failed sign in
      return
     }
    // handle successful sign in
  })
}

// Only check for update if tester is already signed in - do not prompt
if (AppDistribution.appDistribution().isTesterSignedIn) {
  AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
      // completion block for check for update
  })
}

// Sign in a tester without automatically checking for update
if(![[FIRAppDistribution appDistribution] isTesterSignedIn]) {
  [[FIRAppDistribution appDistribution]
    signInTesterWithCompletion:^(NSError *_Nullable error) {
      // completion block for signInTester
     if (error) {
       // handle failed sign in
       return;
     }
      // handle successful sign in
  }];
}

// only check for update if tester is already signed in - do not prompt
if([[FIRAppDistribution appDistribution] isTesterSignedIn]) {
  [[FIRAppDistribution appDistribution]
        checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                       NSError *_Nullable error) {
     // completion block for check for update
  }];
}

如要進一步瞭解其他方法，包括 signOutTester()， 請參閱 App Distribution 的參考說明文件 Swift 和 Objective-C 即可。

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

最後，請建構應用程式並測試導入作業，方法是 在 Android Vitals 中 提供給測試人員，請使用 Firebase 控制台。

請造訪 App Distribution 疑難排解指南 以取得常見問題的說明，例如：

• 測試人員沒有收到應用程式內快訊
• 系統多次提示測試人員登入 Google