Instalowanie pakietów Google dla Unity

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.
• 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.

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.

Uwaga: jeśli pakiet został już zainstalowany przy użyciu okna menedżera pakietów Unity, przed zaimportowaniem nowej odinstaluj starą wersję. Instrukcje znajdziesz poniżej.

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

1. Utwórz nowy folder obok folderu Packages projektu i nadaj mu nazwę GooglePackages.
2. Umieść w nim pliki .tgz.
3. Użyj edytora tekstu, aby otworzyć plik Packages/manifest.json w folderze projektu Unity.

4. 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ć atrybut file:. Jeśli na przykład instalujesz plik com.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...
     }
   }
   

5. Zapisz plik manifest.json.

6. 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:

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

3. 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

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

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

   

3. 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:

1. Rozpakuj plik .tgz.

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

   

   Uwaga: w Unity 2018 w lewym dolnym rogu panelu z listą pakietów znajduje się ikona +.

3. 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:

1. Zewnętrzny menedżer zależności (com.google.external-dependency-manager)
2. Core Firebase (com.google.firebase.app)
3. Uwierzytelnianie Firebase (com.google.firebase.auth)
4. 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.

Uwaga: jeśli masz już zainstalowany pakiet z plikiem .unitypackage, pamiętaj, by usunąć tę wersję, zanim dodasz nową. Instrukcje znajdziesz poniżej.

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

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

2. Z menu w lewym górnym rogu wybierz In Project.

   

3. Na pasku wyszukiwania wpisz com.google, aby przefiltrować pakiety Google.

   

4. Kliknij kolejno nazwy pakietów i Remove.

manifest.json

1. Użyj edytora tekstu, aby otworzyć plik Packages/manifest.json w folderze projektu Unity.
2. 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”.
3. Usuń te wiersze i zapisz plik json.
4. 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:

1. 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 sekcji Assets.

2. 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.