Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Siapkan domain khusus untuk Dynamic Links

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Anda dapat memiliki kontrol yang lebih besar atas branding Dynamic Links Anda dengan menggunakan domain Anda sendiri, bukan subdomain page.link . Dengan domain kustom, Anda dapat membuat Dynamic Links seperti contoh berikut:

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

Bagian dari URL sebelum link-suffix disebut awalan URL , dan berisi domain Tautan Dinamis khusus Anda dan awalan jalur. Anda harus memberikan awalan URL saat membuat Dynamic Links.

Menyiapkan domain kustom memerlukan izin Editor atau Pemilik di project Firebase Anda.

Menggunakan domain web Anda untuk Dynamic Links

Anda dapat menggunakan domain yang sama untuk Dynamic Links dan halaman web, Tautan Universal, dan Tautan Aplikasi Anda, tetapi jika melakukannya, Anda harus berhati-hati agar URL Tautan Dinamis tidak bertentangan dengan URL web Anda. Saat Anda mengonfigurasi Tautan Dinamis untuk menggunakan awalan URL tertentu, semua URL yang dimulai dengan awalan tersebut akan diperlakukan sebagai Tautan Dinamis, sehingga Anda tidak dapat menggunakan URL dengan awalan tersebut untuk mengarah ke konten yang dihosting biasa.

Misalnya, jika Anda ingin membuat Tautan Dinamis ke sumber daya https://example.com/my-resource (laman web, Tautan Universal, atau Tautan Aplikasi), Anda tidak dapat menggunakan https://example.com/ sebagai awalan URL Tautan Dinamis, karena hal itu akan menyebabkan https://example.com/my-resource diperlakukan sebagai Tautan Dinamis. Sebagai gantinya, Anda harus menggunakan awalan URL dengan domain yang berbeda atau awalan jalur yang berbeda.

Jadi, Tautan Dinamis bentuk panjang berikut (dan tautan pendek yang setara) tidak akan berfungsi sebagaimana mestinya karena URL yang ditentukan oleh parameter link dimulai dengan awalan URL Tautan Dinamis, https://example.com/ :

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

Tetapi Tautan Dinamis bentuk panjang berikut (dan tautan pendek yang setara) dapat berfungsi, karena awalan URL tidak bertentangan dengan 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

Siapkan domain khusus di konsol Firebase

Anda biasanya dapat menyiapkan domain khusus sepenuhnya di konsol Firebase. Untuk melakukannya:

  1. Jika Anda belum menyiapkan Firebase Hosting untuk proyek Anda, buka halaman Hosting di Firebase console, klik Mulai , dan klik petunjuk penyiapan. Anda tidak harus menyelesaikan langkah-langkah yang ditunjukkan saat ini.

  2. Buka halaman Dynamic Links di Firebase console.

  3. Jika Anda belum pernah menggunakan Dynamic Links sebelumnya, klik Mulai . Jika tidak, klik Tambahkan awalan URL dari menu tarik-turun.

    Kemudian, selesaikan wizard penyiapan, tentukan domain dan awalan jalur yang ingin Anda gunakan saat diminta.

  4. Khusus iOS : Di file Info.plist proyek Xcode Anda, buat kunci bernama FirebaseDynamicLinksCustomDomains dan setel ke awalan URL Dynamic Links aplikasi Anda. Sebagai contoh:

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

Siapkan domain khusus secara manual

Dalam beberapa situasi, seperti saat Anda sudah menyiapkan domain kustom untuk Dynamic Links dan ingin menambahkan domain lain, atau saat Anda menambahkan domain yang sudah terhubung ke situs Hosting, Anda harus menyiapkan domain kustom Anda secara manual.

