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

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

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

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

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

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

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

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

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

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

ייבוא חבילות 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 ואת יחסי התלות שלו, המניפסט ייראה כך:

   {
     "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 יתמקד, הוא יטען מחדש את המניפסט.json וייבא את החבילות החדשות שנוספו.

חלק מהגרסאות הישנות של Unity לא תומכות בקובצי .tgz ב-manifest.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. פתיחת החלון של Unity Package Manager (מנהל החבילות).

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

   

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

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

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

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

   

   הערה: מערכת Unity 2018 ממקמת את הסמל + בפינה הימנית התחתונה של החלונית של רשימת החבילות.

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

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

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

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

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

הערה: אם כבר התקנת את החבילה עם קובץ .unitypackage, חשוב למחוק את הגרסה הזו לפני שמוסיפים גרסה חדשה. בהמשך מפורטות הוראות.

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

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

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

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

במקרים מסוימים, יכול להיות שתרצו לעבור מ-Unity Package Manager לניהול חבילות של Google, להתקנת חבילות בתיקייה Assets (נכסים).

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

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

1. פתיחת החלון של Unity Package Manager (מנהל החבילות).

2. בוחרים באפשרות In Project בתפריט הנפתח שבפינה הימנית העליונה.

   

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

   

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 הרצויות מופיעות בכרטיסייה Project, בקטע'נכסים'.

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

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

   • כדי להסיר חבילות של Firebase, יש לפעול לפי ההוראות האלה.
   • כדי להסיר את Play Plugins for Unity, צריך למחוק את התיקייה GooglePlayPlugins בקטע Assets.

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

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

כאן מפורטות ההוראות ל-Firebase.