אפשרויות התקנה נוספות של Unity

במקום להוריד קובץ .zip גדול שמכיל את כל קובצי .unitypackage גם עבור ‎ .NET 3.X וגם עבור ‎ .NET 4.X, אפשר להוריד חבילות נפרדות מהאתר של Google APIs for Unity.

האתר מספק:

  • קובצי .unitypackage נפרדים של ‎ .NET 4.X שמייבאים כחבילות נכסים.
  • ארכיונים נפרדים של .tgz לייבוא באמצעות Unity Package Manager.

האפשרות הזו שימושית במיוחד כשמשתמשים באפליקציה במוצר Firebase יחיד, כי קובצי .unitypackage הנפרדים מכילים את כל יחסי התלות הנדרשים, וקובצי .tgz מפורטים לצד קובצי .tgz קשורים שהם תלויים בהם.

בדף הזה מפורטות הוראות שקשורות ל-Unity Package Manager, לכן מומלץ לקרוא על הכלי במסמכי התיעוד של Unity.

ייבוא חבילות Firebase כנכסים

כשאתם מייבאים מוצרים של Firebase מקובצי .unitypackage שהורדתם מאתר Google APIs for Unity, חשוב לזכור את הדברים הבאים:

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

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

אחרי ההורדה, כדי לייבא:

  1. בפרויקט הפתוח ב-Unity, עוברים אל Assets‏ > Import Package‏ > Custom Package.

  2. בחלון ייבוא חבילת Unity, לוחצים על ייבוא.

ייבוא חבילות של Firebase באמצעות Unity Package Manager

כשאתם מייבאים מוצרים של Firebase מקובצי .tgz שהורדתם מהארכיון של Google APIs for Unity, חשוב לזכור את הדברים הבאים:

  • השיטה הזו זמינה רק בגרסה 2018.3 ואילך.

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

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

  • יחסי התלות של כל קובץ .tgz של מוצר מקושרים לצד קובצי .tgz משלהם. צריך להוריד ולייבא את קובץ .tgz של המוצר ואת קובצי .tgz של יחסי התלות, בסדר הנכון:

    1. מנהל יחסי תלות חיצוניים (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. מוצרי Firebase שבהם אתם משתמשים בפרויקט. אם משתמשים ב-Realtime Database או ב-Cloud Storage, צריך לייבא קודם את Authentication (com.google.firebase.auth).

אחרי ההורדה, מייבאים את קובצי ה-.tgz לפרויקט באחת מהשיטות הבאות:

ממשק המשתמש של מנהל החבילות

  1. פותחים את החלון Package Manager ב-Unity.
  2. לוחצים על הסמל + בפינה הימנית העליונה של חלון מנהל החבילות ובוחרים באפשרות Add package from tarball כדי לפתוח את דפדפן הקבצים.
  3. בוחרים את קובץ ה-tarball הרצוי בדפדפן הקבצים.

חלק מהגרסאות הישנות של Unity 2019 לא תומכות בהוספת קובצי tarballs ישירות. במקרה כזה, תצטרכו:

  1. מבטלים את דחיסת הקובץ .tgz.
  2. לוחצים על הסמל + בפינה הימנית העליונה של החלון Package Manager ובוחרים באפשרות Add package from disk כדי לפתוח את דפדפן הקבצים.
  3. בוחרים את התיקייה שחולצה בסרגל הקבצים.

manifest.json

  1. יוצרים תיקייה חדשה לצד התיקייה Packages של הפרויקט ומעניקים לה את השם GooglePackages.
  2. מעבירים את הקבצים של .tgz לתיקייה הזו.
  3. פותחים את הקובץ Packages/manifest.json בתיקיית הפרויקט ב-Unity באמצעות כלי לעריכת טקסט.

  4. מוסיפים רשומה לכל חבילה שרוצים לייבא, וממפים את שם החבילה למיקום בדיסק. חשוב לצרף את file: לנתיב הקובץ .tgz. לדוגמה, אם מייבאים את com.google.firebase.storage ואת יחסי התלות שלו, הערך של manifest.json ייראה כך:

    {
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
    // com.unity package entries...
  }
}

  5. שומרים את קובץ ה-manifest.json.

  6. כשהמיקוד יחזור ל-Unity, הוא יטען מחדש את manifest.json ויייבא את החבילות שנוספו.

