Instalowanie pakietów Google dla Unity

Pakiety Google dla Unity są rozpowszechniane w 2 różnych formatach:

• Pakiety zasobów:
  • mieć rozszerzenie .unitypackage.
  • Zainstaluj w katalogu Assets projektu.
  • Można ją zaimportować w Unity 5 i nowszych wersjach.
  • Ogólnie uwzględnij pakiety zależne.
• Pakiety menedżera pakietów Unity (UPM):
  • mieć rozszerzenie .tgz.
  • Zainstaluj w katalogu Packages projektu.
  • Można ją zaimportować w Unity w wersji 2018.4 lub nowszej.
  • Wskaż pakiety zależne, które trzeba zainstalować oddzielnie.

Strona Pakiety zawiera najnowsze pliki .unitypackage wszystkie dostępne pakiety i pliki .tgz w przypadku niektórych pakietów.

Strona Archiwum zawiera pliki .unitypackage i .tgz dla wszystkich wersji pakietu.

Poniżej znajdziesz instrukcje instalowania obu typów pakietów, z instrukcjami dotyczącymi przejścia z typu na inny.

Po zapoznaniu się z tymi opcjami instalacji zapoznaj się z artykułem instrukcje dotyczące poszczególnych usług dla Firebase.

Importuję pakiety zasobów z .unitypackage plikami

Importuj plik .unitypackage, wybierając opcję menu Unity Assets > Import package > Custom Package i importuję wszystkie elementy. Spowoduje to dodanie zawartości pakietu do projektu w sekcji Zasoby katalogu.

Uwaga: jeśli masz już zainstalowany pakiet przy użyciu pakietu Unity Okno menedżera, odinstaluj starą wersję pakietu przed importowanie nowego pliku. Zobacz poniżej. znajdziesz instrukcje.

Importowanie pakietów UPM z plikami .tgz (2018.4 i nowsze)

Zaimportuj do projektu pliki .tgz, korzystając z jednej z tych metod:

manifest.json

1. Utwórz nowy folder obok folderu Packages projektu i nazwij go GooglePackages
2. Umieść w nim pliki .tgz.
3. Użyj edytora tekstu, aby otworzyć plik Packages/manifest.json w projekcie Unity folderu Dysku.

4. Dodaj wpis dla każdego pakietu, który chcesz zainstalować, wraz z mapowaniem jego nazwy do lokalizacji na dysku względem pliku Packages/manifest.json. Pamiętaj, aby do ścieżki pliku .tgz dołączyć file:. Dla: na przykład w przypadku instalowania aplikacji com.google.firebase.storage i jej 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...
     }
   }
   

5. Zapisz plik manifest.json.

6. Gdy Unity ponownie się włączy, 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 wykonaj te czynności:

1. Rozpakuj pliki .tgz.
2. Umieść wyodrębniony folder w folderze GooglePackages.

3. Edytuj plik manifest.json, aby używał ścieżki do wyodrębnionego folderu .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...
     }
   }
   

Interfejs menedżera pakietów

1. Otwórz okno menedżera pakietów Unity.

2. Kliknij ikonę + w lewym górnym rogu okna Menedżera pakietów. Wybierz Add package from tarball, aby otworzyć przeglądarkę plików.

   

3. Wybierz odpowiedni plik tarball w przeglądarce plików.

Niektóre starsze wersje Unity nie obsługują bezpośredniego dodawania plików TAR. W takim przypadku wykonaj te czynności:

1. Rozpakuj plik .tgz.

2. Kliknij ikonę + w lewym górnym rogu Menedżera pakietów. i wybierz Add package from disk, aby otworzyć przeglądarkę plików.

   

   Uwaga: Unity 2018 umieszcza ikonę + w lewym dolnym rogu listy pakietów. panelu.

3. Wybierz wyodrębniony folder w przeglądarce plików.

Pamiętaj też, aby zaimportować pliki .tgz dotyczące zależności pakietu, znajdziesz na stronie archiwum w sekcji do wybranego pakietu.

Jeśli na przykład instalujesz com.google.firebase.storage, zainstaluj te pliki (.tgz) w tej kolejności:

1. Zewnętrzny menedżer zależności (com.google.external-dependency-manager)
2. Podstawowy pakiet funkcji Firebase (com.google.firebase.app)
3. Uwierzytelnianie Firebase (com.google.firebase.auth)
4. Miejsce na dane w Firebase (com.google.firebase.storage)

Jeśli wolisz dodać wszystkie .tgz pliki naraz, bez obaw aby dowiedzieć się więcej o zamówieniu, postępuj zgodnie z instrukcjami na stronie karcie manifest.json.

Uwaga: jeśli masz już zainstalowany pakiet z atrybutem .unitypackage , pamiętaj, aby usunąć tę wersję pakietu przed dodaję nowy. Zobacz poniżej. znajdziesz instrukcje.

Version control

Jeśli do zarządzania plikami projektu używasz oprogramowania do kontroli wersji, zalecamy dodanie odpowiednich plików .tgz do kontroli wersji. Możesz ręcznie edytuj w nim manifest.json swojego projektu (zobacz powyżej instrukcji) i odwołać się do lokalnych plików .tgz za pomocą ścieżek względnych.

Jeśli korzystasz z git, zalecamy 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 przestać używać Menedżer pakietów Unity do zarządzania pakietami Google, po instalowanie pakietów z folderu Zasoby.

Upewnij się, że wszystkie pakiety Google zostały usunięte z menedżera pakietów Unity za pomocą polecenia jedną z tych metod:

Interfejs menedżera pakietów

1. Otwórz okno menedżera pakietów Unity.

2. Wybierz In Project w menu w lewym górnym rogu.

   

3. Wpisz com.google na pasku wyszukiwania, aby wyświetlić tylko pakiety Google.

   

4. Kliknij każdą nazwę pakietu, a następnie kliknij Remove.

manifest.json

1. Użyj edytora tekstu, aby otworzyć plik Packages/manifest.json w projekcie Unity folderu Dysku.
2. Sprawdź, czy w sekcji „Zależności” są jakieś pakiety od Google. Przesyłka nazwa powinna zaczynać się od „com.google”, na przykład „com.google.firebase.app”.
3. Usuń te wiersze i zapisz plik json.
4. Gdy Unity ponownie się włączy, załaduje ponownie plik manifest.json i usunie usunięte pakiety.

Po odinstalowaniu tych pakietów z Menedżera pakietów Unity możesz pobierz i zaimportuj zastępcze pliki .unitypackage z archiwum

Migracja z pakietów zasobów do pakietów UPM

W niektórych przypadkach warto zrezygnować z instalowania produktów na platformie Drzewo zasobów do instalowania i śledzenia produktów za pomocą menedżera pakietów Unity.

Jeśli nie masz pewności, której metody instalacji używasz, w interfejsie Unity Sprawdź, czy odpowiednie pakiety Google są wyświetlane na karcie Projekt w obszarze Komponenty.

Aby przeprowadzić migrację do pakietów UPM:

1. Upewnij się, że cały pakiet Google został usunięty z folderu Assets (Zasoby).

   • Aby odinstalować pakiety Firebase, postępuj zgodnie z instrukcjami tymi instrukcjami.
   • Aby odinstalować wtyczki Play dla Unity, usuń folder GooglePlayPlugins poniżej Assets.

2. Zainstaluj pakiety za pomocą menedżera pakietów Unity, zgodnie z opisem. powyżej.

Instrukcje migracji dotyczące poszczególnych usług

Instrukcje dotyczące Firebase znajdziesz tutaj.