התקנה של חבילות Google ל-Unity

חבילות Google ל-Unity מופצות בשני פורמטים שונים:

  • חבילות נכסים:
    • צריך תוסף .unitypackage.
    • התקנה בספריית Assets של הפרויקט.
    • ניתן לייבא אותם מ-Unity מגרסה 5 ואילך.
    • בדרך כלל כוללים חבילות תלויות.
  • חבילות Unity Package Manager (UPM):
    • צריך תוסף .tgz.
    • התקנה בספריית Packages של הפרויקט.
    • ניתן לייבא אותם ב-Unity מגרסה 2018.4 ואילך.
    • יש להפנות לחבילות תלויות שצריך להתקין בנפרד.

הדף Packages מכיל את קובצי .unitypackage האחרונים עבור כל החבילות הזמינות, ו-.tgz קובצי עבור חלק מהחבילות.

דף הארכיון מכיל .unitypackage ו-.tgz קבצים עבור כל הגרסאות של החבילות.

בהמשך מפורטות הוראות להתקנת שני סוגי החבילות, עם הוראות העברה למעבר מטיפוס לסוג לאחר.

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

ייבוא חבילות של נכסים עם .unitypackage קבצים

אפשר לייבא את הקובץ .unitypackage על ידי בחירה באפשרות התפריט של Unity Assets > Import package > Custom Package מתבצע ייבוא של כל הפריטים. הפעולה הזו מוסיפה את תוכן החבילה לפרויקט שלכם בקטע 'נכסים'

ייבוא חבילות UPM עם קובצי .tgz (2018.4 ואילך)

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

manifest.json

  1. יוצרים תיקייה חדשה ליד התיקייה Packages של הפרויקט ונותנים לה שם GooglePackages.
  2. מעבירים את .tgz הקבצים לתיקייה הזו.
  3. שימוש בכלי לעריכת טקסט כדי לפתוח את Packages/manifest.json בפרויקט ב-Unity .
  4. מוסיפים רשומה לכל חבילה שרוצים להתקין וממפים את שם החבילה למיקום בדיסק, ביחס לקובץ Packages/manifest.json. חשוב להוסיף את file: לנתיב הקובץ .tgz. עבור לדוגמה, אם התקנת את com.google.firebase.storage של יחסי התלות, המניפסט שלך.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. שומרים את הקובץman.json.

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

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

  1. מבטלים את הדחיסה של .tgz הקבצים.
  2. מעבירים את התיקייה שחולצה בתיקייה GooglePackages.
  3. במקום זאת, צריך לערוך את קובץ המניפסט.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...
      }
    }
    

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

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

    צילום מסך של חלון Unity Package Manager עם

  3. בוחרים את ה-tarball הרצוי בדפדפן הקבצים.

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

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

    צילום מסך של חלון Unity Package Manager עם

  3. בוחרים את התיקייה שחולץ בדפדפן הקבצים.

חשוב גם לייבא את קובצי .tgz עבור יחסי התלות של החבילה, שנמצא בדף הארכיון, הקטע של החבילה הרצויה.

לדוגמה, אם התקנת את com.google.firebase.storage, צריך: התקינו את .tgz הקבצים לפי הסדר הבא:

  1. מנהל תלות חיצוני (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase Auth (com.google.firebase.auth)
  4. אחסון ב-Firebase (com.google.firebase.storage)

אם ברצונך להוסיף את כל .tgz הקבצים בבת אחת, בלי לדאוג בקשר להזמנה, אפשר לפעול לפי ההוראות הכרטיסייה Manifest.json.

ניהול הגרסאות

אם אתם משתמשים בתוכנה לניהול גרסאות כדי לנהל את קובצי הפרויקט שלכם, אנחנו מומלץ להוסיף את .tgz הקבצים הרלוונטיים לניהול הגרסאות. אפשר באופן ידני לערוך את manifest.json של הפרויקט (מידע נוסף זמין כאן: שמופיעות למעלה) והתייחסות לקובצי .tgz מקומיים באמצעות נתיבים יחסיים.

אם אתם משתמשים ב-Git, מומלץ Git Large File Storage (LFS) לניהול קובצי .tgz גדולים.

מעבר מחבילות UPM לחבילות נכסים

במקרים מסוימים, ייתכן שתרצו לעבור מ- מנהל החבילות של Unity כדי לנהל חבילות של Google, להתקין חבילות בתיקייה 'נכסים'.

מוודאים שכל החבילות של Google הוסרו מ-Unity Package Manager באמצעות אחת מהשיטות הבאות:

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

  1. פותחים את החלון Package Manager (מנהל החבילות) של Unity.
  2. בוחרים באפשרות In Project בתפריט הנפתח שבפינה הימנית העליונה.

    צילום מסך של חלון Unity Package Manager עם

  3. כדי לסנן לפי חבילות של Google, צריך להקליד com.google בסרגל החיפוש.

    צילום מסך של חלון Unity Package Manager עם

  4. לוחצים על כל שם חבילה ואז לוחצים על Remove.

manifest.json

  1. שימוש בכלי לעריכת טקסט כדי לפתוח את Packages/manifest.json בפרויקט ב-Unity .
  2. בודקים אם יש חבילות מ-Google בקטע 'יחסי תלות'. החבילה השם צריך להתחיל ב-"com.google", לדוגמה: "com.google.firebase.app".
  3. מוחקים את השורות האלה ושומרים את קובץ ה-JSON.
  4. כשהמיקוד יופעל מחדש ב-Unity, הקובץ manifest.json ייטען מחדש ותוסר את החבילות שנמחקו.

לאחר הסרת החבילות האלה מ-Unity Package Manager, תוכל הורדה וייבוא של קובצי .unitypackage חלופיים מהארכיון .

מעבר מחבילות נכסים לחבילות UPM

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

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

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

  1. צריך לוודא שכל החבילות של Google הוסרו מהתיקייה 'נכסים'.

    • כדי להסיר חבילות של Firebase, יש לפעול לפי ההוראות האלה.
    • כדי להסיר את יישומי הפלאגין של Play ל-Unity, צריך למחוק את התיקייה GooglePlayPlugins מתחת ל-Assets.
  2. התקנת חבילות באמצעות Unity Package Manager, כפי שמתואר למעלה.

הוראות העברה ספציפיות למוצר

כאן יש הוראות בנוגע ל-Firebase.