הוספת Firebase לפרויקט ב-Unity

אפשר לשפר את המשחקים שלך ב-Unity עם ערכות ה-SDK שלנו מסוג Firebase Unity.

כדי להראות כמה קל לקשר את Firebase לפרויקט ב-Unity, יצרנו משחק לדוגמה בשם MechaHamster. כדי לנסות להוסיף את Firebase למשחק, אפשר להשתמש את הגרסה הראשונית שמופיעה ב-GitHub. אם אתם רוצים גרסה מושלמת, תוכלו לבדוק את הגרסאות ב-App Store או ב-Google Play Store.

MechaHamster (GitHub)

MechaHamster‏ (App Store)

MechaHamster (חנות Play)


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

כבר הוספתם את Firebase לפרויקט ב-Unity? חשוב להקפיד להשתמש את הגרסה האחרונה של Firebase Unity SDK.

דרישות מוקדמות

  • מתקינים את Unity 2021 LTS ואילך. יש תמיכה ב-Unity 2020 לא יהיו זמינות יותר, והתמיכה בהן תופסק באופן פעיל אחרי גרסה חדשה. יכול להיות שגם גרסאות קודמות יהיו תואמות, אבל לא תהיה להן תמיכה פעילה.

  • (פלטפורמות של Apple בלבד) מתקינים את האפליקציות הבאות:

    • Xcode מגרסה 13.3.1 ואילך
    • CocoaPods מגרסה 1.12.0 ואילך

  • צריך לוודא שהפרויקט ב-Unity עומד בדרישות הבאות:

    • ב-iOS – מטרגט את iOS מגרסה 13 ואילך
    • ב-tvOS – טירגוט ל-tvOS מגרסה 13 ואילך
    • ב-Android – טירגוט לרמת API 21 (Lollipop) ומעלה

  • מגדירים מכשיר פיזי או משתמשים במהדמה כדי להריץ את האפליקציה.

    • לפלטפורמות של Apple – מגדירים מכשיר פיזי או משתמשים בסימולטור של iOS או tvOS.

    • ב-Android – אמולטורים חייבים להשתמש בתמונה של אמולטור עם Google Play.

אם עדיין אין לכם פרויקט ב-Unity ואתם רוצים רק לנסות את Firebase תוכלו להוריד אחת מדוגמאות למתחילים.

שלב 1: יוצרים פרויקט Firebase

לפני שמוסיפים את Firebase לפרויקט ב-Unity, צריך ליצור פרויקט Firebase כדי לקשר אותו לפרויקט ב-Unity. למידע נוסף על פרויקטים ב-Firebase, אפשר לקרוא את המאמר הסבר על פרויקטים ב-Firebase.

שלב 2: רושמים את האפליקציה ב-Firebase

אתם יכולים לרשום אפליקציה או משחק אחד או יותר כדי לקשר אותם לפרויקט ב-Firebase.

  1. נכנסים למסוף Firebase.

  2. במרכז הדף 'סקירה כללית של הפרויקט', לוחצים על הסמל של Unity () כדי להפעיל את תהליך העבודה להגדרה.

    אם כבר הוספתם אפליקציה לפרויקט Firebase, לוחצים על הוספת אפליקציה כדי להציג את אפשרויות הפלטפורמות.

  3. בוחרים את יעד ה-build של פרויקט Unity שרוצים לרשום, או אפילו לבחור לרשום את שני היעדים בו-זמנית.

  4. מזינים את המזהים הספציפיים לפלטפורמה של פרויקט Unity.

    • ב-iOS – מזינים את מזהה iOS של פרויקט Unity בקטע חבילת iOS ID (מזהה) השדה הזה.

    • ל-Android – מזינים את מזהה Android של פרויקט Unity בשדה Android package name.
      המונחים שם החבילה ומזהה האפליקציה משמשים לעתים קרובות כחלופות זה לזה.

  5. (אופציונלי) מזינים את הכינויים הספציפיים לפלטפורמה של פרויקט Unity.
    הכינויים האלה הם פנימיים, מזהים לצורכי נוחות והם גלויים רק במסוף Firebase.

  6. לוחצים על רישום האפליקציה.

שלב 3: מוסיפים קובצי תצורה של Firebase

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

    • ב-iOS – לוחצים על הורדת GoogleService-Info.plist.

    • ב-Android – לוחצים על להורדת google-services.json.

  2. פותחים את החלון Project של הפרויקט ב-Unity ומעבירים את קובצי התצורה לתיקייה Assets.

  3. חוזרים למסוף Firebase, בתהליך ההגדרה לוחצים על Next.

