במקום להוריד קובץ גדול של .zip
שמכיל את כל הקבצים של .NET 3.X ו- .NET 4.X, אפשר להוריד חבילות בודדות מהאתר של Google APIs for Unity..unitypackage
האתר מספק:
- קבצים בודדים של .NET 4.X
.unitypackage
לייבוא כחבילות נכסים. - ארכיונים של משתמשים פרטיים
.tgz
לייבוא באמצעות Unity Package Manager.
האפשרות הזו שימושית במיוחד אם האפליקציה שלכם משתמשת במוצר אחד של Firebase, כי קובצי .unitypackage
מכילים את כל התלות הנדרשת, וקובצי .tgz
מופיעים לצד קובצי .tgz
קשורים שהם תלויים בהם.
בדף הזה מופיעות הוראות שקשורות ל-Unity Package Manager, ולכן מומלץ לקרוא על הכלי במסמכי התיעוד של Unity.
ייבוא חבילות Firebase כנכסים
כשמייבאים מוצרי Firebase מקובצי .unitypackage
שהורדו מאתר Google APIs for Unity, חשוב לזכור את הדברים הבאים:
אם אתם משתמשים בכמה מוצרים של Firebase בפרויקט, אתם צריכים להוריד את כל המוצרים של Firebase ולשדרג אותם לאותה גרסה.
אל תערבבו שיטות ייבוא בפרויקט אחד. כלומר, לא מייבאים מוצרי Firebase באמצעות תהליך העבודה של חבילת הנכסים וגם באמצעות תהליך העבודה של Unity Package Manager.
אחרי ההורדה, כדי לייבא:
בפרויקט הפתוח ב-Unity, עוברים אל Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה מותאמת אישית).
בחלון Import Unity Package (ייבוא חבילת Unity), לוחצים על Import (ייבוא).
ייבוא חבילות Firebase באמצעות Unity Package Manager
כשמייבאים מוצרי Firebase מקובצי .tgz
שהורדו מארכיון Google APIs for Unity, חשוב לזכור את הדברים הבאים:
השיטה הזו זמינה רק בגרסה 2018.3 ואילך.
אם אתם משתמשים בכמה מוצרים של Firebase בפרויקט, אתם צריכים להוריד את כל המוצרים של Firebase ולשדרג אותם לאותה גרסה.
אל תערבבו שיטות ייבוא בפרויקט אחד. כלומר, אל תייבאו מוצרי Firebase באמצעות תהליך חבילת הנכסים ותהליך Unity Package Manager.
יחסי התלות של כל מוצר
.tgz
מקושרים בקבצים נפרדים משלהם..tgz
צריך להוריד ולייבא את קובץ.tgz
המוצרים ואת קובצי.tgz
התלות, בסדר הנכון:- מנהל תלות חיצוני (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - מוצרי Firebase שבהם נעשה שימוש בפרויקט. אם אתם משתמשים ב-Realtime Database או ב-Cloud Storage, אתם צריכים לייבא קודם את Authentication (
com.google.firebase.auth
).
- מנהל תלות חיצוני (
אחרי ההורדה, מייבאים את קובצי .tgz
לפרויקט באחת מהשיטות הבאות:
- פותחים את חלון Package Manager (מנהל החבילות) של Unity.
- לוחצים על הסמל
+
בפינה הימנית העליונה של החלון Package Manager (ניהול חבילות) ובוחרים באפשרותAdd package from tarball
כדי לפתוח את דפדפן הקבצים. - בוחרים את קובץ ה-tar.gz הרצוי בדפדפן הקבצים.
חלק מהגרסאות הישנות של Unity 2019 לא תומכות בהוספה ישירה של קובצי tarball. במקרה כזה, תצטרכו:
- מבטלים את דחיסת הקובץ
.tgz
. - לוחצים על הסמל
+
בפינה הימנית העליונה של החלון Package Manager (ניהול חבילות) ובוחרים באפשרותAdd package from disk
כדי לפתוח את דפדפן הקבצים. - בוחרים את התיקייה שחולצה בדפדפן הקבצים.
- יוצרים תיקייה חדשה לצד התיקייה
Packages
של הפרויקט ונותנים לה את השםGooglePackages
. - מניחים את הקבצים
.tgz
בתיקייה הזו. - משתמשים בכלי לעריכת טקסט כדי לפתוח את
Packages/manifest.json
בתיקייה של פרויקט Unity. מוסיפים רשומה לכל חבילה שרוצים לייבא, וממפים את שם החבילה למיקום בדיסק. חשוב להוסיף את
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... } }
שומרים את קובץ ה-
manifest.json
.כש-Unity יחזור למצב פעיל, הוא יטען מחדש את
manifest.json
וייבא את החבילות החדשות שנוספו.
חלק מהגרסאות הישנות של Unity לא תומכות בקובצי .tgz
ב-manifest.json
.
במקרה כזה, צריך:
- מבטלים את דחיסת הקובץ
.tgz
. עורכים את
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 לייבוא.
כדי לעבור לחבילות נכסים:
רושמים את הגרסאות הנוכחיות של חבילות Firebase בפרויקט ומסירים אותן.
- בתפריט Window (חלון), בוחרים באפשרות Package Manager (ניהול חבילות). בחלון Package Manager, מוודאים שהאפשרות Packages: In Project (חבילות: בפרויקט) נבחרה.
- שימו לב לגרסאות של חבילות Firebase שיובאו.
- לוחצים על כל שם חבילה ואז על הסרה. חשוב להסיר את חבילת External Dependency Manager (
.com.google.external-dependency-manager
) וגם את חבילות Firebase.
מורידים ומייבאים קובצי
.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:
חשוב לוודא שכל חבילות Firebase וחבילת External Dependency Manager הוסרו מהתיקייה
Assets
, באחת מהשיטות הבאות.- בפרויקט הפתוח ב-Unity, עוברים אל Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages (נכסים > כלי לניהול תלות חיצונית > כלי לניהול גרסאות > הסרת חבילות מנוהלות).
- בוחרים את כל חבילות Firebase ואת External Dependency Manager (מנהל יחסי תלות חיצוני).
- לוחצים על Uninstall Selected Package (הסרת החבילה שנבחרה).
באמצעות כלים של מערכת הקבצים, מוחקים ידנית את התיקיות הבאות:
Assets/Editor Default Resources/Firebase
Assets/ExternalDependencyManager
Assets/Firebase
Assets/Parse
Assets/Plugins/iOS/Firebase
מייבאים חבילות באמצעות Unity Package Manager, כמו שמתואר למעלה בדף הזה.