Konfigurowanie domeny niestandardowej na potrzeby Linków dynamicznych

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ć:

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

  2. Otwórz stronę Dynamic Links w konsoli Firebase.

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

  4. Tylko iOS: w pliku Info.plist projektu Xcode utwórz klucz o nazwie FirebaseDynamicLinksCustomDomains i 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ć:

  1. 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.json w lokalnym katalogu projektu.

  2. Zaktualizuj interfejs wiersza poleceń Firebase do najnowszej wersji (6.5.0 lub nowszej).

  3. Skonfiguruj witrynę Hosting pod kątem Dynamic Links w pliku firebase.json projektu. Jeśli w projekcie masz kilka witryn, skonfiguruj witrynę połączoną z domeną, której chcesz używać.

    • Ustaw appAssociation na AUTO. Przy tym ustawieniu Hosting dynamicznie generuje pliki assetlinks.json i apple-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 dynamicLinks ustawionym na true. Żą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

  4. Wdróż zmiany w konfiguracji Hosting:

    firebase deploy --only hosting

    (Opcjonalnie) Możesz sprawdzić wdrożoną treść firebase.json za pomocą interfejsu API REST Hosting.

  5. Tylko iOS: w pliku Info.plist projektu Xcode utwórz klucz o nazwie FirebaseDynamicLinksCustomDomains i 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 rewrites odpowiedź Hosting będzie zgodna z regułą określoną przez pierwszy wzorzec glob source, 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 source tak, 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 source tak, 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
    } ]