Dodatkowe opcje instalacji Unity
Zamiast pobierać duży plik .zip
zawierający wszystkie pliki .unitypackage
zarówno dla platformy .NET 3.X, jak i .NET 4.X, możesz pobrać poszczególne pakiety z witryny interfejsów API Google dla Unity .
Witryna zapewnia:
- Pojedyncze pliki .NET 4.X
.unitypackage
do zaimportowania jako pakiety zasobów. - Pojedyncze archiwa
.tgz
do zaimportowania za pomocą Unity Package Manager.
Jest to szczególnie przydatne, gdy aplikacja korzysta z jednego produktu Firebase, ponieważ poszczególne pliki .unitypackage
zawierają wszystkie potrzebne zależności, a pliki .tgz
są wymienione obok powiązanych plików .tgz
, od których są zależne.
Ta strona zawiera instrukcje dotyczące Unity Package Manager, więc dobrze jest zapoznać się z narzędziem z dokumentacji Unity .
Importuj pakiety Firebase jako zasoby
Podczas importowania produktów .unitypackage
z plików .unitypackage pobranych z witryny Google APIs for Unity pamiętaj o następujących kwestiach:
Jeśli w swoim projekcie używasz wielu produktów Firebase, musisz pobrać i uaktualnić wszystkie produkty Firebase do tej samej wersji.
Nie mieszaj metod importu w jednym projekcie. Oznacza to, że nie należy importować produktów Firebase z przepływem pakietów zasobów i przepływem Unity Package Manager.
Po pobraniu, aby zaimportować:
W otwartym projekcie Unity przejdź do Zasoby > Importuj pakiet > Pakiet niestandardowy .
W oknie Importuj pakiet Unity kliknij opcję Importuj .
Importuj pakiety Firebase za pomocą Unity Package Manager
Podczas importowania produktów Firebase z plików .tgz
pobranych z archiwum Google APIs for Unity pamiętaj o następujących kwestiach:
Ta metoda jest dostępna tylko w 2018.3+.
Jeśli w swoim projekcie używasz wielu produktów Firebase, musisz pobrać i uaktualnić wszystkie produkty Firebase do tej samej wersji.
Nie mieszaj metod importu w jednym projekcie. Oznacza to, że nie należy importować produktów Firebase z przepływem pakietów zasobów i przepływem Unity Package Manager.
Zależności dla każdego pliku
.tgz
produktu są połączone obok we własnych plikach.tgz
. Musisz pobrać i zaimportować plik.tgz
produktu oraz pliki zależności.tgz
w odpowiedniej kolejności:- Zewnętrzny menedżer zależności (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Produkty Firebase używane w Twoim projekcie. Jeśli używasz Bazy danych czasu rzeczywistego lub Cloud Storage, najpierw zaimportuj uwierzytelnianie (
com.google.firebase.auth
).
- Zewnętrzny menedżer zależności (
Po pobraniu zaimportuj pliki .tgz
do swojego projektu, korzystając z jednej z następujących metod:
Interfejs Menedżera Pakietów
- Otwórz okno Menedżera pakietów Unity.
- Kliknij ikonę
+
w lewym górnym rogu okna Menedżera pakietów i wybierzAdd package from tarball
, aby otworzyć przeglądarkę plików. - Wybierz żądaną paczkę w przeglądarce plików.
Niektóre starsze wersje Unity 2019 nie obsługują bezpośredniego dodawania tarballi. W takim przypadku będziesz musiał:
- Rozpakuj plik
.tgz
. - Kliknij ikonę
+
w lewym górnym rogu okna Menedżera pakietów i wybierzAdd package from disk
aby otworzyć przeglądarkę plików. - Wybierz wyodrębniony folder w przeglądarce plików.
manifest.json
- Utwórz nowy folder obok folderu
Packages
projektu i nazwij goGooglePackages
. - Umieść pliki
.tgz
w tym folderze. - Użyj edytora tekstu, aby otworzyć
Packages/manifest.json
w folderze projektu Unity. Dodaj wpis dla każdego pakietu, który chcesz zaimportować, mapując nazwę pakietu na lokalizację na dysku. Pamiętaj, aby dołączyć
file:
do ścieżki pliku.tgz
. Na przykład, jeśli importujeszcom.google.firebase.storage
i jego zależności, Twójmanifest.json
będzie wyglądał tak:{ "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... } }
Zapisz plik
manifest.json
.Gdy Unity odzyska koncentrację, przeładuje plik
manifest.json
i zaimportuje nowo dodane pakiety.
Niektóre starsze wersje Unity nie obsługują plików .tgz
w manifest.json
. W takim przypadku powinieneś:
- Rozpakuj plik
.tgz
. Edytuj swój
manifest.json
, aby użyć ścieżki do wyodrębnionego folderu zamiast pliku.tgz
, na przykład:{ "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... } }
Migracja z Unity Package Manager do Asset Packages
W niektórych przypadkach możesz chcieć przełączyć się z używania Unity Package Manager do śledzenia produktów Firebase na importowanie produktów w folderze Assets
.
Jeśli nie masz pewności, której metody importowania używasz, w folderze projektu Unity otwórz plik Packages/manifest.json
. Jeśli plik zawiera wpisy zaczynające się od com.google.firebase
, Twój projekt używał do importu Menedżera pakietów Unity.
Aby przeprowadzić migrację do pakietów zasobów:
Zanotuj aktualne wersje pakietów Firebase w swoim projekcie i usuń je.
- Z menu Okno wybierz Menedżera pakietów . W oknie Menedżera pakietów upewnij się, że wybrana jest opcja „Pakiety: w projekcie”.
- Zwróć uwagę na wersje zaimportowanych pakietów Firebase.
- Kliknij nazwę każdego pakietu, a następnie kliknij Usuń . Pamiętaj, aby usunąć pakiet External Dependency Manager (
.com.google.external-dependency-manager
) oraz pakiety Firebase.
Pobierz i zaimportuj zastępcze pliki
.unitypackage
. Masz dwie opcje:- Jeśli możesz uaktualnić do najnowszej wersji każdego pakietu, pobierz plik ZIP pakietu Firebase Unity SDK i zaimportuj go zgodnie z opisem w sekcji Dodawanie Firebase do projektu Unity .
- Jeśli chcesz zachować bieżące wersje
.unitypackage
, możesz pobrać i zaimportować poszczególne pakiety, jak opisano powyżej na tej stronie.
Migracja z pakietów zasobów do Unity Package Manager
W niektórych przypadkach możesz chcieć przełączyć się z importowania produktów w folderze Assets
na importowanie i śledzenie produktów za pomocą Unity Package Manager.
Jeśli nie masz pewności, której metody importowania używasz, w folderze projektu Unity otwórz plik Packages/manifest.json
. Jeśli plik zawiera wpisy zaczynające się od com.google.firebase
, Twój projekt używa już do importu Unity Package Manager.
Aby przeprowadzić migrację do Unity Package Manager:
Upewnij się, że wszystkie pakiety Firebase i pakiet External Dependency Manager zostały usunięte z folderu
Assets
, korzystając z jednej z poniższych metod.Interfejs Menedżera Pakietów
- W otwartym projekcie Unity przejdź do pozycji Assets > External Dependency Manager > Program obsługi wersji > Odinstaluj pakiety zarządzane .
- Wybierz wszystkie pakiety Firebase i External Dependency Manager.
- Kliknij Odinstaluj wybrany pakiet .
Usuwanie ręczne
Korzystając z narzędzi systemu plików, ręcznie usuń następujące foldery:
-
Assets/Editor Default Resources/Firebase
-
Assets/ExternalDependencyManager
-
Assets/Firebase
-
Assets/Parse
-
Assets/Plugins/iOS/Firebase
Importuj pakiety za pomocą Unity Package Manager, jak opisano powyżej na tej stronie.