Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

הגדר דומיין מותאם אישית עבור קישורים דינמיים

אתה יכול לקבל שליטה רבה יותר על המיתוג של קישורים דינמיים שלך באמצעות תחום משלך במקום תחום משנה של page.link . עם דומיינים מותאמים אישית, אתה יכול ליצור קישורים דינמיים כמו הדוגמאות הבאות:

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

החלק של כתובת האתר שלפני link-suffix נקרא קידומת URL , והוא מכיל גם תחום קישור דינמי מותאם אישית וגם קידומת נתיב. יהיה עליך לספק קידומת URL כשאתה יוצר קישורים דינמיים.

הגדרת דומיין מותאם אישית מחייבת הרשאת עורך או בעלים בפרויקט Firebase שלך.

שימוש בדומיין האינטרנט שלך לקישורים דינמיים

אתה יכול להשתמש באותו תחום לקישורים הדינמיים שלך ולדפי האינטרנט שלך, קישורים אוניברסליים וקישורי אפליקציות, אך אם כן, עליך לדאוג שכתובות האתר שלך לקישור הדינמי לא יתנגשו עם כתובות האתרים שלך. כשאתה מגדיר קביעת תצורה של קישורים דינמיים לשימוש בקידומת URL מסוימת, כל כתובות האתרים המתחילות בקידומת זו מטופלות כקישורים דינמיים, כך שלא תוכל להשתמש בכתובות URL עם קידומת זו כדי להצביע על תוכן מתארח רגיל.

לדוגמה, אם ברצונך ליצור קישור דינמי למשאב https://example.com/my-resource (דף אינטרנט, קישור אוניברסלי או קישור לאפליקציות), אינך יכול להשתמש ב https://example.com/ כקידומת כתובת האתר של קישורים דינמיים, מכיוון שפעולה זו תגרום ל https://example.com/my-resource להיות מטופלים כאל קישור דינמי. במקום זאת, עליך להשתמש בקידומת URL עם דומיין אחר או קידומת נתיב שונה.

אז הקישורים הדינמיים הבאים לטווח הארוך (וקישורים קצרים מקבילים) לא יפעלו כמתוכנן מכיוון שכתובות האתר שצוינו על ידי פרמטר link מתחילות עם קידומת URL קישור קישור דינמי, https://example.com/ :

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

עם זאת, הקישורים הדינמיים הבאים לטווח הארוך (וקישורים קצרים שקולים) יכולים לעבוד מכיוון שקידומות ה- 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

הגדר דומיין מותאם אישית במסוף Firebase

לרוב ניתן להגדיר דומיין מותאם אישית לחלוטין במסוף Firebase. לשם כך:

  1. אם עדיין לא הגדרת את אירוח Firebase עבור הפרויקט שלך, פתח את דף האירוח של מסוף Firebase, לחץ על התחל ולחץ על פי הוראות ההתקנה. בשלב זה אינך צריך להשלים את הצעדים שצוינו.

  2. פתח את הדף קישורים דינמיים במסוף האש.

  3. אם לא השתמשת בעבר בקישורים דינמיים, לחץ על התחל . אחרת, לחץ על הוסף קידומת URL מהתפריט הנפתח.

    לאחר מכן, השלם את אשף ההתקנה וציין את קידומת התחום והנתיב שבהם ברצונך להשתמש כאשר תתבקש.

  4. iOS בלבד : בקובץ Info.plist של פרוייקט Xcode, צור מפתח בשם FirebaseDynamicLinksCustomDomains והגדר אותו לקידומות URL של קישורים דינמיים של היישום שלך. לדוגמה:

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

הגדר ידנית תחום מותאם אישית

במצבים מסוימים, למשל כאשר כבר יש לך תחום מותאם אישית שמוגדר עבור קישורים דינמיים ורוצה להוסיף דומיין אחר, או כשאתה מוסיף תחום שכבר מחובר לאתר אירוח, עליך להגדיר את הדומיין המותאם אישית שלך באופן ידני.

לשם כך:

  1. חבר את הדומיין שלך לאירוח Firebase אם עדיין לא עשית זאת.

    הגדרת הדומיין שלך באמצעות Firebase Hosting כוללת יצירת קובץ התצורה firebase.json בספריית הפרויקטים המקומית שלך.

  2. עדכן לגרסה האחרונה של Firebase CLI (v6.5.0 ואילך).

  3. קבע את התצורה של אתר האירוח שלך לקישורים דינמיים בקובץ firebase.json של הפרויקט. אם לפרויקט שלך יש אתרים מרובים, הקפד להגדיר את התצורה של האתר המחובר לתחום בו תרצה להשתמש.

    • הגדר appAssociation ל- AUTO . בעזרת הגדרה זו, אירוח מייצר באופן דינמי assetlinks.json apple-app-site-association כאשר הם מתבקשים.

    • ציין את הקידומות הנתיב שבו ברצונך להשתמש עבור Dynamic קישורים ידי קביעת כללים שכתוב עם dynamicLinks מוגדר true . בקשות לנתיבים אלה מתקרבות לקישורים דינמיים.

      שלא כמו כללים המכתבים נתיבים לכתובות אתרים, כללי הכתיבה של קישור דינמי אינם יכולים להכיל ביטויים רגילים.

      אם יש לך כללי שכתוב מחדש מרובים עבור האתר שלך, שים לב כי אירוח מבצע את הכלל הכתיבה הראשון התואם לבקשה.

    לדוגמה:

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

    עם התצורה שלעיל, תוכלו ליצור קישורים דינמיים עם קידומות של כתובות אתרים כמו הדוגמאות הבאות:

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

    אם אתה משתמש בתחום זה רק עבור קישורים דינמיים, אתה יכול להשתמש בנתיב מקור של /** כדי ליצור קישורים דינמיים ללא קידומת נתיב:

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

    עם הכלל לעיל, אתה יכול ליצור קישורים דינמיים כמו הדוגמה הבאה:

    https:// your-domain / link-suffix 

  4. פרוס את השינויים בתצורת האירוח שלך:

    firebase deploy --only hosting

    (אופציונלי) אתה יכול לבדוק את תוכן firebase.json הפרוס באמצעות ממשק ה- API של REST .

  5. iOS בלבד : בקובץ Info.plist של פרויקט Xcode, צור מפתח בשם FirebaseDynamicLinksCustomDomains והגדר אותו לקידומות URL של קישורים דינמיים של היישום שלך. לדוגמה:

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

סדר עדיפות לקישורים דינמיים ואירוח

עבור קישורים דינמיים, שימו לב במיוחד לאירוח סדר עדיפות .

  • ודא שקידומת ה- URL של קישורים דינמיים אינה מתנגשת עם תצורות אירוח בעדיפות גבוהה יותר (לדוגמה, לתוכן סטטי מתארח תמיד יש עדיפות על פני שכתוב).
  • במסגרת תכונת rewrites , תגובת ה- Hosting תציית לכלל שצוין על ידי ה- source glob הראשון שתופס את הנתיב המבוקש .

לדוגמה, אם אתה מגדיר קישור דינאמי עבור your-domain / source-path / link-suffix אך יש לך גם תוכן סטטי ב- your-domain / source-path /index.html , לתוכן הסטטי יש עדיפות. משתמש קצה יראה index.html ולא את הקישור הדינמי. באופן דומה, אם יש לך תוכן סטטי your-domain / source-path / link-suffix , משתמש הקצה יראה את התוכן הסטטי ולא את הקישור הדינמי.

אם ברצונך להשתמש באותו מיתוג הן לקישורים דינמיים והן לאירוח, שקול אחת מהאפשרויות הבאות לקידומת כתובת האתר שלך לקישורים דינמיים:

  • הגדר את תכונת source שלך כך שתתאים לקידומת נתיב. לדוגמה, אם יש לך דומיין מותאם אישית של example.com , כלל השכתוב שלך יכול להיות:

     // Domain is example.com
    "rewrites": [ {
      "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
      "dynamicLinks": true
    } ]
     
  • הגדר תת-דומיין שישמש עבור קישורים דינמיים, ואז הגדר את תכונת source שלך שתתאים לדומיין-משנה זה. לדוגמה, אם יש לך תת-דומיין של links.example.com , כלל השכתוב שלך יכול להיות:

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