יצירת קישורים דינמיים באמצעות C++‎

אתם יכולים ליצור Dynamic Links קצרים או ארוכים באמצעות Firebase Dynamic Links API. ה-API מקבל כמה מבני פרמטרים אופציונליים כדי ליצור קישורים. אפשר גם ליצור קישורים מקוצרים מקישורים ארוכים שנוצרו בעבר. Firebase Dynamic Links יוצרת כתובת URL כמו זו:

https://example.page.link/WXYZ

ערכת ה-SDK ל-C++‎ פועלת גם ב-Android וגם ב-iOS, אבל צריך לבצע הגדרות נוספות בכל פלטפורמה.

לפני שמתחילים

לפני שתוכלו להשתמש ב-Firebase Dynamic Links, תצטרכו:

  • רושמים את פרויקט ה-C++‎ ומגדירים אותו לשימוש ב-Firebase.

    אם פרויקט ה-C++‎ שלכם כבר משתמש ב-Firebase, הוא כבר רשום ומוגדר ל-Firebase.

  • מוסיפים את Firebase C++ SDK לפרויקט ב-C++‎.

שימו לב: הוספת Firebase לפרויקט ב-C++‎ כוללת משימות גם במסוף Firebase וגם בפרויקט הפתוח ב-C++‎ (לדוגמה, אתם מורידים קובצי תצורה של Firebase מהמסוף ואז מעבירים אותם לפרויקט ב-C++‎).

Android

  1. במסוף Firebase, פותחים את הקטע Dynamic Links.
  2. אם עדיין לא אישרתם את התנאים וההגבלות ולא הגדרתם תחילית URI ל-Dynamic Links, תצטרכו לעשות את זה כשתתבקשו.

    אם כבר יש לכם תחילית URI של Dynamic Links, שימו לב אליה. כשיוצרים Dynamic Links באופן פרוגרמטי, צריך לספק קידומת URI של Dynamic Links.

  3. מומלץ: ציינו את תבניות ה-URL שמותר להשתמש בהן בקישורי העומק ובקישורי ה-fallback. כך אתם מונעים מגורמים לא מורשים ליצור Dynamic Links שמפנים מהדומיין שלכם לאתרים שאין לכם שליטה עליהם. איך מאשרים תבניות ספציפיות של כתובות URL

iOS

  1. במסוף Firebase, פותחים את הקטע Dynamic Links.
  2. אם עדיין לא אישרתם את התנאים וההגבלות ולא הגדרתם תחילית URI ל-Dynamic Links, תצטרכו לעשות את זה כשתתבקשו.

    אם כבר יש לכם תחילית URI של Dynamic Links, שימו לב אליה. כשיוצרים Dynamic Links באופן פרוגרמטי, צריך לציין דומיין של Dynamic Links.

  3. ספריית הלקוח של Firebase Dynamic Links ל-C++‎ משתמשת בסכימות של כתובות URL בהתאמה אישית ב-iOS כדי לעבד קישורים. כדי לתמוך בקבלת Dynamic Links, צריך להוסיף לאפליקציה סכמות URL מותאמות אישית:
    1. כדי לפתוח את הגדרות הפרויקט, לוחצים לחיצה כפולה על שם הפרויקט בתצוגת העץ שמימין. בקטע TARGETS, בוחרים את האפליקציה, לוחצים על הכרטיסייה Info ומרחיבים את הקטע URL Types.
    2. לוחצים על הכפתור + ומוסיפים סכמת URL למזהה הלקוח ההפוך. כדי למצוא את הערך הזה, פותחים את קובץ התצורה GoogleService-Info.plist ומחפשים את המפתח REVERSED_CLIENT_ID. מעתיקים את הערך של המפתח הזה ומדביקים אותו בתיבה URL Schemes בדף ההגדרות. משאירים את שאר השדות ריקים.
    3. לוחצים על הכפתור + ומוסיפים סכמת URL שנייה. הוא זהה למזהה החבילה של האפליקציה. לדוגמה, אם מזהה החבילה הוא com.example.ios, מקלידים את הערך הזה בתיבה סכמות URL. מזהה החבילה של האפליקציה מופיע בכרטיסייה General (כללי) בהגדרות הפרויקט (Identity > Bundle Identifier).

שימוש במסוף Firebase

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

דומיינים מותאמים אישית

כדי לשלוט טוב יותר במיתוג של Dynamic Link, אפשר להשתמש בדומיין משלכם במקום בתת-דומיין של goo.gl או page.link. כדי להגדיר דומיין בהתאמה אישית לפרויקט, פועלים לפי ההוראות האלה.

שימוש ב-API של Firebase Dynamic Links

יצירה והפעלה של האפליקציה

לפני שיוצרים את Dynamic Links, צריך ליצור אובייקט firebase::App ולהפעיל אותו.

כוללים את קובץ הכותרת של firebase::App:

#include "firebase/app.h"

החלק הבא משתנה בהתאם לפלטפורמה:

Android

יוצרים את firebase::App ומעבירים את סביבת ה-JNI ואת ההפניה jobject לפעילות ב-Java כארגומנטים:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS

יוצרים את ה-firebase::App:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

הפעלת הספרייה Dynamic Links

לפני שיוצרים Dynamic Link, צריך להפעיל את הספרייה Dynamic Links:

::firebase::dynamic_links::Initialize(app, null);

יצירת Dynamic Link ארוך מפרמטרים

כדי ליצור קישור דינמי, יוצרים אובייקט DynamicLinkComponents, מגדירים את כל הרכיבים האופציונליים להגדרות אישיות נוספות ומעבירים אותו אל dynamic_links::GetShortLink או אל dynamic_links::GetLongLink.

יצירת סרטון Shorts Dynamic Link

כדי ליצור קישור דינמי קצר, מעבירים קישור ארוך שנוצר קודם ל-GetShortLink או יוצרים את DynamicLinkComponents באותו אופן כמו למעלה.

אפשר להוסיף ל-GetShortLink פרמטר הגדרה נוסף של DynamicLinkOptions עם PathLength, שמאפשר לשלוט באופן שבו הקישור ייווצר. כדי ליצור קישור קצר, צריך לשלוח בקשה לאחזור מהרשת לקצה העורפי של Firebase, ולכן GetShortLink היא אסינכרונית ומחזירה Future<GeneratedLink>.