חבילות 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 (נכסים).
ייבוא חבילות UPM עם קובצי .tgz
(2018.4 ואילך)
אפשר לייבא .tgz
קבצים לפרויקט באמצעות אחת מהשיטות הבאות:
manifest.json
- יוצרים תיקייה חדשה ליד התיקייה
Packages
של הפרויקט, ונותנים לה את השםGooglePackages
. - צריך לשמור את הקבצים של
.tgz
בתיקייה הזו. - משתמשים בכלי לעריכת טקסט כדי לפתוח את
Packages/manifest.json
בתיקיית הפרויקט ב-Unity. מוסיפים רשומה לכל חבילה שרוצים להתקין, וממפים את שם החבילה למיקום בדיסק ביחס לקובץ
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... } }
שומרים את הקובץ Manifest.json.
כשהמיקוד ב-Unity יתמקד, הוא יטען מחדש את המניפסט.json וייבא את החבילות החדשות שנוספו.
חלק מהגרסאות הישנות של Unity לא תומכות בקובצי .tgz
ב-manifest.json.
במקרה כזה, עליכם:
- מבטלים את הדחיסה של
.tgz
הקבצים. - צריך למקם את התיקייה שחולצת בתיקייה
GooglePackages
. עורכים את המניפסט.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 (מנהל החבילות).
לוחצים על הסמל
+
בפינה הימנית העליונה של חלון מנהל החבילות ובוחרים באפשרותAdd package from tarball
כדי לפתוח את דפדפן הקבצים.בוחרים את מקש ה-tarball הרצוי בדפדפן הקבצים.
חלק מהגרסאות הישנות של Unity לא תומכות בהוספה ישירה של tarball. במקרה כזה, תצטרכו:
- מבטלים את הדחיסה של הקובץ
.tgz
. לוחצים על הסמל
+
בפינה הימנית העליונה של החלון של מנהל החבילות ובוחרים באפשרותAdd package from disk
כדי לפתוח את דפדפן הקבצים.בוחרים את התיקייה שחולצתה בדפדפן הקבצים.
חשוב גם לייבא את קובצי .tgz
של יחסי התלות של החבילה, שמופיעים בדף הארכיון בקטע של החבילה הרצויה.
לדוגמה, אם מתקינים את com.google.firebase.storage
, צריך להתקין את .tgz
הקבצים האלה בסדר הבא:
- מנהל תלות חיצוני (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - אימות Firebase (
com.google.firebase.auth
) - אחסון ב-Firebase (
com.google.firebase.storage
)
אם אתם מעדיפים להוסיף את כל הקבצים של .tgz
בבת אחת, בלי לדאוג לגבי הסדר, תוכלו לפעול לפי ההוראות בכרטיסייה Manifest.json.
ניהול הגרסאות
אם אתם משתמשים בתוכנה לניהול גרסאות כדי לנהל את קובצי הפרויקט, מומלץ להוסיף את קובצי .tgz
הרלוונטיים לניהול הגרסאות. תוכלו לערוך ידנית את השדה manifest.json
של הפרויקט (ראו הוראות למעלה) ולהפנות לקובצי .tgz
מקומיים באמצעות נתיבים יחסיים.
אם אתם משתמשים ב-Git, מומלץ להשתמש ב-Git Large File Storage (LFS)
לניהול קובצי .tgz
גדולים.
מעבר מחבילות UPM לחבילות נכסים
במקרים מסוימים, יכול להיות שתרצו לעבור מ-Unity Package Manager לניהול חבילות של Google, להתקנת חבילות בתיקייה Assets (נכסים).
מוודאים שכל חבילות Google יוסרו מ-Unity Package Manager באמצעות אחת מהשיטות הבאות:
ממשק המשתמש של מנהל החבילות
- פתיחת החלון של Unity Package Manager (מנהל החבילות).
בוחרים באפשרות
In Project
בתפריט הנפתח שבפינה הימנית העליונה.מקלידים
com.google
בסרגל החיפוש כדי לסנן לפי חבילות של Google.לוחצים על השם של כל חבילה ואז לוחצים על
Remove
.
manifest.json
- משתמשים בכלי לעריכת טקסט כדי לפתוח את
Packages/manifest.json
בתיקיית הפרויקט ב-Unity. - בודקים אם יש חבילות מ-Google בקטע 'תלות'. שם החבילה צריך להתחיל ב-"com.google", למשל "com.google.firebase.app".
- מוחקים את השורות האלה ושומרים את קובץ ה-JSON.
- כשהמיקוד ב-Unity יתמקד, היא תטען מחדש את הקובץ
manifest.json
ותסיר את החבילות שנמחקו.
אחרי שמסירים את החבילות מ-Unity Package Manager, אפשר להוריד ולייבא קובצי .unitypackage
חלופיים מדף הארכיון.
מעבר מחבילות של נכסים לחבילות UPM
במקרים מסוימים, יכול להיות שתרצו לעבור מהתקנת מוצרים בעץ הנכסים הדיגיטליים להתקנה ולמעקב אחרי מוצרים באמצעות Unity Package Manager.
אם אתם לא בטוחים באיזו שיטת התקנה אתם משתמשים, כדאי לבדוק בממשק המשתמש של Unity אם חבילות Google הרצויות מופיעות בכרטיסייה Project, בקטע'נכסים'.
כדי לעבור לחבילות UPM:
יש לוודא שכל חבילות Google הוסרו מתיקיית הנכסים.
- כדי להסיר חבילות של Firebase, יש לפעול לפי ההוראות האלה.
- כדי להסיר את Play Plugins for Unity, צריך למחוק את התיקייה
GooglePlayPlugins
בקטעAssets
.
מתקינים חבילות באמצעות Unity Package Manager, כפי שמתואר למעלה.
הוראות העברה ספציפיות למוצר
כאן מפורטות ההוראות ל-Firebase.