Konfigurowanie domeny niestandardowej na potrzeby Linków dynamicznych

Masz większą kontrolę nad kontem Dynamic Links własne marki, domenę, a nie subdomenę page.link. Dzięki domenom niestandardowym możesz tworzyć Dynamic Links podobne do tych przykładów:

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 ciągiem link-suffix to prefiks adresu URL, i zawiera zarówno Twoją niestandardową domenę Dynamic Link, jak i prefiks ścieżki. Wykonaj podaj prefiks adresu URL podczas tworzenia elementu Dynamic Links.

Aby skonfigurować domenę niestandardową, musisz mieć w Firebase uprawnienia edytującego lub właściciela w projektach AI.

Używanie domeny internetowej dla usługi Dynamic Links

Możesz użyć tej samej domeny dla strony Dynamic Links i stron internetowych, uniwersalnej linki i linki aplikacji, ale jeśli to zrobisz, musisz zadbać o to, aby Twoje adresy URL w witrynie Dynamic Link nie powodują konfliktu z internetowymi adresami URL. Gdy skonfigurujesz Dynamic Links tak, aby używał określonego prefiksu adresu URL, wszystkie adresy URL, które zaczynają się od tego prefiksu, są traktowane jako Dynamic Links, więc nie można używać adresów URL z tym prefiksem do wskazywania witryn hostowanych treści.

Jeśli na przykład chcesz utworzyć Dynamic Link dla zasobu https://example.com/my-resource (strona internetowa, uniwersalny link lub link aplikacji), nie można użyć https://example.com/ jako prefiksu adresu URL Dynamic Links, ponieważ spowoduje to spowoduje, że element https://example.com/my-resource będzie traktowany jako Dynamic Link. Zamiast tego musisz użyć prefiksu adresu URL zawierającego inną domenę lub inną prefiks ścieżki.

Tak więc poniższy długi tekst Dynamic Links (i odpowiadające mu krótkie linki) nie będzie działał jako jest przeznaczona, ponieważ adresy URL określone przez parametr link zaczynają się od Dynamic Link Prefiks adresu URL, https://example.com/:

 https://example.com/?link=https://example.com/my-resource
 https://example.com/?link=https://example.com/resources/my-resource

Może jednak zadziałać poniższy długi tekst Dynamic Links (i odpowiednie krótkie linki): ponieważ prefiksy adresów URL 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

Skonfiguruj domenę niestandardową w konsoli Firebase

Zwykle możesz w pełni skonfigurować domenę niestandardową w konsoli Firebase. Do wykonaj te czynności:

  1. Jeśli w projekcie nie masz skonfigurowanego Firebase Hosting, otwórz Hosting w konsoli Firebase, kliknij Rozpocznij i postępuj zgodnie z instrukcjami konfiguracji. Nie musisz wykonaj wskazane czynności.

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

  3. Jeśli jeszcze nie używasz usługi Dynamic Links, kliknij Rozpocznij. W przeciwnym razie kliknij Z menu Dodaj prefiks adresu URL.

    Następnie zakończ proces konfiguracji w kreatorze konfiguracji, podając domenę i prefiks ścieżki. których chcesz użyć, gdy pojawi się prośba.

  4. Tylko iOS: w pliku Info.plist projektu Xcode utwórz klucz o nazwie FirebaseDynamicLinksCustomDomains i ustaw go na adres URL Dynamic Links Twojej aplikacji prefiksy. Przykład:

    <key>FirebaseDynamicLinksCustomDomains</key>
    <array>
      <string>https://example.com/link</string>
      <string>https://example.com/promos</string>
    </array>
    

Ręczne konfigurowanie domeny niestandardowej

Czasami, na przykład gdy masz już skonfigurowaną domenę niestandardową dla Dynamic Links i chcesz dodać kolejną domenę lub gdy dodajesz już domenę jest połączony z witryną Hosting, musisz ręcznie skonfigurować domenę niestandardową.

