Remote Config szablony to zestawy w formacie JSON parametrów i warunków utworzonych przez Ciebie na potrzeby projektu Firebase. Ty może tworzyć szablony klientów, z których aplikacja pobiera wartości; serwerów, z których klienty serwera mogą pobierać wartości.
W tej sekcji omówione są szablony klientów. Aby dowiedzieć się więcej o szablonach na serwer, kliknij Szablony serwera.Szablon możesz modyfikować i zarządzać nim w konsoli Firebase, która wyświetla zawartość szablonu w formacie graficznym w Parametry oraz Karty Warunki.
Możesz też użyć usługi interfejs API typu REST Remote Config i pakiet Admin SDK lub interfejs wiersza poleceń Firebase, aby modyfikować szablon klienta.
Oto przykład pliku szablonu serwera:
{
"parameters": {
"preamble_prompt": {
"defaultValue": {
"value": "You are a helpful assistant who knows everything there is to know about Firebase! "
},
"description": "Add this prompt to the user's prompt",
"valueType": "STRING"
},
"model_name": {
"defaultValue": {
"value": "gemini-pro-test"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
},
"valueType": "JSON"
},
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
Za pomocą konsoli Firebase możesz wykonywać te zadania zarządzania wersjami:
- Wyświetl listę wszystkich przechowywanych wersji szablonów
- Pobieranie konkretnej wersji
- Przywracanie określonej wersji klienta
- Usuń szablony (Remote Config) z sekcji Zmień historia strona
Obowiązuje limit 300 przechowywanych wersji bezterminowo na typ szablonu. (300 szablonów klienta i 300 szablonów serwera), w tym zapisane numerów wersji usuniętych szablonów. Jeśli w trakcie trwania projektu opublikujesz więcej niż 300 wersji szablonu na typ szablonu, najstarsze wersje zostaną usunięte, zachowując maksymalnie 300 wersji tego typu.
Za każdym razem, gdy zaktualizujesz parametry, Remote Config tworzy makro
ma nową wersję szablonu Remote Config i przechowuje poprzedni jako
wersję, którą możesz pobrać lub przywrócić zależnie od potrzeb. Numery wersji
są zwiększane sekwencyjnie od wartości początkowej zapisanej przez funkcję Remote Config.
Wszystkie szablony zawierają pole version
, jak pokazano na ilustracji, z metadanymi na ten temat.
konkretnej wersji.
W razie potrzeby możesz usunąć Remote Config szablonu z Historia zmian w w konsoli Remote Config.
Zarządzaj wersjami szablonu Remote Config
Z tej sekcji dowiesz się, jak zarządzać wersjami aplikacji Remote Config szablon.
Wyświetlanie listy wszystkich zapisanych wersji szablonu Remote Config
Możesz pobrać listę wszystkich zapisanych wersji szablonu Remote Config. Aby to zrobić:
Konsola Firebase
Na karcie Parametry wybierz „zegar” w prawym górnym rogu. Otworzy się Historia zmian w menu po prawej stronie z listą wszystkich przechowywanych wersji szablonów.
Szczegóły wyświetlane w przypadku każdej zapisanej wersji zawierają informacje o tym, czy zmian pochodzących z konsoli (przy użyciu interfejsu API REST) po przywróceniu czy zmiany przyrostowe wynikające z wymuszonego zapisu szablonu.
Interfejs wiersza poleceń Firebase
firebase remoteconfig:versions:list
Aby ograniczyć liczbę zwracanych wersji, użyj opcji --limit
.
Pomyśl „0” pobierz wszystkie wersje.
Node.js
function listAllVersions() {
admin.remoteConfig().listVersions()
.then((listVersionsResult) => {
console.log("Successfully fetched the list of versions");
listVersionsResult.versions.forEach((version) => {
console.log('version', JSON.stringify(version));
});
})
.catch((error) => {
console.log(error);
});
}
Java
ListVersionsPage page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get(); while (page != null) { for (Version version : page.getValues()) { System.out.println("Version: " + version.getVersionNumber()); } page = page.getNextPage(); } // Iterate through all versions. This will still retrieve versions in batches. page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get(); for (Version version : page.iterateAll()) { System.out.println("Version: " + version.getVersionNumber()); }
REST
curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:listVersions
Lista szablonów zawiera metadane wszystkich przechowywanych wersji, w tym datę aktualizacji, nazwę użytkownika, który ją dokonał, i sposób jej przeprowadzenia. Oto przykład elementu wersji:
```json
{
"versions": [{
"version_number": "6",
"update_time": "2022-05-12T02:38:54Z",
"update_user": {
"name": "Jane Smith",
"email": "jane@developer.org",
"imageUrl": "https://lh3.googleusercontent.com/a-/..."
},
"description": "One small change on the console",
"origin": "CONSOLE",
"update_type": "INCREMENTAL_UPDATE"
}]
}
```
Pobierz konkretną wersję szablonu Remote Config
Możesz pobrać wszystkie zapisane dane, wersji szablonu Remote Config. Aby pobrać zapisany szablon wersja:
Konsola Firebase
Domyślnie okienko szczegółów w Karta Historia zmian wyświetla bieżący aktywny szablon. Aby wyświetlić szczegóły innej wersji na liście, wybierz ją w menu po prawej stronie.
Możesz wyświetlić szczegółowe różnice między obecnie wybraną wersją a dowolnymi zapisanej wersji po najechaniu kursorem na menu kontekstowe dowolnej niewybranej wersji i kliknij Porównaj z wybraną wersją.
Interfejs wiersza poleceń Firebase
firebase remoteconfig:get -v VERSION_NUMBER
Opcjonalnie możesz zapisać dane wyjściowe w określonym pliku przy użyciu -o, FILENAME
.
Node.js
Aby pobrać najnowszą wersję szablonu, prześlij getTemplate()
bez żadnych argumentów. Aby pobrać określoną wersję, użyj getTemplateAtVersion()
.
// Get template version: 6
admin.remoteConfig().getTemplateAtVersion('6')
.then((template) => {
console.log("Successfully fetched the template with ETag: " + template.etag);
})
.catch((error) => {
console.log(error);
});
Java
Template template = FirebaseRemoteConfig.getInstance().getTemplateAtVersionAsync(versionNumber).get(); // See the ETag of the fetched template. System.out.println("Successfully fetched the template with ETag: " + template.getETag());
REST
curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig?version_number=6
Parametr adresu URL ?version_number
jest prawidłowy tylko w przypadku operacji GET
.
nie można go użyć do określenia numerów wersji na potrzeby aktualizacji. Podobne
żądania bez ?version_number
pobierze bieżący aktywny szablon.
Wycofaj zmiany do określonej zapisanej wersji szablonu Remote Config
Możesz przywrócić dowolną zapisaną wersję szablonu. Aby przywrócić poprzednią wersję szablonu:
Konsola Firebase
W przypadku poprzednich wersji szablonów, które można cofnąć, w prawym górnym rogu strony Historia zmian wyświetlany jest przycisk opcji umożliwiający przywrócenie tej wersji. Kliknij i potwierdź tę opcję tylko wtedy, gdy na pewno chcesz wrócić do poprzedniej wersji wersji i używaj tych wartości od razu w przypadku wszystkich aplikacji i użytkowników.
Interfejs wiersza poleceń Firebase
firebase remoteconfig:rollback -v VERSION_NUMBER
Node.js
// Roll back to template version: 6
admin.remoteConfig().rollback('6')
.then((template) => {
console.log("Successfully rolled back to template version 6.");
console.log("New ETag: " + template.etag);
})
.catch((error) => {
console.log('Error trying to rollback:', e);
})
Java
try { Template template = FirebaseRemoteConfig.getInstance().rollbackAsync(versionNumber).get(); System.out.println("Successfully rolled back to template version: " + versionNumber); System.out.println("New ETag: " + template.getETag()); } catch (ExecutionException e) { if (e.getCause() instanceof FirebaseRemoteConfigException) { FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause(); System.out.println("Error trying to rollback template."); System.out.println(rcError.getMessage()); } }
REST
Aby przywrócić zapisany szablon Remote Config, wyślij żądanie HTTP POST z
metoda niestandardowa :rollback
oraz konkretna wersja w treści żądania
. Przykład:
curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -H "Content-Type: application/json" -X POST https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:rollback -d '{"version_number": 6}'
Odpowiedź zawiera zawartość obecnie aktywnego zapisanego szablonu, a przy tym metadanych nowej wersji.
Pamiętaj, że ta operacja przywracania tworzy nową wersję numerowaną. Na przykład przywrócenie wersji 10 do wersji 6 spowoduje utworzenie nowej kopii wersji 6, która różni się od oryginału tylko tym, że jej numer wersji to 11. Oryginalna wersja 6 jest nadal przechowywany, zakładając, że nie upłynął jeszcze termin wygaśnięcia wersji, a wersja 11 stanie się szablonem aktywnym.
Usuń szablon Remote Config
Szablony Remote Config możesz usuwać w konsoli Firebase. Aby usunąć szablon Remote Config:
1. Na stronie Remote Config Parametry kliknij Historia zmian.Przejdź do szablonu, który chcesz usunąć, i kliknij
Więcej, a następnie wybierz Usuń.Gdy pojawi się prośba o potwierdzenie usunięcia, kliknij Usuń.
Pobieranie i publikowanie szablonów Remote Config
Pobierz i opublikuj szablony Remote Config, aby zintegrować je z systemami kontroli źródła i kompilacji, zautomatyzować aktualizacje konfiguracji oraz zsynchronizować parametry i wartości w różnych projektach.
Możesz pobrać aktywny szablon Remote Config w konsoli Firebase. Następnie możesz zaktualizować wyeksportować plik JSON i opublikować go w tym samym projekcie albo opublikować w nowym lub istniejącego projektu.
Załóżmy, że masz kilka projektów reprezentujących różne etapy cykl tworzenia oprogramowania, np. programowanie, testowanie, testowanie i produkcja w różnych środowiskach. W takiej sytuacji możesz promować w pełni przetestowany szablon ze swojej środowiska testowego do środowiska produkcyjnego. Pobierz je ze swojego i opublikować projekt w projekcie produkcyjnym.
Za pomocą tej metody możesz też przenieść konfiguracje z jednego projektu do inny lub zapełnić nowy projekt parametrami i wartościami z i gotowego projektu.
Parametry i ich wartości utworzone specjalnie jako warianty w parametrze A/B Testing eksperyment nie jest uwzględniony w eksportowanych szablonach.
Aby wyeksportować i zaimportować Remote Config szablon:
- Pobierz aktualny szablon konfiguracji Remote Config.
- Zweryfikuj szablon Remote Config.
- Opublikuj szablon Remote Config.
Pobierz bieżący szablon Zdalnej konfiguracji
Aby pobrać aktywny szablon Remote Config w formacie JSON:
Konsola Firebase
- Z poziomu Remote Config Parametry lub warunki kartę, otwórz menu i wybierz Pobierz bieżący plik konfiguracyjny.
- Gdy pojawi się prośba, kliknij Pobierz plik konfiguracyjny i wybierz lokalizację, w której chcesz zapisać plik, a potem kliknij Zapisz.
Interfejs wiersza poleceń Firebase
firebase remoteconfig:get -o filename
Node.js
function getTemplate() { var config = admin.remoteConfig(); config.getTemplate() .then(function (template) { console.log('ETag from server: ' + template.etag); var templateStr = JSON.stringify(template); fs.writeFileSync('config.json', templateStr); }) .catch(function (err) { console.error('Unable to get template'); console.error(err); }); }
Java
Template template = FirebaseRemoteConfig.getInstance().getTemplateAsync().get(); // See the ETag of the fetched template. System.out.println("ETag from server: " + template.getETag());
REST
curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -o filename
Wywołuje ono ładunek JSON do jednego pliku, a nagłówki
(w tym ETag) do osobnego pliku headers
.
Weryfikowanie szablonu Zdalnej konfiguracji
Przed opublikowaniem aktualizacji w szablonie możesz sprawdzić je za pomocą Firebase Admin SDK lub API REST. Szablony są również weryfikowane, gdy próbujesz do opublikowania za pomocą interfejsu wiersza poleceń Firebase lub konsoli Firebase.Proces weryfikacji szablonu sprawdza ewentualne błędy, na przykład zduplikowane klucze
parametrów i warunków, nieprawidłowych nazw warunków lub nieistniejących warunków lub
niewłaściwie sformatowanych tagów ETag. Na przykład żądanie zawierające więcej niż dozwoloną liczbę kluczy (2000) zwróci komunikat o błędzie Param count too
large
.
Node.js
function validateTemplate(template) { admin.remoteConfig().validateTemplate(template) .then(function (validatedTemplate) { // The template is valid and safe to use. console.log('Template was valid and safe to use'); }) .catch(function (err) { console.error('Template is invalid and cannot be published'); console.error(err); }); }
Java
try { Template validatedTemplate = FirebaseRemoteConfig.getInstance() .validateTemplateAsync(template).get(); System.out.println("Template was valid and safe to use"); } catch (ExecutionException e) { if (e.getCause() instanceof FirebaseRemoteConfigException) { FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause(); System.out.println("Template is invalid and cannot be published"); System.out.println(rcError.getMessage()); } }
REST
Sprawdź poprawność aktualizacji szablonu, dodając parametr adresu URL ?validate_only=true
do żądania publikacji:
curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?validate_only=true -d @filename
Jeśli weryfikacja szablonu przebiegła pomyślnie, polecenie curl zwróci
Przesłanym przez Ciebie szablonem JSON znajduje się w zapisanym pliku headers
ze stanem HTTP/2 200 i zaktualizowanym tagiem ETag z sufiksem -0
. Jeśli
nie został zweryfikowany, ale w sekcji
Odpowiedź JSON i plik headers
będą zawierać odpowiedź inną niż 200
(i nie ma ETag).
Publikowanie szablonu Remote Config
Po pobraniu szablonu wprowadź niezbędne zmiany w treści JSON. aby go sprawdzić, możesz opublikować go w projekcie.
Publikowanie szablonu powoduje zastąpienie całego dotychczasowego szablonu konfiguracji zaktualizowanym plikiem i zwiększenie wersji szablonu o 1. Ponieważ cały zostanie zastąpiona, jeśli usuniesz parametr z pliku JSON po jego opublikowaniu, parametr zostanie usunięty z serwera i nie będzie już dostępny nowych klientów.
Po opublikowaniu zmiany parametrów i wartości są dostępne od razu do Twoich aplikacji i użytkowników. W razie potrzeby przywrócić poprzednią wersję.
Aby opublikować szablon, użyj tych poleceń:
Konsola Firebase
- Z poziomu Remote Config Parametry lub warunki otwórz menu, i wybierz Opublikuj z pliku.
- Gdy pojawi się komunikat, kliknij Przeglądaj, przejdź do Remote Config plik, który chcesz opublikować, a następnie kliknij Wybierz.
- Plik zostanie zweryfikowany. Jeśli operacja się uda, kliknij Opublikuj, aby od razu udostępnić konfigurację aplikacji i użytkowników.
Node.js
function publishTemplate() { var config = admin.remoteConfig(); var template = config.createTemplateFromJSON( fs.readFileSync('config.json', 'UTF8')); config.publishTemplate(template) .then(function (updatedTemplate) { console.log('Template has been published'); console.log('ETag from server: ' + updatedTemplate.etag); }) .catch(function (err) { console.error('Unable to publish template.'); console.error(err); }); }
Java
try { Template publishedTemplate = FirebaseRemoteConfig.getInstance() .publishTemplateAsync(template).get(); System.out.println("Template has been published"); // See the ETag of the published template. System.out.println("ETag from server: " + publishedTemplate.getETag()); } catch (ExecutionException e) { if (e.getCause() instanceof FirebaseRemoteConfigException) { FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause(); System.out.println("Unable to publish template."); System.out.println(rcError.getMessage()); } }
REST
curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -d @filename
W przypadku tego polecenia curl
treść możesz określić za pomocą znaku „@”
, a po nim nazwa pliku.
Remote ConfigW pobieranych szablonach uwzględniono personalizację i warunki, dlatego podczas próby opublikowania w innym projekcie należy wziąć pod uwagę te ograniczenia:
Personalizacji nie można importować z jednego projektu do drugiego.
Jeśli na przykład w projekcie masz włączone personalizacje pobrać i edytować szablon, można go opublikować projektu, ale nie możesz go opublikować w innym projekcie, chyba że go usuniesz personalizacje z szablonu.
Warunki można importować z projektu do projektu, ale pamiętaj, że każdy określonych wartości warunkowych (np. identyfikatory aplikacji lub listy odbiorców) powinny występować w projektu docelowego przed opublikowaniem.
Jeśli np. masz parametr Remote Config, który korzysta z warunku określające wartość platformy
iOS
, szablon może zostać opublikowany do innego projektu, ponieważ wartości platformy są dla każdego projektu takie same. Jeśli jednak zawiera on warunek, który zależy od określonego identyfikatora aplikacji lub listy odbiorców, która nie istnieje w projekcie docelowym, weryfikacja się nie powiedzie.Jeśli szablon, który zamierzasz opublikować, zawiera warunki oparte na W środowisku docelowym musi być włączona funkcja Google Analytics, Analytics w projektach AI.
Pobierz domyślne ustawienia szablonu (Remote Config)
Aplikacja nie zawsze ma połączenie z internetem, należy skonfigurować domyślne wartości aplikacji po stronie klienta dla wszystkich elementów Remote Config . Co jakiś czas należy też synchronizować domyślne ustawienia klienta aplikacji. i wartości domyślnych parametrów backendu (Remote Config), ponieważ mogą się zmienić.
Zgodnie z opisem w linkach dotyczących poszczególnych platform na końcu tej sekcji możesz ręcznie ustawić te wartości domyślne w aplikacji. Możesz też uprościć ten proces, pobieranie plików zawierających tylko pary klucz-wartość dla wszystkich parametrów; i ich wartości domyślne w aktywnym szablonie Remote Config. Następnie możesz uwzględnić ten plik w projekcie i skonfigurować aplikację tak, aby importowała te wartości.
Dla aplikacji na Androida możesz pobrać te pliki w formacie XML, format listy właściwości (plist) w przypadku aplikacji na iOS i JSON w przypadku aplikacji internetowych.
Zalecamy okresowe pobieranie ustawień domyślnych (Remote Config), zanim zaczną obowiązywać nowe wersji aplikacji, aby zapewnić, że aplikacja i backend Remote Config pozostaną w niej synchronizację.
Aby pobrać plik zawierający wartości domyślne szablonu:
REST
curl --compressed -D headers -H "Authorization: Bearer token -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=file_format'
Użyj wartości XML
, PLIST
lub JSON
jako wartości format
w zależności od tego, który plik
w formacie, który chcesz pobrać.
Konsola Firebase
- Na karcie Parametry otwórz Menu i wybierz Pobierz wartości domyślne.
- Gdy pojawi się odpowiedni komunikat, kliknij przycisk odpowiadający odpowiedniemu plikowi. w formacie, który chcesz pobrać, i kliknij Pobierz plik.
Aby uzyskać więcej informacji o importowaniu Remote Config wartości domyślnych do zobacz:
Ustawianie domyślnych wartości parametrów w aplikacji na Androida
Ustawianie wartości domyślnych parametrów w aplikacji na iOS
Ustawianie domyślnych wartości parametrów w aplikacji w przypadku witryn internetowych
Ustawianie domyślnych wartości parametrów w aplikacji w Unity
Ustawianie w aplikacji wartości domyślnych parametrów w języku C++