Ponad 7 lat temu wprowadziliśmy Linki dynamiczne Firebase, aby zwiększyć możliwości adresów URL, np. dynamicznie zmieniać miejsce docelowe linku na podstawie warunków w czasie działania.
Przez lata ekosystemy internetowe i mobilne ewoluowały dzięki technologiom takim jak linki do aplikacji, Aplikacja błyskawiczna w Google Play, uniwersalne linki i wycinki aplikacji, dzięki czemu ścieżki użytkowników w aplikacjach i internecie stały się bardziej płynne i przewidywalne dla użytkowników aplikacji. Uważamy, że Ty i Twoi użytkownicy odniesiecie większe korzyści z bezpośredniego wdrożenia tych technologii i dalszego rozwijania ekosystemu. Jednak wraz z tymi nowymi zmianami oryginalne natywne interfejsy API, na których opierały się Linki dynamiczne Firebase, również ewoluowały i stwarzały nowe wyzwania.
Na przykład zmiany w ekosystemie wpłynęły na naszą zdolność do zapewniania stabilnego działania jednej z głównych funkcji Linków dynamicznych Firebase, czyli płynnego przechodzenia użytkowników do aplikacji po jej zainstalowaniu, niezależnie od platformy.
Zamiast nadal wspierać rozwiązanie, które nie jest idealne, postanowiliśmy wycofać Linki dynamiczne Firebase i skupić się na rozwiązywaniu innych problemów deweloperów.
Zdajemy sobie sprawę, że ta zmiana będzie wymagać czasu na ocenę i wdrożenie alternatywnych rozwiązań lub platform dostępnych na rynku.
Stale rozwijamy Firebase, aby spełniać Twoje potrzeby w miarę rozwoju i zmian ekosystemu. Będziemy nadal wprowadzać nowe funkcje i aktualizacje w usługach Firebase, aby pomagać Ci w tworzeniu aplikacji.
Co muszę wiedzieć?
25 sierpnia 2025 r. wyłączymy linki dynamiczne Firebase. Wszystkie linki obsługiwane przez Linki dynamiczne Firebase (zarówno te hostowane w domenach niestandardowych, jak i subdomenach page.link) przestaną działać i nie będzie już można tworzyć nowych linków.
Aby pomóc Ci podjąć decyzję o migracji z Linków dynamicznych Firebase, będziemy nadal aktualizować ten dokument z najczęstszymi pytaniami, dodając do niego dodatkowe informacje, które warto wziąć pod uwagę. Będziemy też udostępniać przewodniki po migracji w przypadku różnych scenariuszy, które mogą odpowiadać sposobowi, w jaki obecnie korzystasz z Linków dynamicznych Firebase.
Będziemy też na bieżąco aktualizować ten przewodnik o kolejne najczęstsze pytania, w miarę jak będziemy zbliżać się do daty wycofania, czyli 25 sierpnia 2025 r., i będziemy odkrywać kolejne problemy podczas udzielania pomocy w migracji.
Poniżej znajdziesz odpowiedzi na niektóre z najważniejszych pytań.
Aby rozpocząć migrację, zapoznaj się z odpowiedzią na pytanie „Jak przeprowadzić migrację z tej usługi?” w sekcji Najczęstsze pytania poniżej.
Kiedy Linki dynamiczne Firebase przestaną działać?
25 sierpnia 2025 r. wyłączymy linki dynamiczne Firebase. Wszystkie linki obsługiwane przez Linki dynamiczne Firebase (zarówno te hostowane we własnych domenach, jak i w subdomenach page.link) przestaną działać.
Ile czasu będę mieć na migrację?
Na zakończenie 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 momentu wyłączenia usługi Linki dynamiczne 25 sierpnia 2025 r.
Czy mogę zachować lub przenieść automatycznie udostępnione domeny .page.link używane do linków?
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. 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ług precyzyjnych linków przy użyciu nowej domeny.
Co się stanie z moimi linkami i aplikacjami, gdy usługa Linki dynamiczne Firebase zostanie wycofana (25 sierpnia 2025 r.)?
Po wycofaniu Linków dynamicznych Firebase:
- Wszystkie kliknięte linki będą zwracać użytkownikom odpowiedź o stanie HTTP 404.
Wszystkie żądania HTTP do:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (Link Stats API)
zwróci odpowiedź ze stanem HTTP 400/403.
Odpowiedzi z błędem zaczną się pojawiać stopniowo od 25 sierpnia 2025 r., aż po dacie wycofania osiągną 100%.
W zależności od wersji platformy SDK i wywołania interfejsu API w 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 Zostanie wygenerowany błąd z przyczyną niepowodzenia. Nie* Atrybucja pierwszego uruchomienia Jest wywoływana automatycznie w FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C).
400 Nie są generowane żadne błędy, ale obiekt FDL jest odsyłany z pustymi danymi. Nie* Ponowne otwarcie atrybucji handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 Zostanie wygenerowany 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 Zostanie wygenerowany błąd z przyczyną niepowodzenia. Nie* Atrybucja pierwszego uruchomienia getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Zadanie zwraca odpowiedź o powodzeniu, ale dane FDL będą puste. Nie* Ponowne otwarcie atrybucji 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 wywoływany podczas obsługi przekierowania intencji (z *.page.link lub własnej domeny) 400 Wyświetla wskaźnik oczekiwania, gdy wywoływane są Usługi Google Play, i znika, gdy zwracana jest odpowiedź 400. Nie*
Jak przeprowadzić migrację z tej usługi?
Zauważyliśmy, że deweloperzy mają różne potrzeby, jeśli chodzi o korzystanie z linków dynamicznych Firebase.
W zależności od przypadków użycia i oceny wykorzystania 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 podobnych. (Uwaga: ci dostawcy nie zostali zweryfikowani przez Google, ale oferują podobne funkcje co Firebase Dynamic Links).
Możesz też wyeksportować metadane precyzyjnych linków, co ułatwi przeniesienie linków do wybranego dostawcy.
Aby znaleźć dostawcę, który oferuje funkcje podobne do Linków dynamicznych Firebase, zapoznaj się z poniższą listą funkcji.
Funkcje Linków dynamicznych Firebase:
- Kieruje użytkowników do odpowiedniego sklepu na ich urządzeniu za pomocą jednego kliknięcia (i w razie potrzeby przekierowuje na stronę internetową).
- Umożliwia użytkownikom kontynuowanie ścieżki po pobraniu i zainstalowaniu aplikacji za pomocą odroczonego precyzyjnego linku.
- zapewniają użytkownikom kontekstowe wrażenia dzięki precyzyjnym linkom do treści w aplikacji (jeśli jest już zainstalowana);
- Dostarcza dane analityczne związane ze zdarzeniami kliknięcia linku dynamicznego
- Umożliwia tworzenie krótkich adresów URL.
- Umożliwia dodawanie metadanych do linków w celu udostępniania w mediach społecznościowych.
Co zrobić, jeśli interesuje mnie tylko precyzyjne linkowanie do aplikacji po jej zainstalowaniu?
W tym przypadku zalecamy korzystanie z linków do aplikacji i uniwersalnych linków, które są obsługiwanymi przez platformę sposobami na zapewnienie użytkownikom precyzyjnych linków.
Więcej informacji o przechodzeniu na linki aplikacji i uniwersalne linki znajdziesz w tym przewodniku.
Z tego przewodnika dowiesz się 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 planujesz używać w przypadku nowych linków (np. pliku assetlinks.json w przypadku linków do aplikacji, 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 wymaga ich zastąpienia?
W tym przypadku nie musisz podejmować żadnych działań w aplikacji, aby przygotować się na nadchodzące wycofanie, ale zalecamy:
Sprawdź istniejące Linki dynamiczne Firebase, postępując zgodnie z przewodnikiem po eksportowaniu metadanych linków, aby mieć pewność, że po zaprzestaniu wyświetlania linków nie będzie to miało wpływu na użytkowników ani aplikację.
Usuwanie prefiksów adresów URL linków dynamicznych Firebase w konsoli Firebase. Uwaga: domeny z prefiksem URL zostaną automatycznie usunięte po 25 sierpnia 2025 r.
Usuń pakiet SDK Linków dynamicznych Firebase z aplikacji.
Jeśli widzisz scenariusz migracji, który nie odpowiada Twoim potrzebom, skontaktuj się z nami i poinformuj nas o tym.
Co muszę zrobić po zakończeniu migracji?
Po zakończeniu migracji z Firebase Dynamic Links usuń z projektu wszystkie prefiksy domen URL (domeny FDL) powiązane z poprzednimi linkami dynamicznymi Firebase.
Możesz to zrobić na kilka sposobów:
- Otwieranie sekcji Linki dynamiczne Firebase w konsoli Firebase
Wybierz prefiks adresu URL, który chcesz usunąć, w selektorze po lewej stronie.
Kliknięcie menu z 3 kropkami obok przycisku „Nowy link dynamiczny”
Kliknięcie „Usuń prefiks adresu URL”
wpisanie prefiksu adresu URL, aby potwierdzić, że chcesz go usunąć, i kliknięcie „Usuń prefiks adresu URL”;
Gdy usuniesz wszystkie prefiksy domen URL, projekt w Firebase zostanie oznaczony jako taki, w którym zakończono migrację z Linków dynamicznych Firebase. Spowoduje to też usunięcie wyskakującego przypomnienia, które mogło się pojawić w konsoli Firebase w przypadku Twojego projektu.
Pamiętaj, że spowoduje to usunięcie wszystkich linków dynamicznych Firebase, więc przed usunięciem prefiksów domen URL upewnij się, że migracja z tej usługi została w pełni 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 krótkich linków i Analytics będą dostępne do daty wycofania, 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 mogę wyeksportować metadane linku?
Instrukcje eksportowania metadanych linków znajdziesz w przewodniku po eksportowaniu metadanych linków.
Jak uzyskać dane analityczne dotyczące linków dynamicznych Firebase?
Aby pobrać metadane Linków dynamicznych Firebase, w tym sam link, możesz skorzystać z przewodnika po eksportowaniu.
Możesz użyć interfejsu Firebase Dynamic Links Analytics API, aby pobrać statystyki dotyczące każdego z linków dynamicznych Firebase. Ten interfejs API Analytics jest ograniczony do ok. 5 zapytań na sekundę. Przykład pokazujący, jak działać w ramach tego limitu żądań podczas korzystania z interfejsu API, znajdziesz w tym przykładzie Cloud Task.
Możesz też używać Google Analytics i eksportować dane, aby uzyskać podzbiór danych statystycznych dotyczących linków, w tym zdarzenia aktualizacji aplikacji, które są unikalne dla Google Analytics.
Jeśli potrzebujesz wyższej częstotliwości żądań, aby ułatwić migrację, skontaktuj się z nami, pisząc na adres Firebase Support.
Co się stanie z metadanymi dotychczasowych linków po dacie wycofania (25 sierpnia 2025 r.)?
Twoja domena i metadane linków zostaną oznaczone do usunięcia 25 sierpnia 2025 r. i zostaną trwale usunięte zgodnie z naszymi zasadami przechowywania danych.
Wpływ Linków dynamicznych Firebase na przepływy uwierzytelniania Firebase
Chcę włączyć uwierzytelnianie za pomocą linku w e-mailu w Uwierzytelnianiu Firebase w moim projekcie. Czy muszę skonfigurować Linki dynamiczne Firebase?
Nie, nie musisz wdrażać Linków dynamicznych Firebase, ponieważ nie jest to już możliwe. Zamiast tego możesz skorzystać ze zaktualizowanych przewodników dotyczących rozpoczynania korzystania z uwierzytelniania za pomocą linku w e-mailu, aby włączyć i wdrożyć tę funkcję w swoim projekcie:
Wyświetl pełną listę działań, których dotyczy ta zmiana.
Jakie zmiany zostaną wprowadzone w tych funkcjach uwierzytelniania: uwierzytelnianie za pomocą linku w e-mailu, resetowanie hasła i potwierdzanie adresu e-mail?
Uwierzytelnianie za pomocą linku w e-mailu i działania związane z e-mailami poza pasmem w Firebase będą nadal działać, ale aby móc dalej 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 nowe rozwiązanie.
Aby dowiedzieć się, jak przeprowadzić migrację, zapoznaj się z przewodnikami, do których linki znajdziesz poniżej:
Zobacz pełną listę działań, których dotyczy ta zmiana.
Jakie skutki będzie miało to wycofanie dla implementacji procesu OAuth z pakietem SDK Firebase Authentication na Androida w wersji poniżej 20.0.0 lub z BoM w wersji poniżej 26.0.0?
Aby nadal korzystać z implementacji procesu protokołu OAuth w aplikacjach na Androida, musisz zaktualizować pakiet Android SDK Uwierzytelniania Firebase do najnowszej wersji (co najmniej 20.0.0).
Czy ma to wpływ na działania związane z e-mailami w ramach Uwierzytelniania Firebase w aplikacjach internetowych?
Nie. Wycofanie Linków dynamicznych Firebase ma wpływ tylko na obsługę przychodzących adresów URL na urządzeniach mobilnych.
Jakie zmiany czekają implementacje, które używają bibliotek pakietu Firebase JS SDK do uwierzytelniania dostawców OAuth w aplikacji Cordova?
Pakiet SDK Firebase JS używa Linków dynamicznych Firebase do implementacji przepływów uwierzytelniania OAuth w aplikacjach Cordova. Musisz zmodyfikować implementację procesu, przeprowadzając proces OAuth ręcznie i przekazując wynikowe dane uwierzytelniające OAuth do Firebase, aby zakończyć proces uwierzytelniania.
Więcej informacji znajdziesz w przewodniku po Cordova.
Jakie są alternatywne opcje dla Linków dynamicznych Firebase?
Zapoznaj się z najczęstszymi pytaniami dotyczącymi migracji z usługi, w których szczegółowo opisano różne scenariusze migracji i podano przewodniki po migracji dotyczące różnych dostępnych alternatyw.