Thông báo cho người kiểm thử về bản dựng mới


Các SDK iOS và Android Firebase App Distribution (không bắt buộc) cho phép bạn hiển thị thông báo trong ứng dụng cho người kiểm thử khi có bản dựng mới của ứng dụng cài đặt. Hướng dẫn này giải thích cách sử dụng App Distribution SDK iOS và Android để tạo và tuỳ chỉnh thông báo về bản dựng mới cho người kiểm thử.

Trước khi bắt đầu

Thêm Firebase vào dự án iOS của bạn nếu bạn chưa thêm.

Bước 1: Bật API Người kiểm tra App Distribution

  1. Chọn dự án của bạn trong Bảng điều khiển Google Cloud.

  2. Trong API Người kiểm tra ứng dụng Firebase, hãy nhấp vào Bật.

Bước 2: Thêm App Distribution vào ứng dụng

  1. Mở Podfile mà bạn đã tạo cho dự án (hoặc chạy pod init để tạo một), sau đó thêm dòng sau bên trong phần mục tiêu:

    pod 'FirebaseAppDistribution'
  2. Trong thư mục của tệp podfile, hãy chạy pod install, sau đó mở đã tạo tệp .xcworkspace.

  3. Nhập mô-đun Firebase trong cấu trúc App hoặc UIApplicationDelegate:

    Swift

    import FirebaseCore
    import FirebaseAppDistribution
    

    Objective-C

    @import FirebaseCore;
    @import FirebaseAppDistribution;
    
  4. Định cấu hình một thực thể dùng chung của FirebaseApp trong thực thể uỷ quyền của ứng dụng Phương thức application(_:didFinishLaunchingWithOptions:):

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  5. Nếu tính năng xoáy vòng bị tắt, hãy truyền mọi URL đã mở đến SDK App Distribution trong việc triển khai application(_:open:options:) của bạn:

    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. Cuối cùng, biên dịch lại ứng dụng của bạn.

Bước 3: Định cấu hình cảnh báo trong ứng dụng

SDK App Distribution cung cấp 2 cách để thiết lập cảnh báo bản dựng trong ứng dụng cho người kiểm thử: cấu hình thông báo cơ bản đi kèm với bản cập nhật ứng dụng được tạo sẵn và hộp thoại đăng nhập để hiển thị cho người kiểm thử cùng một cảnh báo nâng cao , cho phép bạn tuỳ chỉnh giao diện người dùng của riêng mình. T4 trước tiên, bạn nên sử dụng cấu hình cảnh báo cơ bản nếu mới sử dụng SDK App Distribution.

Cấu hình cơ bản

Dùng checkForUpdate để hiện hộp thoại bật cảnh báo được tạo sẵn những người kiểm thử chưa bật cảnh báo, sau đó kiểm tra xem bản dựng mới có sẵn có. Khi được gọi, phương thức này sẽ thực thi trình tự sau đây:

  1. Kiểm tra xem người kiểm thử đã bật thông báo hay chưa bằng cách nhắc họ đăng nhập App Distribution bằng Tài khoản Google của mình.

  2. Nếu người kiểm thử chưa bật cảnh báo, hãy hiện một hộp thoại được tạo sẵn.

    Bật cảnh báo là quy trình một lần trên thiết bị thử nghiệm và sẽ duy trì trên các bản cập nhật ứng dụng của bạn. Cảnh báo vẫn bật trên thiết bị thử nghiệm cho đến ứng dụng bị gỡ cài đặt hoặc cho đến khi phương thức signOutTester được gọi. Hãy xem tài liệu tham khảo về phương thức này (Swift hoặc Target-C) để biết thêm thông tin.

  3. Kiểm tra các bản dựng mới có để người kiểm thử cài đặt.

Bạn có thể gọi checkForUpdate() bất cứ lúc nào trong ứng dụng. Ví dụ: bạn có thể nhắc người kiểm thử cài đặt bản dựng mới có sẵn khi khởi động bằng cách bao gồm checkForUpdate() trong onAppear(perform:) thư mục gốc của ứng dụng chế độ xem.

Ví dụ sau đây kiểm tra xem người kiểm thử đã bật cảnh báo hay chưa và có quyền truy cập vào một bản dựng mới và nếu có, sẽ hiển thị một hộp thoại khi bản dựng có sẵn để cài đặt:

Swift

Lưu ý: Sản phẩm này không dành cho các mục tiêu macOS, Mac Catalyst, tvOS hoặc watchOS.
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)
})

Objective-C

Lưu ý: Sản phẩm này không dành cho các mục tiêu macOS, Mac Catalyst, tvOS hoặc watchOS.
[[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];
  }
}];

Cấu hình nâng cao

Các phương thức signInTester()isTesterSignedIn giúp bạn linh hoạt hơn tuỳ chỉnh trải nghiệm đăng nhập của người kiểm thử để có thể phù hợp hơn với giao diện của ứng dụng.

Ví dụ sau đây sẽ kiểm tra xem người kiểm thử đã đăng nhập vào Firebase App Distribution tài khoản người kiểm thử, nên bạn có thể chọn hiển thị giao diện người dùng đăng nhập chỉ dành cho người kiểm thử chưa đăng nhập. Sau khi người kiểm thử đã đăng nhập, sau đó bạn có thể gọi checkForUpdate() để kiểm tra xem người kiểm thử đã quyền truy cập vào một bản dựng mới.

Swift

Lưu ý: Sản phẩm này không dành cho các mục tiêu macOS, Mac Catalyst, tvOS hoặc watchOS.
// 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
  })
}

Objective-C

Lưu ý: Sản phẩm này không dành cho các mục tiêu macOS, Mac Catalyst, tvOS hoặc watchOS.
// 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
  }];
}

Để biết thông tin về các phương thức khác, bao gồm signOutTester(), hãy xem tài liệu tham khảo App Distribution để SwiftTarget-C.

Bước 4: Xây dựng và thử nghiệm phương thức triển khai

Cuối cùng, hãy tạo ứng dụng và kiểm thử việc triển khai bằng cách phân phối bản dựng cho người kiểm thử thông qua bảng điều khiển Firebase.

Truy cập vào App Distribution Hướng dẫn khắc phục sự cố để được trợ giúp về các vấn đề thường gặp, chẳng hạn như:

  • Người kiểm thử không nhận được cảnh báo trong ứng dụng
  • Người thử nghiệm được nhắc đăng nhập vào Google nhiều lần