Google 致力于为黑人社区推动种族平等。查看具体举措

Imposta un dominio personalizzato per Dynamic Links

Si può avere un maggiore controllo sulla tua dinamica Link di branding utilizzando il proprio dominio al posto di un page.link sottodominio. Con i domini personalizzati, puoi creare collegamenti dinamici come nei seguenti esempi:

https://example.com/link-suffix
https://example.com/links/promos/link-suffix
https://links.example.com/link-suffix
https://ex.amp.le/link-suffix

La parte dell'URL prima di link-suffix è chiamato il prefisso URL, e contiene sia la vostra abitudine di dominio Dynamic Link e un prefisso percorso. Dovrai fornire un prefisso URL quando crei collegamenti dinamici.

La configurazione di un dominio personalizzato richiede l'autorizzazione di Editor o Proprietario sul tuo progetto Firebase.

Utilizzo del tuo dominio web per Dynamic Links

Puoi utilizzare lo stesso dominio per i tuoi link dinamici e le tue pagine web, link universali e link app, ma in tal caso devi fare attenzione che gli URL dei link dinamici non siano in conflitto con i tuoi URL web. Quando si configurano i collegamenti dinamici per utilizzare un particolare prefisso URL, tutti gli URL che iniziano con quel prefisso vengono trattati come collegamenti dinamici, quindi non è possibile utilizzare gli URL con quel prefisso per puntare a contenuti ospitati ordinari.

Ad esempio, se si desidera creare un collegamento dinamico alla risorsa https://example.com/my-resource (una pagina web, Universal Link, o App Link), non è possibile utilizzare https://example.com/ come prefisso dinamico collegamenti URL, perché così facendo avrebbe causato https://example.com/my-resource di essere trattato come un collegamento dinamico. È invece necessario utilizzare un prefisso URL con un dominio diverso o un prefisso di percorso diverso.

Così, il seguente lungo-forma dinamica Links (e collegamenti brevi equivalenti) non funziona come previsto perché gli URL specificati dal link inizio parametro con il prefisso Dynamic Link URL, https://example.com/ :

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

Ma il seguente lungo forma dinamica Link (e collegamenti brevi equivalenti) può funzionare, perché i prefissi URL non siano in conflitto con i link URL:

 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

Configura un dominio personalizzato nella console Firebase

Di solito puoi configurare completamente un dominio personalizzato nella console Firebase. Fare così:

  1. Se non è stato impostato Firebase Hosting per il vostro progetto, aprire la pagina di hosting della console Firebase, fare clic su Inizia, e scegliere attraverso le istruzioni di installazione. Non è necessario completare i passaggi indicati in questo momento.

  2. Aprire la pagina di dinamica collegamenti della console Firebase.

  3. Se non avete usato dinamico collegamenti prima, fare clic su Get Started. In caso contrario, fare clic su Aggiungi URL prefisso dal menu a discesa.

    Quindi, completare la procedura guidata di installazione, specificando il dominio e il prefisso del percorso che si desidera utilizzare quando richiesto.

  4. iOS solo: del progetto Xcode Info.plist di file, creare una chiave denominata FirebaseDynamicLinksCustomDomains e impostarlo per i prefissi dinamico collegamenti URL del vostro app. Per esempio:

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

Configura manualmente un dominio personalizzato

In alcune situazioni, come quando hai già un dominio personalizzato configurato per Dynamic Links e vuoi aggiungere un altro dominio, o quando stai aggiungendo un dominio già connesso a un sito Hosting, devi configurare manualmente il tuo dominio personalizzato.

Fare così:

  1. Collegare il dominio Firebase Hosting se non l'hai già fatto.

    Impostare il tuo dominio con Hosting Firebase include la creazione del file di configurazione firebase.json nella directory del progetto locale.

  2. Aggiornare alla versione più recente del Firebase CLI (v6.5.0 o successivo).

  3. Configurare il sito di hosting per Dynamic Link in del progetto firebase.json file. Se il tuo progetto ha più siti, assicurati di configurare il sito connesso al dominio che desideri utilizzare.

    • Set appAssociation a AUTO . Con questa impostazione, hosting in modo dinamico genera assetlinks.json e apple-app-site-association file quando vengono richiesti.

    • Inserire i prefissi di percorso che si desidera utilizzare per Dynamic Link impostando regole di riscrittura con dynamicLinks impostato su true . Le richieste a questi percorsi vengono inoltrate a Dynamic Links.

      A differenza delle regole che riscrivono i percorsi negli URL, le regole di riscrittura di Dynamic Link non possono contenere espressioni regolari.

      Se hai più regole di riscrittura per il tuo sito, tieni presente che Hosting esegue la prima regola di riscrittura che corrisponde alla richiesta.

    Per esempio:

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

    Con la configurazione sopra, è possibile creare collegamenti dinamici con prefissi URL come i seguenti esempi:

    https://your-domain/promos/link-suffix
    https://your-domain/links/share/link-suffix
    

    Se si utilizza questo dominio solo per Dynamic Link, è possibile utilizzare un percorso di origine di /** per creare dinamico collegamenti senza prefisso del percorso:

    {
      "source": "/**",
      "dynamicLinks": true
    }
    

    Con la regola di cui sopra, è possibile creare collegamenti dinamici come il seguente esempio:

    https://your-domain/link-suffix

  4. Distribuire le modifiche alla configurazione di hosting:

    firebase deploy --only hosting

    (opzionale) È possibile verificare il schierato firebase.json contenuto utilizzando l' hosting API REST .

  5. iOS solo: del progetto Xcode Info.plist di file, creare una chiave denominata FirebaseDynamicLinksCustomDomains e impostarlo per i prefissi dinamico collegamenti URL del vostro app. Per esempio:

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

Ordine di priorità per collegamenti dinamici e hosting

Per Dynamic Link, particolarmente consapevoli di ospitare ordine di priorità .

  • Assicurati che il tuo prefisso URL Dynamic Links non sia in conflitto con configurazioni di hosting con priorità più alta (ad esempio, il contenuto statico ospitato ha sempre la priorità sulle riscritture).
  • All'interno del rewrites di attributo, la risposta hosting obbedire alla regola specificata dal primo source glob che cattura il percorso richiesto.

Ad esempio, se si imposta un collegamento dinamico per il your-domain / source-path / link-suffix , ma hai anche contenuti statici al your-domain / source-path /index.html , il contenuto statico ha la precedenza. Un utente finale vedrà index.html piuttosto che il collegamento dinamico. Allo stesso modo, se si dispone di contenuto statico a your-domain / source-path / link-suffix , l'utente finale vedrà il contenuto statico, piuttosto che il collegamento dinamico.

Se desideri utilizzare lo stesso marchio sia per Dynamic Links che per Hosting, prendi in considerazione una delle seguenti opzioni per il prefisso URL di Dynamic Links:

  • Impostare la source attributo per abbinare un prefisso percorso. Ad esempio, se si dispone di un dominio personalizzato di example.com , la vostra regola di riscrittura potrebbe essere:

    // Domain is example.com
    "rewrites": [ {
      "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
      "dynamicLinks": true
    } ]
    
  • Configurare un sottodominio da utilizzare per Dynamic Link, quindi impostare la source attributo per corrispondere a quello sottodominio. Ad esempio, se si dispone di un sottodominio di links.example.com , la vostra regola di riscrittura potrebbe essere:

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