Untuk melakukannya:

  1. Hubungkan domain Anda ke Firebase Hosting jika Anda belum melakukannya.

    Menyiapkan domain Anda dengan Firebase Hosting termasuk membuat file konfigurasi firebase.json di direktori proyek lokal Anda.

  2. Perbarui ke versi terbaru Firebase CLI (v6.5.0 atau yang lebih baru).

  3. Konfigurasikan situs Hosting Anda untuk Dynamic Links di file firebase.json proyek Anda. Jika proyek Anda memiliki beberapa situs, pastikan untuk mengonfigurasi situs yang terhubung ke domain yang ingin Anda gunakan.

    • Setel appAssociation ke AUTO . Dengan pengaturan ini, Hosting secara dinamis menghasilkan assetlinks.json dan apple-app-site-association saat diminta.

    • Tentukan awalan jalur yang ingin Anda gunakan untuk Dynamic Links dengan menyetel aturan penulisan ulang dengan dynamicLinks disetel ke true . Permintaan ke jalur ini diproksikan ke Dynamic Links.

      Tidak seperti aturan yang menulis ulang jalur ke URL, aturan penulisan ulang Dynamic Link tidak boleh berisi ekspresi reguler.

      Jika Anda memiliki beberapa aturan penulisan ulang untuk situs Anda, ketahuilah bahwa Hosting menjalankan aturan penulisan ulang pertama yang sesuai dengan permintaan.

    Sebagai contoh:

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

    Dengan konfigurasi di atas, Anda dapat membuat Dynamic Links dengan awalan URL seperti contoh berikut:

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

    Jika Anda menggunakan domain ini hanya untuk Dynamic Links, Anda dapat menggunakan jalur sumber /** untuk membuat Dynamic Links tanpa awalan jalur:

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

    Dengan aturan di atas, Anda dapat membuat Dynamic Links seperti contoh berikut:

    https://your-domain/link-suffix

  4. Terapkan perubahan konfigurasi Hosting Anda:

    firebase deploy --only hosting

    (opsional) Anda dapat memeriksa konten firebase.json yang di-deploy menggunakan REST API Hosting .

  5. Khusus iOS : Di file Info.plist proyek Xcode Anda, buat kunci bernama FirebaseDynamicLinksCustomDomains dan setel ke awalan URL Dynamic Links aplikasi Anda. Sebagai contoh:

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

Urutan prioritas untuk Dynamic Links dan Hosting

Untuk Dynamic Links, perhatikan urutan prioritas hosting .

  • Pastikan bahwa awalan URL Tautan Dinamis Anda tidak bertentangan dengan konfigurasi hosting berprioritas lebih tinggi (misalnya, konten statis yang dihosting selalu diprioritaskan daripada penulisan ulang).
  • Dalam atribut rewrites , respons Hosting akan mematuhi aturan yang ditentukan oleh glob source pertama yang menangkap jalur yang diminta .

Misalnya, jika Anda menyiapkan Tautan Dinamis untuk your-domain / source-path / link-suffix tetapi Anda juga memiliki konten statis di your-domain / source-path /index.html , konten statis akan diutamakan. Pengguna akhir akan melihat index.html daripada Dynamic Link. Demikian pula, jika Anda memiliki konten statis di your-domain / source-path / link-suffix , pengguna akhir akan melihat konten statis daripada Tautan Dinamis.

Jika Anda ingin menggunakan merek yang sama untuk Dynamic Links dan Hosting, pertimbangkan salah satu opsi berikut untuk awalan URL Dynamic Links Anda:

  • Setel atribut source Anda agar cocok dengan awalan jalur. Misalnya, jika Anda memiliki domain khusus example.com , aturan penulisan ulang Anda dapat berupa:

    // Domain is example.com
    "rewrites": [ {
      "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
      "dynamicLinks": true
    } ]
    
  • Siapkan subdomain yang akan digunakan untuk Dynamic Links, lalu setel atribut source Anda agar cocok dengan subdomain tersebut. Misalnya, jika Anda memiliki subdomain links.example.com , aturan penulisan ulang Anda dapat berupa:

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