Najczęstsze pytania dotyczące wycofania linków dynamicznych

Uruchomiliśmy Linki dynamiczne Firebase 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 działania .

Z biegiem lat ekosystemy internetowe i mobilne ewoluowały dzięki technologiom takim jak App Links, Aplikacje błyskawiczne w Google Play , Universal Links i App Clips. Umożliwiły one użytkownikom aplikacji płynniejsze i bardziej przewidywalne korzystanie z aplikacji i internetu . Uważamy, że Ty i Twoi użytkownicy odniesiecie większe korzyści z bezpośredniego wdrożenia tych technologii i dalszego rozwoju ekosystemu. 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 aplikacji do aplikacji po jej zainstalowaniu, niezależnie od platformy.

Zamiast nadal obsługiwać mniej niż idealne rozwiązanie, 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 na rynku.

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 rozwoju 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ę zbliżania się daty wyłączenia usługi (25 sierpnia 2025 r.) oraz w przypadku wykrycia dodatkowych problemów podczas pomocy w migracji.

Odpowiedzi na niektóre z najważniejszych pytań znajdziesz w sekcji Najczęstsze pytania poniżej.

Aby rozpocząć migrację, zapoznaj się z odpowiedzią na pytanie „Jak przeprowadzić migrację z tej usługi?” poniżej.

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ę?

Na przeprowadzenie migracji masz czas do 25 sierpnia 2025 r.

Tak, nowe i dotychczasowe linki będą nadal działać do momentu wyłączenia usługi Linki dynamiczne 25 sierpnia 2025 r.

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.

Po wyłączeniu Linków dynamicznych Firebase:

  • Wszystkie kliknięte linki będą zwracać użytkownikom kod stanu HTTP 404.
  • Wszystkie żądania HTTP wysyłane do tych adresów URL:

    • 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.

  • Powyższe odpowiedzi z błędami będą stopniowo pojawiać się od 25 sierpnia 2025 r., aż po dacie wyłączenia usługi osiągną 100%.

  • Poniżej opisano zachowanie w zależności od wersji platformy pakietu 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 Błąd jest emitowany z przyczyną niepowodzenia Nie*
    Oznaczenie pierwszego otwarcia

    Wywoływane automatycznie w przypadku FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

    400 Nie są emitowane żadne błędy, ale obiekt FDL jest odsyłany z pustymi danymi Nie*
    Oznaczenie ponownego otwarcia

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 Błąd jest emitowany 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 Błąd jest emitowany 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 domeny *.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.

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 na rynku. (Pamiętaj, że ci dostawcy nie zostali sprawdzeni przez Google, ale oferują podobne funkcje jak Linki dynamiczne 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 korzystania z aplikacji po jej pobraniu i zainstalowaniu dzięki odroczonemu precyzyjnemu linkowi.
  • Zapewnianie użytkownikom kontekstowego korzystania z aplikacji dzięki treściom połączonym za pomocą precyzyjnych linków (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 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 migracji do linków do aplikacji i linków uniwersalnych 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).

W takim przypadku być może nie musisz podejmować żadnych działań w aplikacji, aby przygotować się na wyłączenie 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 będą mieć problemów, gdy linki przestaną być obsługiwane.

  • Usunięcie prefiksów adresów URL Linków dynamicznych Firebase w konsoli Firebase. Uwaga: domeny prefiksów adresów 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ć:

  1. Otwórz sekcję Linki dynamiczne Firebase w konsoli Firebase.
  2. Po lewej stronie wybierz prefiks adresu URL, który chcesz usunąć Zrzut ekranu konsoli Linków dynamicznych Firebase przedstawiający selektor prefiksu ścieżki adresu URL.

  3. Kliknij menu z 3 kropkami obok przycisku „Nowy link dynamiczny” Zrzut ekranu z konsoli Linków dynamicznych Firebase przedstawiający opcje prefiksu ścieżki adresu URL.

  4. Kliknij „Usuń prefiks adresu URL”.

  5. 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 w 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 ta czynność spowoduje usunięcie wszystkich Linków dynamicznych Firebase. Zanim usuniesz prefiksy domen adresów URL, upewnij się, że migracja z tej usługi została zakończona.

Interfejsy API Linków dynamicznych Firebase do obsługi krótkich linków i Analytics będą dostępne do daty wyłączenia 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.

Instrukcje eksportowania metadanych linków znajdziesz w przewodniku dotyczącym eksportowania metadanych linków.

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 API Analytics Firebase Linków dynamicznych. 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ą dostępne tylko w Google Analytics.

Jeśli do przeprowadzenia migracji potrzebujesz większej liczby zapytań, skontaktuj się z zespołem pomocy Firebase pod adresem Firebase Support.

Twoja domena i metadane linków zostaną oznaczone do usunięcia 25 sierpnia 2025 r. i usunięte zgodnie z naszymi zasadami przechowywania danych.

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ć tę funkcję w swoim projekcie:

Zobacz pełną listę działań , na które ma wpływ ta zmiana.

Uwierzytelnianie za pomocą linku e-mail i działania związane z pocztą e-mail poza pasmem w 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 Firebase Authentication pakiety SDK i przeprowadzić migrację do nowego rozwiązania.

Instrukcje dotyczące przeprowadzenia 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 protokołu OAuth z pakietami Android SDK Uwierzytelniania Firebase w wersjach wcześniejszych niż 20.0.0 lub wersjami BoM wcześniejszymi 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 pakietu 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, przeprowadzają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.

Zapoznaj się z odpowiedzią na pytanie „Jak przeprowadzić migrację z tej usługi?”, w której opisujemy różne scenariusze migracji i udostępniamy przewodniki po migracji do różnych dostępnych alternatyw.