Linki dynamiczne Firebase zostały wprowadzone ponad 7 lat temu, aby zwiększyć możliwości adresów URL - można było na przykład dynamicznie zmieniać miejsce docelowe linku na podstawie warunków w czasie działania.
Z biegiem lat ekosystemy internetowe i mobilne ewoluowały dzięki technologiom takim jak linki do aplikacji, aplikacje błyskawiczne w Google Play , linki uniwersalne i klipy aplikacji. Dzięki temu ścieżki użytkowników w aplikacjach i internecie stały się bardziej płynne i przewidywalne dla użytkowników Twojej aplikacji. Uważamy, że bezpośrednie wdrożenie tych technologii przyniesie Tobie i Twoim użytkownikom więcej korzyści i pozwoli rozwijać ekosystem. Jednak oprócz tych nowych zmian ewoluowały też oryginalne natywne interfejsy API, na których opierały się Linki dynamiczne Firebase, co spowodowało nowe wyzwania.
Na przykład zmiany w ekosystemie wpłynęły na naszą zdolność do zapewnienia stabilnego działania jednej z podstawowych funkcji Linków dynamicznych Firebase – płynnego przejścia użytkowników do aplikacji po jej zainstalowaniu, niezależnie od platformy.
Zamiast nadal obsługiwać rozwiązanie, które nie jest idealne, postanowiliśmy wycofać Linki dynamiczne Firebase i skupić nasze zasoby na rozwiązywaniu innych problemów deweloperów.
Rozumiemy, że ta zmiana będzie wymagać od Ciebie czasu na ocenę i wdrożenie alternatywnych rozwiązań lub dostawców platformy.
Stale rozwijamy Firebase, aby spełniać Twoje potrzeby w miarę ewolucji i zmian w ekosystemie. Będziemy nadal wprowadzać nowe funkcje i aktualizacje w usługach Firebase oraz pomagać Ci w tworzeniu aplikacji.
Co muszę wiedzieć?
25 sierpnia 2025 r. Linki dynamiczne Firebase zostaną wyłączone. Wszystkie linki obsługiwane przez Linki dynamiczne Firebase (zarówno te hostowane w domenach niestandardowych, jak i w subdomenach page.link) przestaną działać i nie będzie można tworzyć nowych linków.
Aby pomóc Ci w podjęciu decyzji o migracji z Linków dynamicznych Firebase, będziemy nadal aktualizować ten dokument z najczęstszymi pytaniami i odpowiedziami, dodając do niego dodatkowe informacje, które warto wziąć pod uwagę. Będziemy też udostępniać przewodniki po migracji w różnych scenariuszach, które mogą odpowiadać sposobowi, w jaki obecnie korzystasz z Linków dynamicznych Firebase.
Będziemy też nadal aktualizować ten przewodnik, dodając do niego kolejne najczęstsze pytania i odpowiedzi, w miarę jak wycofywanie usługi będzie zbliżać się do daty zakończenia (25 sierpnia 2025 r.) i gdy będziemy odkrywać dodatkowe problemy, pomagając Ci w migracji.
Odpowiedzi na niektóre z najważniejszych pytań znajdziesz w sekcji Najczęstsze pytania poniżej.
Aby rozpocząć migrację, zapoznaj się z sekcją „Jak przeprowadzić migrację z tej usługi?” poniżej.
Kiedy Linki dynamiczne Firebase przestaną działać?
25 sierpnia 2025 r. Linki dynamiczne Firebase zostaną wyłączone. Wszystkie linki obsługiwane przez Linki dynamiczne Firebase (zarówno te hostowane w domenach niestandardowych, jak i w subdomenach page.link) przestaną działać.
Ile czasu będę mieć na migrację?
Migrację musisz zakończyć do 25 sierpnia 2025 r.
Czy nowe i dotychczasowe linki będą nadal działać?
Tak, nowe i dotychczasowe linki będą nadal działać do momentu wyłączenia usługi Linki dynamiczne 25 sierpnia 2025 r.
Czy będę mieć możliwość zachowania lub przeniesienia automatycznie utworzonych domen .page.link używanych w linkach?
Nie. Po wyłączeniu usługi Linki dynamiczne Firebase domeny .page.link nie będą już dostępne. Zalecamy zapoznanie się z tą listą pytań, aby ocenić, jak najlepiej przeprowadzić migrację z tej usługi, a jeśli potrzebujesz pełnej zgodności funkcji, postępuj zgodnie z tymi wskazówkami dotyczącymi eksportowania metadanych i migracji do innego dostawcy usługi precyzyjnych linków przy użyciu nowej domeny.
Co się stanie z moimi linkami i aplikacjami, gdy Linki dynamiczne Firebase zostaną wycofane (25 sierpnia 2025 r.)?
Po wycofaniu Linków dynamicznych Firebase:
- Wszystkie kliknięte linki będą zwracać użytkownikom kod stanu HTTP 404.
Wszystkie żądania HTTP wysyłane do:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (interfejs API krótkich linków)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (interfejs API statystyk linków)
będą zwracać kod stanu HTTP 400 lub 403.
Od 25 sierpnia 2025 r. odsetek odpowiedzi z błędem będzie stopniowo wzrastać, aż po dacie wycofania usługi osiągnie 100%.
Poniżej znajdziesz informacje o tym, jak będzie się zachowywać usługa w zależności od wersji pakietu SDK i wywołania interfejsu API w Twojej aplikacji:
iOS
Przypadek użycia Wywołanie interfejsu API Kod stanu Zachowanie Czy w Twojej aplikacji wystąpią poważne błędy? Utwórz krótki link shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
403 Zwracany jest błąd z przyczyną niepowodzenia Nie* Oznaczenie pierwszego otwarcia Wywoływane automatycznie w przypadku FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)
400 Nie są zwracane żadne błędy, ale obiekt FDL jest odsyłany z pustymi danymi Nie* Oznaczenie ponownego otwarcia handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 Zwracany jest błąd z przyczyną niepowodzenia Nie* Android
Przypadek użycia Wywołanie interfejsu API Kod stanu Zachowanie Czy w Twojej aplikacji wystąpią poważne błędy? Utwórz krótki link buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
403 Zwracany jest błąd z przyczyną niepowodzenia Nie* Oznaczenie pierwszego otwarcia getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Zadanie zwraca odpowiedź o powodzeniu, ale dane FDL będą puste Nie* Oznaczenie ponownego otwarcia getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Zadanie zwraca odpowiedź o powodzeniu, ale dane FDL będą puste Nie* Zaakceptuj zaproszenie Moduł AppInvite w Usługach Google Play jest wywoływany podczas obsługi przekierowania intencji (z *.page.link lub domeny niestandardowej) 400 Gdy wywoływane są Usługi Google Play, wyświetla się spinner, który znika po otrzymaniu odpowiedzi 400 Nie*
Jak przeprowadzić migrację z tej usługi?
Okazało się, że różni deweloperzy mają różne potrzeby w zakresie korzystania z Linków dynamicznych Firebase.
W zależności od Twoich przypadków użycia i oceny korzystania z Linków dynamicznych Firebase prawdopodobnie jeden z poniższych scenariuszy będzie odpowiadać Twoim potrzebom.
Co zrobić, jeśli potrzebuję pełnej zgodności funkcji z Linkami dynamicznymi Firebase?
W takim przypadku zalecamy korzystanie z usług innych dostawców precyzyjnych linków, takich jak Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava, Singular i innych podobnych dostawców. (Pamiętaj, że ci dostawcy nie zostali sprawdzeni przez Google, ale oferują funkcje podobne do Linków dynamicznych Firebase).
Możesz też wyeksportować metadane precyzyjnych linków, co ułatwi przeniesienie linków do wybranego dostawcy.
Aby znaleźć dostawcę z funkcjami pasującymi do Linków dynamicznych Firebase, zapoznaj się z poniższą listą funkcji.
Funkcje Linków dynamicznych Firebase:
- Kierowanie użytkowników do odpowiedniego sklepu na ich urządzeniu za pomocą jednego kliknięcia (w razie potrzeby następuje przekierowanie na stronę internetową).
- Umożliwianie użytkownikom kontynuowania ścieżki po pobraniu i zainstalowaniu aplikacji dzięki odroczonemu precyzyjnemu linkowi.
- Zapewnianie użytkownikom kontekstowych wrażeń dzięki treściom w aplikacji, do których prowadzą precyzyjne linki (gdy aplikacja jest już zainstalowana).
- Udostępnianie danych Analytics związanych ze zdarzeniami kliknięcia linku dynamicznego.
- Możliwość tworzenia adresów URL krótkich linków.
- Możliwość dodawania metadanych do linków na potrzeby udostępniania w mediach społecznościowych.
Co zrobić, jeśli zależy mi tylko na precyzyjnych linkach do mojej aplikacji po jej zainstalowaniu?
W takim przypadku zalecamy używanie linków do aplikacji i linków uniwersalnych, które są obsługiwane przez platformę i umożliwiają deweloperom tworzenie precyzyjnych linków dla użytkowników.
Więcej informacji o tym, jak przejść na linki do aplikacji i linki uniwersalne, znajdziesz w tym przewodniku .
W tym przewodniku opisujemy też, jak opcjonalnie używać Hostingu Firebase do hostowania niezbędnych plików weryfikacji domeny i linków do zasobów w domenie, której zamierzasz używać w nowych linkach (np. pliku assetlinks.json w przypadku linków do aplikacji, pliku apple-app-site-association w przypadku linków uniwersalnych).
Co zrobić, jeśli moja aplikacja nie potrzebuje już funkcji Linków dynamicznych Firebase i nie wymaga ich zastąpienia?
W takim przypadku być może nie musisz podejmować żadnych działań w aplikacji, aby przygotować się na wycofanie usługi. Zalecamy jednak:
Sprawdzenie dotychczasowych Linków dynamicznych Firebase zgodnie z przewodnikiem dotyczącym eksportowania metadanych linków, aby upewnić się, że użytkownicy i aplikacja nie zostaną dotknięci, gdy linki przestaną być obsługiwane.
Usunięcie prefiksów adresów URL Linków dynamicznych Firebase w konsoli Firebase. Uwaga: domeny z prefiksem adresu URL zostaną automatycznie usunięte po 25 sierpnia 2025 r.
Usunięcie pakietu SDK Linków dynamicznych Firebase z aplikacji.
Jeśli widzisz scenariusz migracji, który nie odpowiada Twoim potrzebom, skontaktuj się z nami.
Co zrobić po zakończeniu migracji?
Po zakończeniu migracji z Linków dynamicznych Firebase, usuń wszystkie prefiksy domen adresów URL (domeny FDL) powiązane z poprzednimi Linkami dynamicznymi Firebase w projekcie.
Aby to zrobić:
- Otwórz sekcję Linki dynamiczne Firebase w konsoli Firebase.
Po lewej stronie wybierz prefiks adresu URL, który chcesz usunąć
. Kliknij menu z 3 kropkami obok przycisku „Nowy link dynamiczny”
. Kliknij „Usuń prefiks adresu URL”.
Wpisz prefiks adresu URL, aby potwierdzić, że chcesz go usunąć, i kliknij „Usuń prefiks adresu URL”.
Gdy usuniesz wszystkie prefiksy domen adresów URL, Twój projekt Firebase zostanie oznaczony jako projekt, w którym zakończono migrację z Linków dynamicznych Firebase. Spowoduje to też usunięcie wyskakującego okienka z przypomnieniem, które mogło się pojawiać w konsoli Firebase w przypadku Twojego projektu.
Pamiętaj, że po wykonaniu tej czynności wszystkie Linki dynamiczne Firebase zostaną usunięte. Zanim usuniesz prefiksy domen adresów URL, upewnij się, że migracja z tej usługi została zakończona.
Czy nadal będę mieć możliwość korzystania z interfejsów API Linków dynamicznych Firebase?
Interfejsy API Linków dynamicznych Firebase do obsługi krótkich linków i Analytics będą dostępne do daty wycofania usługi, czyli do 25 sierpnia 2025 r.
Po tej dacie te interfejsy API nie będą już dostępne, a usługa zostanie wyłączona.
Jak wyeksportować metadane linków?
Instrukcje eksportowania metadanych linków znajdziesz w przewodniku dotyczącym eksportowania metadanych linków.
Jak uzyskać dane Analytics dotyczące linków dynamicznych Firebase?
Aby pobrać metadane Linków dynamicznych Firebase, w tym sam link, możesz skorzystać z przewodnika dotyczącego eksportowania.
Aby pobrać dane statystyczne dotyczące każdego z Linków dynamicznych Firebase, możesz użyć interfejsu Firebase Dynamic Links Analytics API. Ten interfejs API Analytics jest ograniczony do około 5 zapytań na sekundę. Przykład korzystania z interfejsu API w ramach tego limitu zapytań znajdziesz w tym przykładzie Cloud Tasks.
Możesz też użyć Google Analytics i wyeksportować dane dotyczące podzbioru danych Analytics dotyczących linków, w tym zdarzeń aktualizacji aplikacji , które są unikalne dla Google Analytics.
Jeśli do migracji potrzebujesz większej liczby zapytań, skontaktuj się z zespołem pomocy Firebase.
Co się stanie z metadanymi dotychczasowych linków po dacie wycofania usługi (25 sierpnia 2025 r.)?
Twoja domena i metadane linków zostaną oznaczone do usunięcia 25 sierpnia 2025 r. i usunięte zgodnie z naszymi zasadami przechowywania danych.
Wpływ Linków dynamicznych Firebase na przepływy uwierzytelniania Firebase
Chcę włączyć w uwierzytelnianiu Firebase uwierzytelnianie za pomocą linku e-mail w moim projekcie. Czy muszę wdrożyć Linki dynamiczne Firebase?
Nie, nie musisz wdrażać Linków dynamicznych Firebase, ponieważ nie jest to już możliwe. Zamiast tego możesz postępować zgodnie z zaktualizowanymi przewodnikami dotyczącymi rozpoczynania pracy z uwierzytelnianiem za pomocą linku e-mail, aby włączyć i wdrożyć je w swoim projekcie:
Zobacz pełną listę działań , na które ma wpływ ta zmiana.
Jak ta zmiana wpływa na te funkcje uwierzytelniania: uwierzytelnianie za pomocą linku e-mail, resetowanie hasła i weryfikacja adresu e-mail?
Uwierzytelnianie za pomocą linku e-mail i działania związane z pocztą e-mail poza pasmem w Firebase będą nadal działać. Aby jednak nadal korzystać z tych działań po wyłączeniu usługi Firebase Dynamic Links 25 sierpnia 2025 r., musisz przejść na najnowsze Firebase Authentication i przeprowadzić migrację do nowego rozwiązania.
Instrukcje dotyczące migracji znajdziesz w przewodnikach, do których linki podajemy poniżej:
Zobacz pełną listę działań, na które ma wpływ ta zmiana.
Jak ta zmiana wpływa na implementacje przepływu OAuth w pakietach SDK uwierzytelniania Firebase na Androida w wersjach wcześniejszych niż 20.0.0 lub w wersjach BoM wcześniejszych niż 26.0.0?
Aby nadal korzystać z implementacji przepływu OAuth w aplikacjach na Androida, musisz zaktualizować pakiet SDK uwierzytelniania Firebase na Androida do najnowszej wersji (co najmniej 20.0.0).
Czy ta zmiana wpływa na działania związane z pocztą e-mail w uwierzytelnianiu Firebase w aplikacjach internetowych?
Nie. Wycofanie Linków dynamicznych Firebase wpływa tylko na obsługę przychodzących adresów URL na urządzeniach mobilnych.
Jak ta zmiana wpływa na implementacje korzystające z bibliotek Firebase JS SDK do uwierzytelniania dostawców OAuth w aplikacji Cordova?
Pakiet Firebase JS SDK używa Linków dynamicznych Firebase do implementowania przepływów uwierzytelniania OAuth w aplikacjach Cordova. Musisz zmodyfikować implementację przepływu, wykonując przepływ OAuth ręcznie i przekazując wynikowe dane uwierzytelniające OAuth do Firebase, aby zakończyć przepływ uwierzytelniania.
Więcej informacji znajdziesz w przewodniku po Cordovie.
Jakie są alternatywne opcje dla Linków dynamicznych Firebase?
Zapoznaj się z sekcją „Jak przeprowadzić migrację z tej usługi?”, w której znajdziesz szczegółowe informacje o różnych scenariuszach migracji i przewodniki po migracji do różnych dostępnych alternatyw.