Zamiast pobierać duży plik .zip
zawierający wszystkie pliki .unitypackage
zarówno dla .NET 3.X, jak i .NET 4.X, możesz pobrać poszczególne pakiety ze strony interfejsów API Google dla Unity.
Witryna zawiera:
- Pojedyncze pliki .NET 4.X
.unitypackage
do zaimportowania jako pakiety zasobów. - Pojedyncze archiwa
.tgz
do zaimportowania za pomocą menedżera pakietów Unity.
Jest to szczególnie przydatne, gdy Twoja aplikacja korzysta z jednej usługi Firebase, ponieważ poszczególne pliki .unitypackage
zawierają wszystkie potrzebne zależności, a pliki .tgz
są wyświetlane obok powiązanych plików .tgz
, od których zależą.
Ta strona zawiera instrukcje dotyczące menedżera pakietów Unity, warto więc dowiedzieć się więcej o tym narzędziu z dokumentacji Unity.
Importuj pakiety Firebase jako zasoby
Podczas importowania produktów Firebase z plików .unitypackage
pobranych z witryny interfejsów API Google dla Unity pamiętaj o następujących kwestiach:
Jeśli w swoim projekcie używasz wielu 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 importuj usług Firebase z użyciem przepływu pakietów zasobów ani procesu w Menedżerze pakietów Unity.
Aby zaimportować po pobraniu:
W otwartym projekcie Unity przejdź do Assets (Zasoby) i wybierz Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy).
W oknie Import Unity Package (Importuj pakiet Unity) kliknij Import (Importuj).
Importowanie pakietów Firebase za pomocą menedżera pakietów Unity
Podczas importowania produktów Firebase z .tgz
plików pobranych z archiwum interfejsów API Google dla Unity pamiętaj o tych kwestiach:
Ta metoda jest dostępna tylko w wersji 2018.3 i nowszych.
Jeśli w swoim projekcie używasz wielu 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 importuj usług Firebase za pomocą przepływu pakietów zasobów ani procesu w Menedżerze pakietów Unity.
Zależności dotyczące każdego pliku
.tgz
produktu są umieszczone w osobnych plikach.tgz
. Musisz pobrać i zaimportować plik.tgz
produktu oraz pliki.tgz
zależności w odpowiedniej kolejności:- Zewnętrzny menedżer zależności (
com.google.external-dependency-manager
) - Podstawowy pakiet funkcji Firebase (
com.google.firebase.app
) - Usługi 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 do projektu pliki .tgz
, 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. - Wybierz odpowiedni plik tarball w przeglądarce plików.
Niektóre starsze wersje Unity 2019 nie obsługują bezpośredniego dodawania plików TAR. W takim przypadku wykonaj te czynności:
- 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ść w nim pliki
.tgz
. - Za pomocą edytora tekstu otwórz
Packages/manifest.json
w folderze projektu Unity. Dodaj wpis dotyczący każdego pakietu, który chcesz zaimportować, mapując jego nazwę na lokalizację na dysku. Pamiętaj, aby do ścieżki pliku
.tgz
dołączyćfile:
. Jeśli na przykład importujesz atrybutcom.google.firebase.storage
i jego zależność,manifest.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 ponownie się włączy, załaduje ponownie
manifest.json
i zaimportuje nowo dodane pakiety.
Niektóre starsze wersje Unity nie obsługują plików .tgz
w manifest.json
.
W takim przypadku wykonaj te czynności:
- Rozpakuj plik
.tgz
. Zmień plik
manifest.json
, aby użyć ścieżki do wyodrębnionego folderu zamiast pliku.tgz
w następujący sposób:{ "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 menedżera pakietów Unity do pakietów zasobów
W niektórych przypadkach możesz chcieć przejść z Menedżera pakietów Unity do śledzenia usług Firebase na importowanie produktów w folderze Assets
.
Jeśli nie masz pewności, jakiej metody importowania używasz, otwórz plik Packages/manifest.json
w folderze projektu Unity. Jeśli plik zawiera wpisy rozpoczynające się od com.google.firebase
, Twój projekt do importowania używał Menedżera pakietów Unity.
Aby przeprowadzić migrację do pakietów zasobów:
Zanotuj bieżące wersje pakietów Firebase w projekcie i je usuń.
- W menu Okno wybierz Menedżer pakietów. Sprawdź, czy w oknie Menedżer pakietów zaznaczona jest opcja „Pakiety: w projekcie”.
- Zwróć uwagę na wersje zaimportowanych pakietów Firebase.
- Kliknij każdą nazwę pakietu, a następnie kliknij Usuń. Pamiętaj, by usunąć pakiet zewnętrznego menedżera zależności (
.com.google.external-dependency-manager
) oraz pakiety Firebase.
Pobierz i zaimportuj zastępcze pliki
.unitypackage
. Dostępne są dwie opcje:- Jeśli możesz uaktualnić każdy pakiet do najnowszej wersji, pobierz plik ZIP pakietu SDK Firebase Unity i zaimportuj go zgodnie z opisem w sekcji Dodawanie Firebase do projektu Unity.
- Jeśli chcesz zachować bieżące wersje
.unitypackage
, możesz pobierać i importować poszczególne pakiety w sposób opisany powyżej na tej stronie.
Migracja z pakietów zasobów do menedżera pakietów Unity
W niektórych przypadkach możesz chcieć przełączyć się z importowania produktów z folderu Assets
na importowanie i śledzenie produktów za pomocą menedżera pakietów Unity.
Jeśli nie masz pewności, jakiej metody importowania używasz, otwórz plik Packages/manifest.json
w folderze projektu Unity. Jeśli plik zawiera wpisy rozpoczynające się od com.google.firebase
, Twój projekt używa już do importowania menedżera pakietów Unity.
Aby przeprowadzić migrację do menedżera pakietów Unity:
Usuń wszystkie pakiety Firebase i pakiet zewnętrznego menedżera zależności z folderu
Assets
, używając jednej z poniższych metod.Interfejs EDM4U
- W otwartym projekcie Unity przejdź do Zasoby > Zewnętrzny menedżer zależności > Moduł obsługi wersji > Odinstaluj pakiety zarządzane.
- Wybierz wszystkie pakiety Firebase i zewnętrzny menedżer zależności.
- Kliknij Odinstaluj wybrany pakiet.
Usunięcie ręczne
Przy użyciu 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 w sposób opisany powyżej na tej stronie.