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

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

האתר מספק:

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

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

דף זה מספק הוראות הקשורות למנהל החבילות של Unity, לכן מומלץ ללמוד על הכלי מהתיעוד של Unity .

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

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

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

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

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

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

  2. בחלון ייבוא ​​חבילת אחדות , לחץ על ייבוא ​​.

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

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

  • שיטה זו זמינה רק בשנת 2018.3+.

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

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

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

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

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

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

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

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

  1. פתח את קובץ ה- .tgz .
  2. לחץ על הסמל + בפינה השמאלית העליונה של חלון מנהל החבילות ובחר 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 לחבילות Asset

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

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

כדי לעבור לחבילות Asset:

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

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

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

העבר מחבילות נכסים למנהל החבילות של Unity

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

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

כדי לעבור למנהל החבילות של Unity:

  1. ודא שכל חבילות Firebase וחבילת External Dependency Manager הוסרו מהתיקיה Assets , באמצעות אחת מהשיטות הבאות.

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

    1. בפרויקט Unity הפתוח שלך, נווט אל נכסים > מנהל תלות חיצוני > מטפל גרסה > הסר התקנה של חבילות מנוהלות .
    2. בחר את כל חבילות Firebase ואת מנהל התלות החיצוני.
    3. לחץ על הסר התקנה של חבילה נבחרת .

    הסרה ידנית

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

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. יבא חבילות באמצעות Unity Package Manager, כמתואר לעיל בדף זה.