Bắt đầu với Cấu hình từ xa Firebase

Bạn có thể sử dụng Cấu hình từ xa Firebase để xác định các tham số trong ứng dụng của mình và cập nhật giá trị của chúng trên đám mây, cho phép bạn sửa đổi giao diện và hoạt động của ứng dụng mà không cần phân phối bản cập nhật ứng dụng.

Thư viện Cấu hình từ xa được dùng để lưu trữ các giá trị tham số mặc định trong ứng dụng, tìm nạp các giá trị tham số được cập nhật từ phần phụ trợ Cấu hình từ xa và kiểm soát thời điểm cung cấp các giá trị được tìm nạp cho ứng dụng của bạn. Để tìm hiểu thêm, hãy xem Chiến lược tải cấu hình từ xa .

Bước 1: Thêm Firebase vào ứng dụng của bạn

Trước khi có thể sử dụng Remote Config , bạn cần:

• Đăng ký dự án C++ của bạn và định cấu hình nó để sử dụng Firebase.

  Nếu dự án C++ của bạn đã sử dụng Firebase thì dự án đó đã được đăng ký và định cấu hình cho Firebase.

• Thêm SDK Firebase C++ vào dự án C++ của bạn.

Lưu ý rằng việc thêm Firebase vào dự án C++ của bạn bao gồm các tác vụ cả trong bảng điều khiển Firebase và trong dự án C++ mở của bạn (ví dụ: bạn tải xuống tệp cấu hình Firebase từ bảng điều khiển, sau đó chuyển chúng vào dự án C++ của bạn).

Bước 2: Thêm cấu hình từ xa vào ứng dụng của bạn

Bước 3: Đặt giá trị tham số mặc định trong ứng dụng

Bạn có thể đặt các giá trị tham số mặc định trong ứng dụng trong đối tượng Cấu hình từ xa để ứng dụng của bạn hoạt động như dự định trước khi kết nối với phần phụ trợ Cấu hình từ xa và để các giá trị mặc định khả dụng nếu không có giá trị nào được đặt trên phần phụ trợ.

1. Xác định một tập hợp các tên tham số và các giá trị tham số mặc định bằng cách sử dụng đối tượng std::map<const char*, const char*> hoặc đối tượng std::map<const char*, firebase::Variant> .

   • Tìm hiểu về firebase::Variant .

   Nếu đã định cấu hình các giá trị tham số phụ trợ Cấu hình từ xa, bạn có thể tải xuống tệp chứa các cặp khóa/giá trị này và sử dụng tệp đó để xây dựng đối tượng map của mình. Để biết thêm thông tin, hãy xem Tải xuống mặc định mẫu Cấu hình từ xa .

2. Thêm các giá trị này vào đối tượng Remote Config bằng SetDefaults() .

Bước 4: Nhận các giá trị tham số để sử dụng trong ứng dụng của bạn

Bây giờ bạn có thể nhận các giá trị tham số từ đối tượng Remote Config. Nếu bạn đặt các giá trị trong phần phụ trợ Cấu hình từ xa, tìm nạp chúng rồi kích hoạt chúng thì những giá trị đó sẽ có sẵn cho ứng dụng của bạn. Nếu không, bạn sẽ nhận được các giá trị tham số trong ứng dụng được định cấu hình bằng SetDefaults() .

Để có được những giá trị này, hãy gọi phương thức được liệt kê bên dưới để ánh xạ tới loại dữ liệu mà ứng dụng của bạn mong đợi, cung cấp khóa tham số làm đối số:

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

Bước 5: Kết nối ứng dụng của bạn trong bảng điều khiển Firebase

Trong bảng điều khiển Firebase , hãy thêm ứng dụng của bạn vào dự án Firebase.

Bước 6: Đặt giá trị tham số

1. Trong bảng điều khiển Firebase , hãy mở dự án của bạn.
2. Chọn Cấu hình từ xa từ menu để xem bảng thông tin Cấu hình từ xa.
3. Xác định các tham số có cùng tên với các tham số mà bạn đã xác định trong ứng dụng của mình. For each parameter, you can set a default value (which will eventually override the in-app default value) and conditional values. To learn more, see Remote Config parameters and conditions .

Step 7: Fetch and activate values

1. To fetch parameter values from the Remote Config backend, call the Fetch() method. Any values that you set on the backend are fetched and cached in the Remote Config object.
2. To make fetched parameter values available to your app, call the ActivateFetched()

Step 8: Listen for updates in real time

After you fetch parameter values, you can use real-time Remote Config to listen for updates from the Remote Config backend. Real-time Remote Config signals to connected devices when updates are available and automatically fetches the changes after you publish a new Remote Config version.

Real-time updates are supported by the Firebase C++ SDK v11.0.0+ and higher for Android and Apple platforms.

1. In your app, call AddOnConfigUpdateListener to start listening for updates and automatically fetch any new or updated parameter values. The following example listens for updates and, when Activate is called, uses the newly fetched values to display an updated welcome message.

remote_config->AddOnConfigUpdateListener(
    [](firebase::remote_config::ConfigUpdate&& config_update,
       firebase::remote_config::RemoteConfigError remote_config_error) {
      if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) {
        printf("Error listening for config updates: %d", remote_config_error);
      }
      // Search the `updated_keys` set for the key "welcome_message."
      // `updated_keys` represents the keys that have changed since the last
      // fetch.
      if (std::find(config_update.updated_keys.begin(),
                    config_update.updated_keys.end(),
                    "welcome_message") != config_update.updated_keys.end()) {
        remote_config->Activate().OnCompletion(
            [&](const firebase::Future& completed_future,
               void* user_data) {
              // The key "welcome_message" was found within `updated_keys` and
              // can be activated.
              if (completed_future.error() == 0) {
                DisplayWelcomeMessage();
              } else {
                printf("Error activating config: %d", completed_future.error());
              }
            },
            nullptr);
      }
    });

The next time you publish a new version of your Remote Config, devices that are running your app and listening for changes will call the config update listener.

Next steps

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including:

• Manage Remote Config template versions
• Config loading strategies