Aby to zrobić:

  1. Łączenie domeny z usługą Firebase Hosting jeśli jeszcze nie zostało to zrobione.

    Skonfigurowanie domeny w Firebase Hosting obejmuje utworzenie pliku konfiguracji firebase.json w w lokalnym katalogu projektów.

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

  3. Skonfiguruj witrynę Hosting dla Dynamic Links w projekcie firebase.json. Jeśli Twój projekt obejmuje wiele witryn, skonfigurować witrynę połączoną z domeną, której chcesz używać.

    • Ustaw appAssociation na AUTO. Przy tym ustawieniu Hosting dynamicznie generuje assetlinks.json i apple-app-site-association .

    • Ustaw prefiksy ścieżek, których chcesz używać w przypadku elementu Dynamic Links, przez ustawienie przepisywania reguły z wartością dynamicLinks ustawioną na true. Żądania wysyłane do tych ścieżek otrzymują został przesłany przez serwer proxy do Dynamic Links.

      W przeciwieństwie do reguł, które przepisują ścieżki do adresów URL, reguły przepisywania Dynamic Link nie mogą zawierają wyrażenia regularne.

      Jeśli masz w witrynie wiele reguł przepisywania, pamiętaj, że Hosting wykonuje pierwszą regułę przepisywania, która pasuje do żądania.

    Przykład:

    "hosting": {
      // ...
      "appAssociation": "AUTO",
      "rewrites": [
        {
          "source": "/promos/**",
          "dynamicLinks": true
        },
        {
          "source": "/links/share/**",
          "dynamicLinks": true
        }
      ]
    }
    

    Korzystając z powyższej konfiguracji, możesz utworzyć element Dynamic Links z prefiksami adresu 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 dla Dynamic Links, możesz użyć ścieżki źródłowej /** aby utworzyć obiekt 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 konfiguracji Hosting:

    firebase deploy --only hosting

    (Opcjonalnie) Wdrożoną treść firebase.json możesz sprawdzić za pomocą Hosting API REST.

  5. Tylko iOS: w pliku Info.plist projektu Xcode utwórz klucz o nazwie FirebaseDynamicLinksCustomDomains i ustaw go na adres URL Dynamic Links Twojej aplikacji prefiksy. Przykład:

    <key>FirebaseDynamicLinksCustomDomains</key>
    <array>
      <string>https://example.com/promos</string>
      <string>https://example.com/links/share</string>
    </array>
    

Priorytet: Dynamic Links i Hosting

W przypadku Dynamic Links zwróć szczególną uwagę na kolejność priorytetu hostingu.

  • Upewnij się, że prefiks adresu URL Dynamic Links nie koliduje z wyższym priorytetem konfiguracje hostingu (na przykład hostowana treść statyczna ma zawsze priorytet na przeredagowaniu).
  • Jeśli reguła znajduje się w atrybucie rewrites, odpowiedź Hosting będzie zgodna z regułą określone przez pierwszy 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 na your-domain/source-path/index.html, treść statyczna ma pierwszeństwo. Użytkownik zobaczy tekst index.html zamiast Dynamic Link. Podobnie, jeśli masz treści statyczne w your-domain/source-path/link-suffix, użytkownik zobaczy treść statyczną zamiast Dynamic Link.

Jeśli chcesz użyć tej samej marki w przypadku zarówno domeny Dynamic Links, jak i aplikacji Hosting, rozważ jedną z tych opcji prefiksu adresu URL Dynamic Links:

  • Ustaw atrybut source tak, aby pasował do prefiksu ścieżki. Na przykład, jeśli masz niestandardowej domeny example.com, reguła przepisywania może mieć postać:

    // Domain is example.com
    "rewrites": [ {
      "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
      "dynamicLinks": true
    } ]
    
  • Skonfiguruj subdomenę, która będzie używana w witrynie Dynamic Links, a następnie ustaw wartość atrybutu source na z tej subdomeny. Jeśli na przykład masz subdomenę links.example.com, reguła przepisywania może być taka:

    // Domain is links.example.com
    "rewrites": [ {
      "source": "/**",  // Dynamic Links start with "https://links.example.com/"
      "dynamicLinks": true
    } ]
    
.