שלב 4: מוסיפים את Firebase Unity SDKs

  1. במסוף Firebase, לוחצים על Download Firebase Unity SDK ואז מפרקים את ה-SDK למקום נוח.

    • אפשר להוריד שוב את Firebase Unity SDK בכל שלב.

    • ה-SDK של Firebase Unity לא ספציפי לפלטפורמה.

  2. בפרויקט Unity הפתוח, עוברים אל נכסים > ייבוא חבילה > חבילה מותאמת אישית.

  3. מתוך ה-SDK לא דחוס, בוחרים את ה-Firebase הנתמך מוצרים שבהם אתם רוצים להשתמש. באפליקציה שלך.

    Analytics מופעלים

    • מוסיפים את חבילת Firebase עבור Google Analytics: FirebaseAnalytics.unitypackage
    • מוסיפים את החבילות של מוצרי Firebase אחרים שבהם רוצים להשתמש באפליקציה. לדוגמה, כדי להשתמש ב-Firebase Authentication וב-Firebase Realtime Database:
      FirebaseAuth.unitypackage ו-FirebaseDatabase.unitypackage

    Analytics לא מופעל

    מוסיפים את החבילות של מוצרי Firebase שבהן רוצים להשתמש באפליקציה. לדוגמה, כדי להשתמש ב-Firebase Authentication וב-Firebase Realtime Database:
    FirebaseAuth.unitypackage והקבוצה FirebaseDatabase.unitypackage

  4. בחלון ייבוא של חבילת Unity לוחצים על ייבוא.

  5. חוזרים למסוף Firebase, בתהליך ההגדרה לוחצים על Next.

שלב 5: בדיקת דרישות הגרסה של Google Play Services

ה-SDK של Unity Firebase ל-Android מחייב Google Play services, שחייבת יהיו עדכניים לפני שניתן יהיה להשתמש ב-SDK.

צריך להוסיף את ההצהרה using וקוד האתחול הבא בתחילת תרגום מכונה. לפני שמפעילים שיטות אחרות ב-SDK, אפשר לבדוק אם Google Play services מעודכן לגרסה הנדרשת על ידי ה-SDK של Firebase Unity, ואם לא, לעדכן אותו.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

הכול מוכן הפרויקט ב-Unity רשום ומוגדר לשימוש ב-Firebase.

אם תיתקלו בבעיות בהגדרה, תוכלו לעיין בשאלות הנפוצות ובפתרון בעיות ב-Unity.

הגדרת תהליך עבודה במחשב (בטא)

כשיוצרים משחק, בדרך כלל הרבה יותר קל לבדוק את המשחק ב- עורך Unity ובפלטפורמות מחשב, ולאחר מכן פורסים ובודקים בנייד מכשירים שנמצאים בשלב מאוחר יותר בפיתוח. כדי לתמוך בתהליך העבודה הזה, אנחנו מספקים קבוצת משנה של Firebase ערכות ה-SDK של Unity שיכולות לפעול ב-Windows, ב-macOS, ב-Linux ומתוך עורך Unity.

  1. מגדירים פרויקט Unity בפלטפורמה למחשב, פועלים לפי ההוראות שמפורטות לפלטפורמה לנייד (מתחילים ב- רושמים את האפליקציה באמצעות Firebase בשלב שלמעלה).

  2. מריצים את הפרויקט ב-Unity ב-Unity IDE או בוחרים ליצור את Unity לפרויקט למחשב.

  3. (אופציונלי) מריצים את פרויקט Unity במצב עריכה.

    אפשר להריץ את ה-SDK Firebase Unity גם במצב עריכה של Unity, וכך להשתמש בו ביישומי הפלאגין של העריכה.

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

    2. במקום זאת, צריך לתת שם ייחודי לקריאה של FirebaseApp.Create().

      חשוב להקפיד על כך כדי למנוע התנגשות בין האפשרויות שבהן נעשה שימוש במכונה. בסביבת הפיתוח המשולבת Unity IDE ובמכונה שמשמשת את פרויקט Unity.

מוצרי Firebase נתמכים

מידע נוסף על ספריות Firebase ב-Unity זמין במסמכי העזרה.

ספריות Firebase זמינות לנייד

ה-SDK של Firebase Unity תומך במוצרי Firebase הבאים: Apple ו-Android: