Zamiast pobierać duży plik .zip
zawierający wszystkie pliki .unitypackage
dla .NET 3.X i .NET 4.X, możesz pobrać poszczególne pakiety z strony interfejsów API Google dla Unity.
Na stronie znajdziesz:
- Pojedyncze pliki .NET 4.X
.unitypackage
do zaimportowania jako pakiety komponentów. - pojedyncze archiwa
.tgz
, które można zaimportować za pomocą menedżera pakietów Unity;
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 zależą.
Na tej stronie znajdziesz instrukcje dotyczące menedżera pakietów Unity, dlatego warto zapoznać się z dokumentacją Unity na temat tego narzędzia.
Importowanie pakietów Firebase jako komponentów
Podczas importowania usług Firebase z plików .unitypackage
pobranych z witryny interfejsów API Google dla Unity należy pamiętać o tych kwestiach:
Jeśli w projekcie używasz kilku usług Firebase, musisz pobrać i uaktualnić wszystkie usługi Firebase do tej samej wersji.
Nie mieszaj metod importowania w jednym projekcie. Oznacza to, że nie należy importować produktów Firebase za pomocą procesu importowania pakietu zasobów ani za pomocą procesu importowania pakietu w Menedżerze pakietów Unity.
Po pobraniu pliku:
W otwartym projekcie Unity kliknij Zasoby > Importuj pakiet > Własny pakiet.
W oknie Importowanie pakietu dla Unity kliknij Importuj.
Importowanie pakietów Firebase za pomocą menedżera pakietów Unity
Podczas importowania usług Firebase z plików .tgz
pobranych z archiwum interfejsów API Google dla Unity należy pamiętać o tych kwestiach:
Ta metoda jest dostępna tylko w wersji 2018.3 i nowszych.
Jeśli w projekcie używasz kilku usług Firebase, musisz pobrać i uaktualnić wszystkie usługi Firebase do tej samej wersji.
Nie mieszaj metod importowania w jednym projekcie. Oznacza to, że nie należy importować produktów Firebase za pomocą procesu importowania pakietu zasobów ani menedżera pakietów Unity.
Zależność każdego pliku
.tgz
produktu jest połączona z odpowiednim plikiem.tgz
. Musisz pobrać i zaimportować plik.tgz
produktu oraz pliki.tgz
zależności w odpowiedniej kolejności:- Menedżer zależności zewnętrznych (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Usługi Firebase używane w Twoim projekcie. Jeśli używasz wersji Realtime Database lub
Cloud Storage, najpierw zaimportuj wersję Authentication (
com.google.firebase.auth
).
- Menedżer zależności zewnętrznych (
Po pobraniu zaimportuj pliki .tgz
do projektu, korzystając z jednej z tych 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. - W przeglądarce plików wybierz odpowiedni plik tarball.
Niektóre starsze wersje Unity 2019 nie obsługują bezpośredniego dodawania plików tarballs. W takim przypadku:
- Rozpakuj plik
.tgz
. - W lewym górnym rogu okna Menedżera pakietów kliknij ikonę
+
i wybierzAdd package from disk
, aby otworzyć przeglądarkę plików. - W przeglądarce plików wybierz wyodrębniony folder.
manifest.json
- Utwórz nowy folder obok folderu
Packages
projektu i nazwij goGooglePackages
. - Umieść w nim pliki
.tgz
. - W edytorze tekstu otwórz plik
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 dodać
file:
do ścieżki pliku.tgz
. Jeśli na przykład importujesz pakietcom.google.firebase.storage
i jego zależności, pakietmanifest.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 fokus, ponownie załaduje
manifest.json
i importuje nowo dodane pakiety.
Niektóre starsze wersje Unity nie obsługują plików .tgz
w folderze manifest.json
.
W takim przypadku:
- Rozpakuj plik
.tgz
. Zmień wartość parametru
manifest.json
, aby używać ścieżki do wyodrębnionego folderu zamiast pliku.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... } }
Migracja z Unity Package Managera do pakietów zasobów
W niektórych przypadkach możesz chcieć przełączyć się z użycia menedżera pakietów Unity na śledzenie produktów Firebase lub importowanie produktów do folderu 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 przejść na pakiety komponentów:
Zapisz obecne wersje pakietów Firebase w projekcie i usuń je.
- W menu Okno wybierz Menedżer pakietów. W oknie Menedżer pakietów sprawdź, czy wybrana jest opcja „Pakiety: w projekcie”.
- Zanotuj wersje zaimportowanych pakietów Firebase.
- Kliknij nazwę każdego pakietu, a potem kliknij Usuń. Pamiętaj, aby usunąć pakiet menedżera zależności zewnętrznych (
.com.google.external-dependency-manager
), a także pakiety Firebase.
Pobierz i zaimportuj pliki
.unitypackage
, które zastąpią dotychczasowe. Dostępne są dwie opcje:- Jeśli możesz przejść na najnowszą wersję każdego pakietu, pobierz plik zip pakietu Firebase Unity SDK i zaimportuj go zgodnie z instrukcjami podanymi w artykule Dodawanie Firebase do projektu Unity.
- Jeśli chcesz zachować bieżące wersje
.unitypackage
, możesz pobrać i zaimportować poszczególne pakiety w sposób opisany wyżej na tej stronie.
Migracja z pakietów zasobów do menedżera pakietów Unity
W niektórych przypadkach możesz chcieć zmienić importowanie produktów w folderze
Assets
na importowanie i śledzenie produktów za pomocą menedżera pakietów Unity.
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 importowania menedżera pakietów Unity.
Aby przejść na menedżera pakietów Unity:
Upewnij się, że wszystkie pakiety Firebase i pakiet menedżera zależności zewnętrznych zostały usunięte z folderu
Assets
. Możesz to zrobić, korzystając z jednej z tych metod.EDM4U UI
- W otwartym projekcie Unity przejdź do Zasoby > Menedżer zależności zewnętrznych > Obsługa wersji > Odinstaluj zarządzane pakiety.
- Wybierz wszystkie pakiety Firebase i menedżera zależności zewnętrznych.
- Kliknij Odinstaluj wybrany pakiet.
Ręczne usunięcie
Za pomocą narzędzi systemu plików ręcznie usuń te foldery:
Assets/Editor Default Resources/Firebase
Assets/ExternalDependencyManager
Assets/Firebase
Assets/Parse
Assets/Plugins/iOS/Firebase
Zaimportuj pakiety za pomocą menedżera pakietów Unity zgodnie z opisem powyżej na tej stronie.