Linki dynamiczne Firebase zostały wprowadzone ponad 7 lat temu, aby zwiększyć możliwości adresów URL, np. dynamicznie zmieniać miejsce docelowe linku na podstawie warunków w czasie wykonywania.
W ciągu ostatnich lat ekosystemy internetowe i mobilne ewoluowały wraz z rozwojem takich technologii jak App Links, Google Play Instant, Universal Links i App Clips, co zaowocowało płynniejszym i bardziej przewidywalnym przebiegiem ścieżki użytkownika w aplikacjach i w internecie. Wierzymy, że Ty i Twoi użytkownicy zyskacie więcej, jeśli wprowadzicie te technologie bezpośrednio i będziecie dalej rozwijać ten ekosystem. Jednak wraz z tymi nowymi zmianami ewoluowały też pierwotne natywne interfejsy API, na których oparte są Linki dynamiczne Firebase, co wiązało się z nowymi wyzwaniami.
Na przykład zmiany w ekosystemie wpłynęły na naszą zdolność do zapewnienia stabilnego działania jednej z podstawowych funkcji Dynamic Links Firebase, która umożliwia użytkownikom płynne przejście do aplikacji po jej zainstalowaniu niezależnie od platformy.
Zamiast kontynuować obsługę funkcji, która nie działała idealnie, zdecydowaliśmy się wycofać Linki dynamiczne Firebase i skoncentrować się na rozwiązywaniu innych problemów, z którymi borykają się deweloperzy.
Zdajemy sobie sprawę, że ta zmiana wymaga czasu na ocenę i wdrożenie alternatywnych rozwiązań lub platform dostępnych na rynku.
Wraz z rozwojem i zmianami w ekosystemie stale ulepszamy Firebase, aby spełniał Twoje potrzeby. Będziemy nadal wdrażać nowe funkcje i aktualizacje w usługach Firebase, aby pomagać Ci w doskonaleniu procesu tworzenia aplikacji.
Co muszę wiedzieć?
25 sierpnia 2025 r. usługa Linki dynamiczne Firebase zostanie zamknięta. Wszystkie linki udostępniane przez Linki dynamiczne Firebase (zarówno te hostowane na domenach niestandardowych, jak i na subdomenach page.link) przestaną działać, a Ty nie będziesz już mieć możliwości tworzenia nowych linków.
Aby pomóc Ci w podjęciu decyzji o sposobie migracji z Linków dynamicznych Firebase, będziemy nadal aktualizować ten dokument z najczęściej zadawanymi pytaniami, dodając do niego dodatkowe informacje, a także udostępniać przewodniki po różnych scenariuszach migracji, które mogą odpowiadać sposobowi, w jaki obecnie używasz Linków dynamicznych Firebase.
Będziemy też na bieżąco aktualizować ten przewodnik o kolejne odpowiedzi na najczęstsze pytania, gdy zbliżać się będzie termin wycofania usługi, czyli 25 sierpnia 2025 r., oraz gdy będziemy odkrywać kolejne problemy, które mogą utrudnić Ci migrację.
Zapoznaj się z poniżej najczęstszymi pytaniami, aby znaleźć odpowiedzi na najważniejsze pytania.
Aby rozpocząć migrację, zapoznaj się z odpowiedziami na najczęstsze pytania dotyczące migracji z usługi.
Kiedy Linki dynamiczne Firebase przestaną działać?
25 sierpnia 2025 r. usługa Linki dynamiczne Firebase zostanie zamknięta. 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 mam czasu na przeprowadzenie migracji?
Na przeprowadzenie migracji masz czas do 25 sierpnia 2025 r.
Czy nowe i dotychczasowe linki będą nadal działać?
Tak. Nowe i dotychczasowe linki będą działać do 25 sierpnia 2025 r., kiedy usługa Dynamic Links zostanie zamknięta.
Co się stanie z moimi linkami i moimi aplikacjami, gdy wycofamy Linki dynamiczne Firebase (25 sierpnia 2025 r.)?
Po wycofaniu Linków dynamicznych Firebase:
- Wszystkie kliknięte linki zwrócą użytkownikom kod stanu HTTP 404.
Wszystkie żądania HTTP do:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (interfejs API Link Stats)
zwróci kod stanu HTTP 400 lub 403.
Zależy on to, z której wersji platformy pakietu SDK i z jakiego wywołania interfejsu API korzysta Twoja aplikacja:
iOS
Przypadek użycia Wywołanie interfejsu API Kod stanu Zachowanie Czy aplikacja ulegnie awarii? Tworzenie krótkiego linku shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
400 Wystąpił błąd z powodem Nie* Atrybucja pierwszego uruchomienia Jest wywoływany automatycznie w metodach FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C).
400 Nie występują żadne błędy, ale zwracany jest obiekt FDL z pustymi danymi. Nie* Ponownie otwieranie atrybucji handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 Wystąpił błąd z powodem Nie* Android
Przypadek użycia Wywołanie interfejsu API Kod stanu Zachowanie Czy aplikacja ulegnie awarii? Tworzenie krótkiego linku buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
400 Wystąpił błąd z powodem Nie* Atrybucja pierwszego uruchomienia getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Zadanie zwraca odpowiedź o sukcesie, ale dane FDL będą puste Nie* Ponownie otwieranie atrybucji getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Zadanie zwraca odpowiedź o sukcesie, ale dane FDL będą puste Nie* Zaakceptuj zaproszenie Moduł AppInvite w Usługach Google Play wywoływany podczas obsługi przekierowania intencji (z *.page.link lub domeny niestandardowej) 400 Po wywołaniu Usług Google Play wyświetla się wskaźnik postępu, który znika, gdy zwrócona zostanie odpowiedź 400. Nie*
Jak przeprowadzić migrację z usługi?
Zauważyliśmy, że deweloperzy mają różne potrzeby dotyczące korzystania z linków dynamicznych Firebase.
W zależności od Twoich przypadków użycia i oceny korzystania z linków dynamicznych Firebase możesz potrzebować jednego z tych scenariuszy.
Co zrobić, jeśli potrzebujesz pełnej zgodności z Linkami dynamicznymi Firebase?
W tym przypadku zalecamy korzystanie z usług innych dostawców, np. Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava i innych podobnych dostawców na rynku. (Uwaga: ci dostawcy nie zostali zweryfikowani przez Google, ale oferują funkcje podobne do linków dynamicznych Firebase).
Możesz też eksportować metadane linków głębokich, co ułatwi przeniesienie linków do wybranego dostawcy.
Aby ułatwić znalezienie dostawcy z funkcjami podobnymi do Linków dynamicznych Firebase, zapoznaj się z poniższą listą funkcji.
Funkcje Linków dynamicznych Firebase:
- przekierowuje użytkowników do odpowiedniego sklepu dla ich urządzenia za pomocą jednego kliknięcia (a w razie potrzeby przekierowuje do strony internetowej);
- umożliwiają kontynuowanie przez użytkowników ścieżki po pobraniu i zainstalowaniu aplikacji, gdy wyświetlą odroczony precyzyjny link;
- Zapewnia użytkownikom wrażenia zależne od kontekstu dzięki precyzyjnym linkom do treści w aplikacji (jeśli jest już zainstalowana).
- Udostępnia dane analityczne związane ze zdarzeniami kliknięcia dynamicznego linku.
- Umożliwia tworzenie adresów URL krótkich linków.
- Umożliwia dodawanie metadanych do linków do udostępniania w mediach społecznościowych
Co zrobić, jeśli zależy mi tylko na precyzyjnych linkach do aplikacji, która jest już zainstalowana?
W takim przypadku zalecamy korzystanie z linków do aplikacji i uniwersalnych linków, które są obsługiwane na platformach i umożliwiają deweloperom udostępnianie użytkownikom precyzyjnych linków.
Więcej informacji o przechodzeniu na korzystanie z linków aplikacji i uniwersalnych linków znajdziesz w tym przewodniku.
W tym przewodniku znajdziesz też informacje o tym, jak opcjonalnie używać Hostingu Firebase do hostowania niezbędnych plików weryfikacji domeny i linków do zasobów w domenie, której planujesz używać do nowych linków (np. pliku assetlinks.json w przypadku linków do aplikacji lub pliku apple-app-site-association w przypadku uniwersalnych linków).
Co zrobić, jeśli moja aplikacja nie potrzebuje już funkcji Linków dynamicznych Firebase i nie potrzebuje ich zamiennika?
W tym przypadku nie musisz podejmować żadnych działań w aplikacji, aby obsłużyć nadchodzący zachód słońca. Zalecamy jednak:
Sprawdź i zaktualizuj istniejące Linki dynamiczne Firebase zgodnie z przewodnikiem po eksporcie metadanych linków, aby mieć pewność, że użytkownicy i aplikacja nie odczują negatywnych skutków, gdy linki przestaną być wyświetlane.
usunąć prefiksy adresów URL Linków dynamicznych Firebase w konsoli Firebase. Uwaga: domeny z prefiksem URL zostaną automatycznie usunięte 25 sierpnia 2025 r.
usunięcie z aplikacji pakietu SDK Linków dynamicznych Firebase.
Jeśli widzisz scenariusz migracji, który nie odpowiada Twoim potrzebom, skontaktuj się z nami
Czy nadal będę mieć dostęp do interfejsów API Linków dynamicznych Firebase?
Interfejsy API Linków dynamicznych Firebase do Short Links i Analytics będą dostępne do 25 sierpnia 2025 r., kiedy zostaną wycofane.
Po tej dacie interfejsy API nie będą już dostępne, a usługa zostanie wyłączona.
Jak wyeksportować metadane linku?
Instrukcje eksportowania metadanych linku znajdziesz w przewodniku.
Jak mogę uzyskać dane analityczne dotyczące linków Linki dynamiczne Firebase?
Możesz użyć przewodnika eksportowania, aby pobrać metadane Linków dynamicznych Firebase, które obejmują sam link.
Aby pobrać dane statystyczne dotyczące każdego z Twoich Linków dynamicznych Firebase, możesz użyć interfejsu Firebase Dynamic Links Analytics API. Ten interfejs API Analytics jest ograniczony do ok. 5 zapytań na sekundę. Przykład działania w ramach tego limitu żądań podczas korzystania z interfejsu API znajdziesz w tym przykładowym zadaniu Cloud Task.
Możesz też korzystać z Google Analytics i eksportować dane dotyczące podzbioru danych analitycznych dotyczących linków, w tym zdarzenia App Updates, które są unikalne dla Google Analytics.
Jeśli potrzebujesz wyższej częstotliwości żądań, aby ułatwić migrację, skontaktuj się z zespołem pomocy Firebase.
Co się stanie z metadanymi dotychczasowych linków po dacie wycofania (25 sierpnia 2025 r.)?
Metadane Twojej domeny i linków zostaną oznaczone do usunięcia 25 sierpnia 2025 r. i trwale usunięte zgodnie z naszymi zasadami przechowywania danych.
Wpływ Linków dynamicznych Firebase na przepływy danych w Uwierzytelnianiu Firebase
Chcę włączyć uwierzytelnianie za pomocą linku e-mail w Uwierzytelnianiu Firebase w moim projekcie. Czy muszę wdrożyć Linki dynamiczne Firebase?
Nie, nie musisz konfigurować linków dynamicznych Firebase, ponieważ nie jest to już możliwe. Zamiast tego możesz skorzystać z aktualizowanych przewodników dotyczących konfigurowania uwierzytelniania za pomocą linku e-mail, aby włączyć i zastosować to rozwiązanie w swoim projekcie:
Zobacz pełną listę czynności, których dotyczy ta zmiana.
Jakie są konsekwencje tych zmian dla funkcji uwierzytelniania: uwierzytelniania za pomocą linku e-mail, resetowania hasła i weryfikacji adresu e-mail?
Połączenie uwierzytelniania za pomocą e-maila i działania e-mailowe poza Firebase będą nadal działać, ale aby nadal korzystać z tych działań po wyłączeniu usługi Firebase Dynamic Links 25 sierpnia 2025 r., musisz przejść na najnowsze pakiety SDK Firebase Authentication i przeprowadzić migrację do nowego rozwiązania.
Aby dowiedzieć się, jak przeprowadzić migrację, skorzystaj z poniższych przewodników:
Zobacz pełną listę czynności, na które ma wpływ ta zmiana.
Jakie są konsekwencje dla implementacji procesu OAuth w przypadku pakietu SDK uwierzytelniania Firebase na Androida w wersji niższej niż 20.0.0 lub pakietu SDK wersji BoM niższej niż 26.0.0?
Aby nadal korzystać z implementacji procesu OAuth w aplikacjach na Androida, musisz zaktualizować pakiet SDK uwierzytelniania Firebase na Androida do najnowszej wersji (co najmniej 20.0.0).
Czy działania związane z e-mailami w Uwierzytelnianiu Firebase w aplikacjach internetowych zostały zmienione?
Nie. Wycofanie obsługi linków dynamicznych Firebase ma wpływ tylko na obsługę przychodzących adresów URL na urządzeniach mobilnych.
Jakie są konsekwencje dla implementacji, które używają bibliotek pakietu Firebase JS SDK do uwierzytelniania dostawców OAuth w aplikacji Cordova?
Tak. Pakiet Firebase JS SDK używa linków dynamicznych Firebase do implementowania procesu uwierzytelniania OAuth. Aby dokończyć proces uwierzytelniania, musisz zmodyfikować implementację tego procesu, wykonując ręcznie proces OAuth i przekazując uzyskane dane logowania OAuth do Firebase.
Więcej informacji znajdziesz w przewodniku po Cordova.
Jakie są alternatywne opcje dla Linków dynamicznych Firebase?
Zapoznaj się z artykułem "Jak przejść na inną usługę?", w którym omówiono różne scenariusze migracji i zamieszczono przewodniki po różnych dostępnych opcjach.