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

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

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (חנות Play)


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

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

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

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

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

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

    • עבור 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 הספציפיים לפלטפורמה בזרימת העבודה של הגדרת מסוף Firebase.

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

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

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

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

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

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

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

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

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

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

    ניתוח מופעל

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

    ניתוח לא מופעל

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

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

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

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

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

הוסף את הקוד הבא בתחילת היישום שלך. באפשרותך לחפש ולעדכן את שירותי Google Play לגרסה הנדרשת על-ידי Firebase Unity SDK לפני שתתקשר לשיטות אחרות ב- 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.
  }
});

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

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

הגדרת עבודת שולחן עבודה (בטא)

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

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

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

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

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

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

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

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

מוצרי 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
ענן Firestore FirebaseFirestore.unitypackage
אחסון בענן FirebaseStorage.unitypackage
מסד נתונים בזמן אמת FirebaseDatabase.unitypackage
תצורה מרחוק FirebaseRemoteConfig.unitypackage

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

הצעדים הבאים