הוספת 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.

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

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

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

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

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

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

    • ב-Android – לוחצים על Download google-services.json.

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

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

שלב 4: מוסיפים ערכות SDK של Firebase Unity

  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 ובפלטפורמות מחשב, ולאחר מכן פורסים ובודקים בנייד מכשירים שנמצאים בשלב מאוחר יותר בפיתוח. כדי לתמוך בתהליך העבודה הזה, אנחנו מספקים קבוצת משנה של ערכות ה-SDK של Firebase 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:

מוצר Firebase חבילת Unity
AdMob מופצת בנפרד בפלאגין AdMob Unity
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage

ספריות של Firebase שזמינות למחשב

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

מוצר Firebase (במחשב) חבילת Unity
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

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

השלבים הבאים