חלק מהגרסאות הישנות של Unity לא תומכות בקבצים מסוג .tgz ב-manifest.json. במקרה כזה, צריך:

  1. מבטלים את דחיסת הקובץ .tgz.

  2. עורכים את הקובץ manifest.json כך שישתמש בנתיב לתיקייה שחולצה, במקום בקובץ .tgz, באופן הבא:

    {
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
    // com.unity package entries...
  }
}

מעבר מ-Unity Package Manager לחבילות נכסים

במקרים מסוימים, כדאי לעבור משימוש ב-Unity Package Manager למעקב אחרי מוצרי Firebase, לייבוא מוצרים בתיקייה Assets.

אם אתם לא בטוחים באיזו שיטת ייבוא אתם משתמשים, פותחים את הקובץ Packages/manifest.json בתיקיית הפרויקט ב-Unity. אם הקובץ מכיל רשומות שמתחילות ב-com.google.firebase, המשמעות היא שהפרויקט שלכם השתמש ב-Unity Package Manager לייבוא.

כדי לעבור לחבילות של נכסים:

  1. בודקים מהן הגרסאות הנוכחיות של חבילות Firebase בפרויקט ומסירים אותן.

    1. בתפריט Window, בוחרים באפשרות Package Manager. בחלון Package Manager, מוודאים שהאפשרות Packages: In Project מסומנת.
    2. שימו לב לגרסאות של חבילות Firebase שיובאו.
    3. לוחצים על כל שם של חבילת קוד ולאחר מכן לוחצים על הסרה. חשוב להסיר את החבילה של External Dependency Manager‏ (.com.google.external-dependency-manager) ואת חבילות Firebase.

  2. מורידים ומביאים קבצים חלופיים מסוג .unitypackage. תוכל להגדיר אחת משתי אפשרויות:

    • אם אפשר לשדרג לכל אחת מהחבילות לגרסה העדכנית ביותר, מורידים את קובץ ה-zip של Firebase Unity SDK ומבצעים את הייבוא כפי שמתואר במאמר הוספת Firebase לפרויקט ב-Unity.
    • אם אתם צריכים לשמור את הגרסאות הנוכחיות של .unitypackage, תוכלו להוריד ולייבא חבילות נפרדות כפי שמתואר למעלה בדף הזה.

מעבר מחבילות נכסים ל-Unity Package Manager

במקרים מסוימים, כדאי לעבור מייבוא מוצרים בתיקייה Assets לייבוא מוצרים ומעקב אחריהם באמצעות Unity Package Manager.

אם אתם לא בטוחים באיזו שיטת ייבוא אתם משתמשים, פותחים את הקובץ Packages/manifest.json בתיקיית הפרויקט ב-Unity. אם הקובץ מכיל רשומות שמתחילות ב-com.google.firebase, סימן שהפרויקט כבר משתמש ב-Unity Package Manager לייבוא.

כדי לעבור ל-Unity Package Manager:

  1. מוודאים שכל חבילות Firebase וחבילה של מנהל יחסי התלות החיצוניים הוסרו מהתיקייה Assets באחת מהשיטות הבאות.

    ממשק המשתמש של EDM4U

    1. בפרויקט הפתוח ב-Unity, עוברים אל Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages.
    2. בוחרים את כל החבילות של Firebase ואת External Dependency Manager.
    3. לוחצים על Uninstall Selected Package (הסרת החבילה שנבחרה).

    הסרה ידנית

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

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. מייבאים חבילות באמצעות Unity Package Manager, כפי שמתואר למעלה בדף הזה.