Za pomocą interfejsu API Firebase Dynamic Links możesz tworzyć krótkie lub długie Dynamic Links. Interfejs API korzysta z kilku opcjonalnych struktur parametrów do tworzenia linków. Krótkie linki można też tworzyć na podstawie wcześniej wygenerowanych długich linków. Firebase Dynamic Linksgeneruje adres URL podobny do tego:
https://example.page.link/WXYZ
Pakiet SDK C++ działa zarówno na Androidzie, jak i na iOS, ale na każdej z tych platform wymaga dodatkowej konfiguracji.
Zanim zaczniesz
Zanim zaczniesz korzystać z Firebase Dynamic Links, musisz:
Zarejestruj projekt C++ i skonfiguruj go pod kątem używania Firebase.
Jeśli Twój projekt w C++ korzysta już z Firebase, jest już zarejestrowany i skonfigurowany pod kątem tej usługi.
Dodaj pakiet SDK Firebase C++ do projektu C++.
Dodawanie Firebase do projektu w C++ wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie w C++ (np. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu w C++).
Android
- W konsoli Firebase otwórz sekcję Dynamic Links.
Jeśli nie zaakceptowałeś(-aś) jeszcze warunków korzystania z usługi i nie ustawiłeś(-aś) prefiksu URI dla usługi Dynamic Links, zrób to, gdy pojawi się taka prośba.
Jeśli masz już prefiks URI Dynamic Links, zanotuj go. Podczas tworzenia za pomocą kodu Dynamic Links musisz podać prefiks identyfikatora URI Dynamic Links.
- Zalecane: określ wzorce adresów URL dozwolone w precyzyjnych linkach i linkach zastępczych. Dzięki temu uniemożliwisz nieupoważnionym osobom tworzenie Dynamic Links, które przekierowują z Twojej domeny do witryn, nad którymi nie masz kontroli. Zapoznaj się z wzorcami adresów URL na białej liście.
iOS
- W konsoli Firebase otwórz sekcję Dynamic Links.
Jeśli nie zaakceptowałeś(-aś) jeszcze warunków korzystania z usługi i nie ustawiłeś(-aś) prefiksu URI dla usługi Dynamic Links, zrób to, gdy pojawi się taka prośba.
Jeśli masz już prefiks URI Dynamic Links, zanotuj go. Podczas tworzenia za pomocą kodu domeny Dynamic Links musisz podać domenę Dynamic Links.
- Biblioteka klienta Firebase Dynamic Links w języku C++ używa niestandardowych schematów URL-i na iOS do przetwarzania linków. Aby obsługiwać otrzymywanie Dynamic Links, musisz dodać do aplikacji niestandardowe schematy adresów URL:
- Aby otworzyć konfigurację projektu, kliknij dwukrotnie jego nazwę w widoku drzewa po lewej stronie. W sekcji CELE wybierz swoją aplikację, a potem kliknij kolejno karty Informacje i Typy adresów URL.
- Kliknij przycisk + i dodaj schemat adresu URL dla odwróconego identyfikatora klienta. Aby znaleźć tę wartość, otwórz plik konfiguracji
GoogleService-Info.plist REVERSED_CLIENT_ID. Skopiuj wartość tego klucza i wklej ją w polu Schematy adresów URL na stronie konfiguracji. Pozostałe pola pozostaw puste. - Kliknij przycisk + i dodaj drugi schemat adresu URL. Jest to identyfikator pakietu Twojej aplikacji. Jeśli na przykład identyfikator pakietu to
com.example.ios, wpisz tę wartość w polu Schematy URL. Identyfikator pakietu aplikacji znajdziesz na karcie Ogólne w konfiguracji projektu (Tożsamość > Identyfikator pakietu).
Korzystanie z konsoli Firebase
Jeśli chcesz wygenerować pojedynczy Dynamic Link na potrzeby testów lub aby umożliwić zespołowi marketingowemu łatwe tworzenie linków do wykorzystania w postach w mediach społecznościowych, najprostszym sposobem jest przejście do konsoli Firebase i ręczne utworzenie linku zgodnie z podanymi instrukcjami.
Domeny niestandardowe
Możesz mieć większą kontrolę nad brandingiem Dynamic Link, używając własnej domeny zamiast domeny podrzędnej goo.gl lub page.link. Aby skonfigurować domenę niestandardową dla projektu, wykonaj te instrukcje.
Korzystanie z interfejsu Firebase Dynamic Links API
Tworzenie i inicjowanie aplikacji
Zanim utworzysz Dynamic Links, musisz utworzyć i inicjializować obiekt firebase::App.
Dołącz plik nagłówka dla firebase::App:
#include "firebase/app.h"
Kolejna część zależy od platformy:
Android
Utwórz obiekt firebase::App, przekazując jako argumenty środowisko JNI i odniesienie do aktywności w języku Java:jobject
app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);iOS
Utwórz firebase::App:
app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));Inicjowanie biblioteki Dynamic Links
Zanim utworzysz Dynamic Link, musisz najpierw inicjializować bibliotekę Dynamic Links:
::firebase::dynamic_links::Initialize(app, null);
Tworzenie długiego Dynamic Link z parametrów
Aby utworzyć Dynamic Link, utwórz obiekt DynamicLinkComponents, ustawiając dowolne opcjonalne elementy na potrzeby dodatkowej konfiguracji, a potem prześlij go do dynamic_links::GetShortLink lub dynamic_links::GetLongLink.
Ten minimalny przykład tworzy długi Dynamic Link do adresu https://www.example.com/, który otwiera się w aplikacji na Androida com.example.android.package_name i aplikacji na iOS com.example.ios:
firebase::dynamic_links::IOSParameters ios_parameters("com.example.ios");
firebase::dynamic_links::AndroidParameters android_parameters(
"com.example.android.package_name");
firebase::dynamic_links::DynamicLinkComponents components(
"https://www.example.com/", "example.page.link");
components.android_parameters = &android_parameters;
components.ios_parameters = &ios_parameters;
firebase::dynamic_links::GeneratedDynamicLink long_link =
firebase::dynamic_links::GetLongLink(components);
Tworzenie filmu Short Dynamic Link
Aby utworzyć krótki link dynamiczny, prześlij wcześniej wygenerowany długi link do GetShortLink lub utwórz DynamicLinkComponents w taki sam sposób jak powyżej.
Funkcja GetShortLink może opcjonalnie przyjmować dodatkowy parametr konfiguracji DynamicLinkOptions z wartością PathLength. Umożliwia to kontrolowanie sposobu generowania linku. Generowanie krótkiego linku wymaga wysłania żądania sieci do zaplecza Firebase, więc GetShortLink jest asynchroniczny i zwraca Future<GeneratedLink>.
Przykład:
firebase::dynamic_links::DynamicLinkOptions short_link_options;
short_link_options.path_length = firebase::dynamic_links::kPathLengthShort;
firebase::Future<firebase::dynamic_links::GeneratedDynamicLink> result =
firebase::dynamic_links::GetShortLink(components, short_link_options);
Jeśli Twój program ma pętlę aktualizacji, która działa regularnie (np. 30 lub 60 razy na sekundę), możesz sprawdzać wyniki po każdej aktualizacji:
if (result.status() == firebase::kFutureStatusComplete) {
if (result.error() == firebase::dynamic_links::kErrorCodeSuccess) {
firebase::dynamic_links::GeneratedDynamicLink link = *result.result();
printf("Create short link succeeded: %s\n", link.url.c_str());
} else {
printf("Created short link failed with error '%s'\n",
result.error_message());
}
}