Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

הוסף את Firebase לפרויקט Unity שלך

טעינת חשמל שלך האחדות משחקים עם ערכות SDK אחדות Firebase שלנו.

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (חנות Play)


גלה פרטים נוספים על היכולות עד המשחקים שלך עם Firebase בבית שלנו דף משחקים Firebase .

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

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

  • התקן את Unity 2017.4 ואילך. גרסאות קודמות עשויות להיות גם תואמות אך לא יתמכו באופן פעיל.

  • (iOS בלבד) התקן את הבאה:

    • Xcode 9.4.1 ומעלה
    • CocoaPods 1.10.0 ומעלה
  • וודא כי פרויקט Unity שלך עומד בדרישות הבאות:

    • עבור iOS - מטרות iOS 10 ומעלה
    • עבור אנדרואיד - מטרות API ברמה 16 (Jelly Bean) ומעלה

  • הגדר מכשיר פיזי או השתמש באמולטור להפעלת האפליקציה שלך.

    • עבור iOS - הגדרת מכשיר iOS פיזית או להשתמש בסימולטור iOS.

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

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

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

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

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

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

  1. עבור אל קונסולת Firebase .

  2. במרכז דף סקירת הפרויקט, לחץ על סמל האחדות ( ) כדי להפעיל את זרימת עבודת ההתקנה.

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

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

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

    • עבור iOS - זן מזהה iOS של פרויקט האחדות שלכם זיהוי חבילת iOS השדה.

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

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

  6. לחץ אפליקצית רישום.

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

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

    • עבור iOS - לחץ להורדה GoogleService-info.plist.

    • עבור אנדרואיד - להורדה לחץ על Google-services.json.

  2. פתח בחלון הפרויקט של פרויקט האחדות שלך, ולאחר מכן להעביר קובץ config שלך (הים) לתוך Assets התיקייה.

  3. חזרה במסוף Firebase, בזרימת העבודה ההתקנה, לחץ על הבא.

שלב 4: הוספת Firebase אחדות ערכות SDK

  1. במסוף Firebase, לחץ על הורדה Firebase האחדות SDK, אז unzip ב- SDK איפשהו נוח.

    • ניתן להוריד את SDK האחדות Firebase שוב בכל עת.

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

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

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

    Analytics מופעל

    • מוסיפים את החבילה Firebase עבור Google Analytics: FirebaseAnalytics.unitypackage
    • הוסף את החבילות לכל מוצרי Firebase אחרים שבהם תרצה להשתמש באפליקציה שלך. לדוגמה, כדי להשתמש באימות Firebase ובמסד נתונים בזמן אמת של Firebase:
      FirebaseAuth.unitypackage ו FirebaseDatabase.unitypackage

    Analytics אינו מופעל

    הוסף את החבילות של מוצרי Firebase שבהם תרצה להשתמש באפליקציה שלך. לדוגמה, כדי להשתמש באימות Firebase ובמסד נתונים בזמן אמת של Firebase:
    FirebaseAuth.unitypackage ו FirebaseDatabase.unitypackage

  4. בחלון חבילת האחדות ייבוא, לחץ על ייבוא.

  5. חזרה במסוף Firebase, בזרימת העבודה ההתקנה, לחץ על הבא.

שלב 5: לוודא עמידה בדרישות הגירסה בשירותי Google Play

ה- SDK האחדות Firebase עבור אנדרואיד דורש שירותים של Google Play , אשר חייב להיות עַדכָּנִי לפני SDK ניתן להשתמש.

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

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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 ובפלטפורמות שולחן העבודה, ולאחר מכן לפרוס ולבדוק במכשירים ניידים בהמשך הפיתוח. כדי לתמוך זרימת עבודה זו, אנו מספקים משנה מערכות ה- SDK אחדות Firebase שיכול לרוץ על Windows, MacOS, לינוקס, ומתוך עורך האחדות.

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

  2. הפעל פרויקט האחדות שלכם ב- IDE אחדות או בחר לבנות פרויקט האחדות שלך עבור שולחן העבודה.

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

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

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

    2. במקום, לתת שם ייחודי FirebaseApp.Create() שיחה.

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

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

למידע נוסף על ספריות Firebase האחדות של תיעוד הפניה .

ה- SDK אחדות Firebase תומכת במוצרי Firebase הבאים ב- iOS ו- Android:

מוצר Firebase חבילת אחדות
AdMob מופץ בנפרד בתוסף AdMob Unity
ניתוח FirebaseAnalytics.unitypackage
אימות FirebaseAuth.unitypackage
ענן Firestore (בטא) FirebaseFirestore.unitypackage
פונקציות ענן FirebaseFunctions.unitypackage
העברת הודעות בענן FirebaseMessaging.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage
אחסון בענן FirebaseStorage.unitypackage
התרסקות FirebaseCrashlytics.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage
קישורים דינמיים FirebaseDynamicLinks.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage
מסד נתונים בזמן אמת FirebaseDatabase.unitypackage
תצורה מרחוק FirebaseRemoteConfig.unitypackage
(מומלץ) FirebaseAnalytics.unitypackage

מוצרי Firebase נתמכים (שולחן עבודה)

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

מוצר Firebase (שולחן עבודה) חבילת אחדות
אימות FirebaseAuth.unitypackage
פונקציות ענן FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
אחסון בענן FirebaseStorage.unitypackage
מסד נתונים בזמן אמת FirebaseDatabase.unitypackage
תצורה מרחוק FirebaseRemoteConfig.unitypackage

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

הצעדים הבאים