Khi sử dụng mẫu lời nhắc trên máy chủ, bạn có thể cập nhật các giá trị trong một mẫu nhất định mà không cần phát hành phiên bản mới của ứng dụng. Tuy nhiên, vì mọi thay đổi đối với mẫu sẽ được các yêu cầu từ ứng dụng của bạn sử dụng gần như ngay lập tức, nên bạn cần thận trọng khi thực hiện những thay đổi có thể làm hỏng ứng dụng hoặc gây ra những thay đổi không mong muốn về hành vi.
Vì vậy, nếu muốn thực hiện những thay đổi đáng kể hơn hoặc triển khai dần các thay đổi, thì bạn không nên thay đổi mẫu được dùng trong mã sản xuất.
Thay vào đó, bạn nên sử dụng Firebase Remote Config để kiểm soát giá trị của mã mẫu được dùng trong yêu cầu đối với mô hình.
Firebase Remote Config cho phép bạn cập nhật các giá trị tham số trong ứng dụng (chẳng hạn như mã nhận dạng mẫu) một cách linh động và từ xa thông qua bảng điều khiển Firebase mà không cần phát hành phiên bản mới của ứng dụng. Tính năng này cũng có các khả năng và hoạt động tích hợp tinh giản để triển khai các thay đổi cũng như kiểm thử A/B.
Hướng dẫn này mô tả cách triển khai Remote Config trong ứng dụng của bạn, cụ thể là để kiểm soát mã nhận dạng mẫu được dùng trong ứng dụng.
Bước 1: Đặt giá trị tham số trong bảng điều khiển Firebase
Tạo một mẫu Remote Configmáy khách và định cấu hình một tham số template_id cùng giá trị của tham số đó để tìm nạp và sử dụng trong ứng dụng.
Mở dự án Firebase của bạn trong bảng điều khiển Firebase. Sau đó, trong trình đơn điều hướng, hãy mở rộng mục Chạy rồi chọn Remote Config.
Đảm bảo rằng bạn đã chọn Client (Máy khách) trong bộ chọn Client/Server (Máy khách/Máy chủ) ở đầu trang.
Bắt đầu một mẫu khách hàng bằng cách nhấp vào Tạo cấu hình (hoặc Thêm thông số nếu trước đây bạn đã sử dụng mẫu khách hàng).
Xác định tham số
template_id:Tên thông số Mô tả Loại Giá trị mặc định template_idMã mẫu. Chuỗi my-first-template-v1-0-0Sau khi thêm thông số này, hãy nhấp vào Xuất bản thay đổi. Nếu đây không phải là mẫu Remote Config mới, hãy xem xét các thay đổi rồi nhấp lại vào Xuất bản thay đổi.
Bước 2: Thêm và khởi tạo Remote Config trong ứng dụng của bạn
Thêm thư viện Remote Config và thiết lập Remote Config trong ứng dụng của bạn.
Swift
Trong quá trình thiết lập Firebase AI Logic, bạn đã thêm SDK Firebase vào ứng dụng của mình, nhưng cũng cần thêm Remote Config.
Trong Xcode, khi dự án đang mở, hãy chuyển đến File > Add Package Dependencies (Tệp > Thêm phần phụ thuộc của gói).
Chọn firebase-ios-sdk rồi nhấp vào Add package (Thêm gói).
Trong Project navigator (Trình điều hướng dự án), hãy chọn ứng dụng của bạn > Targets (Mục tiêu) > ứng dụng của bạn.
Trong thẻ Chung, hãy di chuyển đến phần Framework, Thư viện và Nội dung được nhúng.
Nhấp vào + rồi chọn FirebaseRemoteConfig, sau đó nhấp vào Add (Thêm).
Thêm lệnh nhập
FirebaseRemoteConfigvào mã của bạn:import FirebaseRemoteConfigTrong lớp thích hợp cho ứng dụng của bạn, hãy khởi động Firebase và thêm Remote Config vào logic ứng dụng chính.
Tại đây, bạn sẽ thêm Remote Config và trình nghe theo thời gian thực Remote Config làm các mục nhập để ứng dụng có thể tìm nạp các giá trị mới theo thời gian thực và thêm khoảng thời gian tìm nạp tối thiểu:
let remoteConfig = RemoteConfig.remoteConfig() let settings = RemoteConfigSettings() settings.minimumFetchInterval = 3600 remoteConfig.configSettings = settings
Kotlin
Thêm phần phụ thuộc Remote Config vào tệp Gradle (cấp ứng dụng) của mô-đun (thường là
app/build.gradle.ktshoặcapp/build.gradle):dependencies { implementation(platform("com.google.firebase:firebase-bom:34.5.0")) implementation("com.google.firebase:firebase-ai") implementation("com.google.firebase:firebase-config") // ... other dependencies }Thêm Remote Config vào logic ứng dụng chính của bạn. Tại đây, bạn sẽ khởi động Remote Config và thêm khoảng thời gian tìm nạp tối thiểu:
val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig val configSettings = remoteConfigSettings { minimumFetchIntervalInSeconds = 3600 } remoteConfig.setConfigSettingsAsync(configSettings)
Java
Thêm phần phụ thuộc Remote Config vào tệp Gradle (cấp ứng dụng) của mô-đun (thường là
app/build.gradle.ktshoặcapp/build.gradle):dependencies { implementation(platform("com.google.firebase:firebase-bom:34.5.0")) implementation("com.google.firebase:firebase-ai") implementation("com.google.firebase:firebase-config") // ... other dependencies }Thêm Remote Config vào logic ứng dụng chính của bạn. Tại đây, bạn sẽ khởi động Remote Config và thêm khoảng thời gian tìm nạp tối thiểu:
FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance(); FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder() .setMinimumFetchIntervalInSeconds(3600) .build(); mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);
Web
Mở mã của bạn trong một trình chỉnh sửa văn bản và nhập Remote Config:
import { getRemoteConfig } from 'firebase/remote-config';Trong hàm chính và sau khi ứng dụng Firebase được khởi chạy cho SDK Firebase AI Logic, hãy khởi chạy Remote Config:
// Initialize Remote Config and get a reference to the service const remoteConfig = getRemoteConfig(app);Đặt khoảng thời gian tìm nạp tối thiểu:
remoteConfig.settings.minimumFetchIntervalMillis = 3600000;
Bước 3: Đặt giá trị tham số trong ứng dụng
Bạn nên đặt các giá trị tham số mặc định trong ứng dụng trong đối tượng Remote Config. Điều này đảm bảo ứng dụng của bạn hoạt động như mong đợi ngay cả khi không thể tìm nạp các giá trị từ dịch vụ Remote Config.
Swift
Trong bảng điều khiển Firebase, hãy mở Remote Config.
Trong thẻ Parameters (Tham số), hãy mở Menu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
Khi được nhắc, hãy bật .plist cho iOS, rồi nhấp vào Tải tệp xuống.
Lưu tệp trong thư mục ứng dụng của bạn.
Trong Xcode, hãy nhấp chuột phải vào ứng dụng của bạn rồi chọn Add Files (Thêm tệp)
Chọn remote_config_defaults.plist, rồi nhấp vào Thêm.
Cập nhật mã ứng dụng để tham chiếu đến tệp mặc định:
// Set default values for Remote Config parameters. remoteConfig.setDefaults(fromPlist: "remote_config_defaults")
Kotlin
Trên bảng điều khiển Firebase, hãy mở Remote Config.
Trong thẻ Parameters (Tham số), hãy mở Menu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
Khi được nhắc, hãy bật .xml cho Android, rồi nhấp vào Tải tệp xuống.
Lưu tệp này trong thư mục tài nguyên XML của ứng dụng.
Cập nhật tệp hoạt động chính để thêm các giá trị mặc định sau
configSettingsmà bạn đã thêm trước đó:// Set default values for Remote Config parameters. remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)
Java
Trong bảng điều khiển Firebase, hãy mở Remote Config.
Trong thẻ Parameters (Tham số), hãy mở Menu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
Khi được nhắc, hãy bật .xml cho Android, rồi nhấp vào Tải tệp xuống.
Lưu tệp này trong thư mục tài nguyên XML của ứng dụng.
Cập nhật tệp hoạt động chính để thêm các giá trị mặc định sau
configSettingsmà bạn đã thêm trước đó:// Set default values for Remote Config parameters. mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);
Web
Bạn có thể đặt giá trị mặc định cho tên mô hình ngay trong mã của mình:
// Set default values for Remote Config parameters.
remoteConfig.defaultConfig = {
template_id: 'my-first-template-v1-0-0',
};
Bước 4: Tìm nạp và kích hoạt giá trị
Sau khi đặt giá trị mặc định cho tên mô hình, hãy thêm nội dung sau để tìm nạp và kích hoạt các giá trị.
Swift
// Fetch and activate Remote Config values
remoteConfig.fetchAndActivate { status, error in
if let error = error {
print("Error fetching Remote Config: \(error.localizedDescription)")
}
}
Thao tác này sẽ cập nhật đối tượng Remote Config bất cứ khi nào một mẫu Remote Config mới được xuất bản.
Kotlin
// Fetch and activate Remote Config values
remoteConfig.fetchAndActivate()
.addOnCompleteListener(this) { task ->
if (task.isSuccessful) {
val updated = task.result
Log.d(TAG, "Remote Config values fetched and activated: $updated")
} else {
Log.e(TAG, "Error fetching Remote Config", task.exception)
}
}
Java
// Fetch and activate Remote Config values
mFirebaseRemoteConfig.fetchAndActivate()
.addOnCompleteListener(this, new OnCompleteListener<Boolean>() {
@Override
public void onComplete(@NonNull Task<Boolean> task) {
if (task.isSuccessful()) {
boolean updated = task.getResult();
Log.d(TAG, "Config params updated: " + updated);
} else {
Log.e(TAG, "Error fetching Remote Config", task.exception)
}
}
});
Web
Thêm
getValuevàfetchAndActivatevào các lệnh nhập của bạn:import { getValue, fetchAndActivate } from 'firebase/remote-config';Xác định vị trí của mã mà bạn chỉ định giá trị mặc định cho tên mô hình. Ngay sau khối mã đó, hãy thêm mã sau để tìm nạp và kích hoạt cấu hình, đồng thời chỉ định giá trị đã tìm nạp cho hằng số
templateID.// Fetch and activate Remote Config. try { await fetchAndActivate(remoteConfig); } catch(err) { console.error('Remote Config fetch failed', err); } console.log('Remote Config fetched.'); // Assign Remote Config values. const templateID = getValue(remoteConfig, 'template_id').asString();
Bước 5: Thêm trình nghe Remote Config theo thời gian thực
Thêm một trình nghe Remote Config theo thời gian thực vào ứng dụng của bạn để đảm bảo rằng những thay đổi mà bạn thực hiện đối với mẫu Remote Config sẽ được truyền đến ứng dụng khách ngay khi được cập nhật.
Đoạn mã sau đây cập nhật đối tượng Remote Config bất cứ khi nào giá trị tham số thay đổi.
Swift
// Add real-time Remote Config
remoteConfig.addOnConfigUpdateListener { configUpdate, error in
guard let configUpdate = configUpdate, error == nil else {
print("Error listening for config updates: \(error?.localizedDescription ?? "No error available")")
return
}
print("Updated keys: \(configUpdate.updatedKeys)")
remoteConfig.activate { changed, error in
guard error == nil else {
print("Error activating config: \(error?.localizedDescription ?? "No error available")")
return
}
print("Activated config successfully")
}
}
Kotlin
Bạn cũng có thể định cấu hình một thao tác trong quá trình kích hoạt addOnCompleteListener (không bắt buộc):
// Add a real-time Remote Config listener
remoteConfig.addOnConfigUpdateListener(object : ConfigUpdateListener {
override fun onUpdate(configUpdate : ConfigUpdate) {
Log.d(ContentValues.TAG, "Updated keys: " + configUpdate.updatedKeys);
remoteConfig.activate().addOnCompleteListener {
// Optionally, add an action to perform on update here.
}
}
override fun onError(error : FirebaseRemoteConfigException) {
Log.w(ContentValues.TAG, "Config update error with code: " + error.code, error)
}
}
Java
Bạn cũng có thể định cấu hình một thao tác trong quá trình kích hoạt addOnCompleteListener (không bắt buộc):
// Add a real-time Remote Config listener
remoteConfig.addOnConfigUpdateListener(new ConfigUpdateListener() {
@Override
public void onUpdate(ConfigUpdate configUpdate) {
Log.d(ContentValues.TAG, "Updated keys: " + configUpdate.getUpdatedKeys());
remoteConfig.activate().addOnCompleteListener(new OnCompleteListener<Boolean>() {
@Override
public void onComplete(@NonNull Task<Boolean> task) {
// Optionally, add an action to perform on update here.
}
});
}
@Override
public void onError(FirebaseRemoteConfigException error) {
Log.w(ContentValues.TAG, "Config update error with code: " + error.getCode(), error);
}
});
Web
Số lượng người nghe Remote Config theo thời gian thực không được hỗ trợ cho ứng dụng Web.
Bước 6: Cập nhật các yêu cầu Gemini API để sử dụng giá trị Remote Config
|
Nhấp vào nhà cung cấp Gemini API để xem nội dung và mã dành riêng cho nhà cung cấp trên trang này. |
Giờ đây, khi Remote Config đã được định cấu hình đầy đủ, hãy cập nhật mã của bạn để thay thế các giá trị được mã hoá cứng bằng các giá trị lấy từ Remote Config.
Swift
import FirebaseAI
let templateID = remoteConfig.configValue(forKey: "template_id").stringValue
let model = FirebaseAI.firebaseAI(backend: .googleAI()).templateGenerativeModel()
let customerName = "Jane"
// When making the `generateContent` call, source the template ID value from Remote Config
let response = try await model.generateContent(
templateID: templateID,
// Provide the values for any input variables required by your template.
inputs: [
"customerName": customerName
]
)
// ...
Kotlin
// ...
val model = Firebase.ai().templateGenerativeModel()
val customerName = "Jane"
// When making the `generateContent` call, source the template ID value from Remote Config
val response = model.generateContent(
remoteConfig.getString("template_id"),
// Provide the values for any input variables required by your template.
mapOf(
"customerName" to customerName
)
)
val text = response.text
println(text)
Java
// ...
TemplateGenerativeModel ai = FirebaseAI.getInstance()
.templateGenerativeModel(null /* Request Options */);
TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(ai);
String customerName = "Jane";
// When making the `generateContent` call, source the template ID value from Remote Config
Future<GenerateContentResponse> response = model.generateContent(
remoteConfig.getString("template_id"),
// Provide the values for any input variables required by your template.
mapOf("customerName", customerName)
);
addCallback(response,
new FutureCallback<GenerateContentResponse>() {
public void onSuccess(GenerateContentResponse result) {
System.out.println(result.getText());
}
public void onFailure(Throwable t) {
reportError(t);
}
}
executor);
// ...
Web
// ...
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
const model = getTemplateGenerativeModel(ai);
const templateID = getValue(remoteConfig, 'template_id').asString();
const customerName = 'Jane';
// When making the `generateContent` call, source the template ID value from Remote Config
const result = await model.generateContent(
templateID,
// Provide the values for any input variables required by your template
{
customerName: customerName,
}
);
// ...
Bước 7: Chạy ứng dụng
Tạo bản dựng và chạy ứng dụng, đồng thời xác minh rằng ứng dụng hoạt động. Thay đổi cấu hình của bạn trên trang Remote Config trong bảng điều khiển Firebase, xuất bản các thay đổi và xác minh kết quả.
Các bước tiếp theo
Tìm hiểu thêm về cách triển khai các trường hợp sử dụng khác cho Remote Config và Firebase AI Logic.
Đối với ứng dụng và trò chơi di động:
Kiểm tra các thay đổi đối với mẫu bằng Remote Config và A/B Testing.
Phát hành dần các thay đổi bằng cách sử dụng Remote Config phát hành từng phần (chỉ dành cho iOS+ và Android).
Sử dụng tính năng Remote Configcá nhân hoá để dùng công nghệ học máy nhằm xác định chế độ cài đặt phù hợp nhất cho từng người dùng (chỉ dành cho iOS+, Android và Unity).