Pakiety Google na Unity są rozpowszechniane w 2 różnych formatach:
- Pakiety zasobów:
- Masz rozszerzenie
.unitypackage
. - Zainstaluj w katalogu
Assets
projektu. - Można je importować w Unity 5 i nowszych.
- Ogólnie obejmują pakiety zależne.
- Masz rozszerzenie
- Pakiety Menedżera pakietów Unity (UPM):
- Masz rozszerzenie
.tgz
. - Zainstaluj w katalogu
Packages
projektu. - Można zaimportować w Unity w wersji 2018.4 lub nowszej.
- Sprawdź zależne pakiety, które należy zainstalować oddzielnie.
- Masz rozszerzenie
Strona Pakiety zawiera najnowsze pliki .unitypackage
wszystkich dostępnych pakietów.
Strona Archiwum zawiera pliki .unitypackage
i .tgz
dla wszystkich wersji pakietów.
Poniżej znajdziesz instrukcje instalowania obu typów pakietów oraz instrukcje migracji z jednego typu na drugi.
Gdy zapoznasz się z tymi opcjami instalacji, zapoznaj się z dodatkowymi instrukcjami dotyczącymi poszczególnych usług dla Firebase.
Importuję pakiety zasobów zawierające .unitypackage
plików
Zaimportuj plik .unitypackage
, wybierając opcję menu Unity Assets > Import package > Custom Package
i importując wszystkie elementy.
Spowoduje to dodanie zawartości pakietu do projektu w katalogu Zasoby.
Importowanie pakietów UPM z plikami .tgz
(2018.4 i nowsze)
Zaimportuj pliki .tgz
do projektu, korzystając z jednej z tych metod:
manifest.json
- Utwórz nowy folder obok folderu
Packages
projektu i nadaj mu nazwęGooglePackages
. - Umieść w nim pliki
.tgz
. - Użyj edytora tekstu, aby otworzyć plik
Packages/manifest.json
w folderze projektu Unity. Dodaj wpis dla każdego pakietu, który chcesz zainstalować, mapując nazwę pakietu na lokalizację na dysku względem pliku
Packages/manifest.json
. Pamiętaj, aby do ścieżki pliku.tgz
dołączyć atrybutfile:
. Jeśli na przykład instalujesz plikcom.google.firebase.storage
i jego zależności, plik 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 odzyska aktywność, załaduje ponownie plik manifest.json i zaimportuje nowo dodane pakiety.
Niektóre starsze wersje Unity nie obsługują plików .tgz
w pliku manifest.json.
W takim przypadku:
- Rozpakuj pliki
.tgz
. - Umieść wyodrębniony folder w folderze
GooglePackages
. Zmodyfikuj plik manifest.json, aby użyć ścieżki do wyodrębnionego folderu zamiast pliku
.tgz
w ten 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... } }
Interfejs Menedżera pakietów
- Otwórz okno menedżera pakietów na 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 tar w przeglądarce plików.
Niektóre starsze wersje Unity nie obsługują bezpośredniego dodawania plików tar. W takim przypadku:
- 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.
Pamiętaj też, by zaimportować pliki .tgz
dotyczące zależności pakietu. Znajdziesz je na stronie archiwum w sekcji wybranego pakietu.
Na przykład, jeśli instalujesz com.google.firebase.storage
, pliki .tgz
musisz umieścić w tej kolejności:
- Zewnętrzny menedżer zależności (
com.google.external-dependency-manager
) - Core Firebase (
com.google.firebase.app
) - Uwierzytelnianie Firebase (
com.google.firebase.auth
) - Pamięć Firebase (
com.google.firebase.storage
)
Jeśli chcesz dodać wszystkie pliki .tgz
jednocześnie, bez obaw o kolejność, możesz wykonać instrukcje na karcie manifest.json.
Version control
Jeśli używasz oprogramowania do kontroli wersji do zarządzania plikami projektu, zalecamy dodanie do kontroli wersji odpowiednich plików .tgz
. Możesz ręcznie edytować plik manifest.json
projektu (zobacz instrukcje powyżej) i odwoływać się do lokalnych plików .tgz
za pomocą ścieżek względnych.
Jeśli korzystasz z git, zalecamy korzystanie z Git Large File Storage (LFS) do zarządzania dużymi plikami .tgz
.
Migracja z pakietów UPM do pakietów zasobów
W niektórych przypadkach możesz chcieć przejść z Menedżera pakietów Unity do zarządzania pakietami Google, na instalowanie pakietów z folderu Assets.
Upewnij się, że wszystkie pakiety Google zostały usunięte z Menedżera pakietów Unity, korzystając z jednej z tych metod:
Interfejs Menedżera pakietów
- Otwórz okno menedżera pakietów na Unity.
Z menu w lewym górnym rogu wybierz
In Project
.Na pasku wyszukiwania wpisz
com.google
, aby przefiltrować pakiety Google.Kliknij kolejno nazwy pakietów i
Remove
.
manifest.json
- Użyj edytora tekstu, aby otworzyć plik
Packages/manifest.json
w folderze projektu Unity. - W sekcji „zależności” sprawdź, czy w sekcji „zależności” znajdują się jakieś pakiety od Google. Nazwa pakietu powinna zaczynać się od „com.google”, np. „com.google.firebase.app”.
- Usuń te wiersze i zapisz plik json.
- Gdy Unity odzyska aktywność, załaduje ponownie plik
manifest.json
i usunie usunięte pakiety.
Po odinstalowaniu tych pakietów z Menedżera pakietów Unity możesz pobrać zastępcze pliki .unitypackage
ze strony archiwum i zaimportować je.
Migracja z pakietów zasobów do pakietów UPM
W niektórych przypadkach możesz chcieć przejść z instalowania produktów w drzewie zasobów na instalowanie i śledzenie produktów za pomocą Menedżera pakietów Unity.
Jeśli nie wiesz, której metody instalacji używasz, sprawdź w interfejsie Unity, czy odpowiednie pakiety Google są widoczne na karcie Projekt, w sekcji Zasoby.
Aby przeprowadzić migrację do pakietów UPM:
Upewnij się, że z folderu Zasoby zostały usunięte wszystkie pakiety Google.
- Aby odinstalować pakiety Firebase, wykonaj te czynności.
- Aby odinstalować wtyczki Play Plugins do Unity, usuń folder
GooglePlayPlugins
w sekcjiAssets
.
Zainstaluj pakiety za pomocą Menedżera pakietów Unity w sposób opisany powyżej.
Instrukcje migracji w poszczególnych usługach
Instrukcje dotyczące Firebase znajdziesz tutaj.