Możesz mieć większą kontrolę nad brandingiem Dynamic Links, używając własnej domeny zamiast subdomeny page.link. Dzięki własnym domenom możesz tworzyć Dynamic Links, takie jak te:
https://example.com/link-suffix https://example.com/links/promos/link-suffix https://links.example.com/link-suffix https://ex.amp.le/link-suffix
Część adresu URL przed link-suffix to prefiks adresu URL, który zawiera zarówno Twoją domenę niestandardową Dynamic Link, jak i prefiks ścieżki. Podczas tworzenia Dynamic Links musisz podać prefiks adresu URL.
Skonfigurowanie własnej domeny wymaga uprawnień edytującego lub właściciela w projekcie Firebase.
Używanie domeny internetowej w usłudze Dynamic Links
Możesz używać tej samej domeny w przypadku Dynamic Links i stron internetowych, uniwersalnych linków oraz linków aplikacji, ale jeśli to zrobisz, musisz zadbać o to, aby adresy URL Dynamic Link nie kolidowały z adresami URL stron internetowych. Gdy skonfigurujesz Dynamic Links tak, aby używać określonego prefiksu adresu URL, wszystkie adresy URL zaczynające się od tego prefiksu będą traktowane jako Dynamic Links, więc nie możesz używać adresów URL z tym prefiksem do wskazywania zwykłych hostowanych treści.
Jeśli na przykład chcesz utworzyć Dynamic Link do zasobu https://example.com/my-resource (strony internetowej, uniwersalnego linku lub linku aplikacji), nie możesz użyć https://example.com/ jako prefiksu adresu URL Dynamic Links, ponieważ spowodowałoby to, że zasób https://example.com/my-resource byłby traktowany jako Dynamic Link.
Zamiast tego musisz użyć prefiksu adresu URL z inną domeną lub innym prefiksem ścieżki.
Dlatego poniższy długi link Dynamic Links (oraz odpowiadające mu krótkie linki) nie będzie działać zgodnie z oczekiwaniami, ponieważ adresy URL określone przez parametr link zaczynają się od prefiksu adresu URL Dynamic Link, https://example.com/:
https://example.com/?link=https://example.com/my-resource https://example.com/?link=https://example.com/resources/my-resource
Jednak te długie linki Dynamic Links (i odpowiadające im krótkie linki) mogą działać, ponieważ ich prefiksy nie kolidują z adresami URL link:
https://link.example.com/?link=https://example.com/my-resource https://example.com/links/?link=https://example.com/my-resource https://ex.amp.le/?link=https://example.com/my-resource
Konfigurowanie własnej domeny w konsoli Firebase
Własną domenę możesz zwykle skonfigurować całkowicie w konsoli Firebase. Aby to zrobić:
Jeśli nie masz skonfigurowanej usługi Firebase Hosting w projekcie, otwórz stronę Hosting w konsoli Firebase, kliknij Rozpocznij i postępuj zgodnie z instrukcjami konfiguracji. Nie musisz teraz wykonywać wskazanych czynności.
Otwórz stronę Dynamic Links w konsoli Firebase.
Jeśli korzystasz z Dynamic Links po raz pierwszy, kliknij Rozpocznij. W przeciwnym razie w menu kliknij Dodaj prefiks URL-a.
Następnie przejdź proces konfiguracji zgodnie z kreatorem konfiguracji, podając domenę i prefiks ścieżki, których chcesz użyć, gdy pojawi się odpowiedni komunikat.
Tylko iOS: w pliku
Info.plistprojektu Xcode utwórz klucz o nazwieFirebaseDynamicLinksCustomDomainsi ustaw go na prefiksy adresów URL Dynamic Links aplikacji. Na przykład:<key>FirebaseDynamicLinksCustomDomains</key> <array> <string>https://example.com/link</string> <string>https://example.com/promos</string> </array>
Ręczne konfigurowanie własnej domeny
W niektórych sytuacjach, np. gdy masz już skonfigurowaną własną domenę dla Dynamic Links i chcesz dodać kolejną domenę lub gdy dodajesz domenę, która jest już połączona z witryną Hosting, musisz skonfigurować własną domenę ręcznie.
Aby to zrobić:
Połącz swoją domenę z Firebase Hosting, jeśli jeszcze nie zostało to zrobione.
Konfigurowanie domeny za pomocą Firebase Hosting obejmuje utworzenie pliku konfiguracji
firebase.jsonw lokalnym katalogu projektu.Zaktualizuj interfejs wiersza poleceń Firebase do najnowszej wersji (6.5.0 lub nowszej).
Skonfiguruj witrynę Hosting pod kątem Dynamic Links w pliku
firebase.jsonprojektu. Jeśli w projekcie masz kilka witryn, skonfiguruj witrynę połączoną z domeną, której chcesz używać.Ustaw
appAssociationnaAUTO. Przy tym ustawieniu Hosting dynamicznie generuje plikiassetlinks.jsoniapple-app-site-association, gdy są potrzebne.Określ prefiksy ścieżek, których chcesz używać w przypadku Dynamic Links, ustawiając reguły przepisywania z parametrem
dynamicLinksustawionym natrue. Żądania do tych ścieżek są przekazywane do Dynamic Links.W przeciwieństwie do reguł, które przepisują ścieżki do adresów URL, reguły przepisywania Dynamic Link nie mogą zawierać wyrażeń regularnych.
Jeśli masz wiele reguł przepisywania dla swojej witryny, pamiętaj, że Hosting wykonuje pierwszą regułę przepisywania, która pasuje do żądania.
Na przykład:
"hosting": { // ... "appAssociation": "AUTO", "rewrites": [ { "source": "/promos/**", "dynamicLinks": true }, { "source": "/links/share/**", "dynamicLinks": true } ] }Przy powyższej konfiguracji możesz utworzyć Dynamic Links z prefiksami adresów URL, takimi jak w tych przykładach:
https://your-domain/promos/link-suffix https://your-domain/links/share/link-suffix
Jeśli używasz tej domeny tylko w przypadku Dynamic Links, możesz użyć ścieżki źródłowej
/**, aby utworzyć Dynamic Links bez prefiksu ścieżki:{ "source": "/**", "dynamicLinks": true }Korzystając z powyższej reguły, możesz utworzyć Dynamic Links, jak w tym przykładzie:
https://your-domain/link-suffix
Wdróż zmiany w konfiguracji Hosting:
firebase deploy --only hosting
(Opcjonalnie) Możesz sprawdzić wdrożoną treść
firebase.jsonza pomocą interfejsu API REST Hosting.Tylko iOS: w pliku
Info.plistprojektu Xcode utwórz klucz o nazwieFirebaseDynamicLinksCustomDomainsi ustaw go na prefiksy adresów URL Dynamic Links aplikacji. Na przykład:<key>FirebaseDynamicLinksCustomDomains</key> <array> <string>https://example.com/promos</string> <string>https://example.com/links/share</string> </array>
Kolejność priorytetów dla: Dynamic Links i Hosting
W przypadku Dynamic Links zwróć szczególną uwagę na kolejność priorytetów hostingu.
- Upewnij się, że prefiks adresu URL Dynamic Links nie jest w konflikcie z konfiguracjami hostingu o wyższym priorytecie (na przykład hostowane treści statyczne zawsze mają priorytet nad przepisywaniem).
- W atrybucie
rewritesodpowiedź Hosting będzie zgodna z regułą określoną przez pierwszy wzorzec globsource, który przechwytuje żądaną ścieżkę.
Jeśli na przykład skonfigurujesz Dynamic Link dla your-domain/source-path/link-suffix, ale masz też treści statyczne pod adresem your-domain/source-path/index.html, treści statyczne będą miały pierwszeństwo. Użytkownik zobaczy index.html zamiast Dynamic Link. Podobnie, jeśli masz treści statyczne pod adresem your-domain/source-path/link-suffix, użytkownik zobaczy treści statyczne, a nie Dynamic Link.
Jeśli chcesz używać tej samej marki w usługach Dynamic Links i Hosting, rozważ jedną z tych opcji prefiksu adresu URL w usłudze Dynamic Links:
Ustaw atrybut
sourcetak, aby pasował do prefiksu ścieżki. Jeśli na przykład masz własną domenęexample.com, reguła przepisywania może wyglądać tak:// Domain is example.com "rewrites": [ { "source": "/links/**", // Dynamic Links start with "https://example.com/links/" "dynamicLinks": true } ]Skonfiguruj subdomenę, której chcesz używać w przypadku Dynamic Links, a następnie ustaw atrybut
sourcetak, aby pasował do tej subdomeny. Jeśli na przykład masz subdomenęlinks.example.com, reguła przepisywania może wyglądać tak:// Domain is links.example.com "rewrites": [ { "source": "/**", // Dynamic Links start with "https://links.example.com/" "dynamicLinks": true } ]