Instalowanie pakietów Google dla Unity

Pakiety Google dla Unity są dostępne w 2 formatach:

• Pakiety zasobów:
  • mieć rozszerzenie .unitypackage.
  • Zainstaluj w katalogu Assets projektu.
  • Można je importować w wersji 5 i nowszych.
  • Zazwyczaj zawierają pakiety zależne.
• Pakiet Unity Package Manager (UPM):
  • mieć rozszerzenie .tgz.
  • Zainstaluj w katalogu Packages projektu.
  • Można je importować w Unity w wersji 2018.4 lub nowszej.
  • Odwołuje się do pakietów zależnych, które trzeba zainstalować osobno.

Na stronie Pakiety znajdują się najnowsze pliki .unitypackage ze wszystkimi dostępnymi pakietami oraz pliki .tgz z niektórymi pakietami.

Na stronie Archiwum znajdują się pliki .unitypackage i .tgz dla wszystkich wersji pakietu.

Poniżej znajdziesz instrukcje instalacji obu typów pakietów oraz instrukcje migracji z jednego typu na drugi.

Po zapoznaniu się z tymi opcjami instalacji zapoznaj się z dodatkowymi instrukcjami dotyczącymi poszczególnych usług Firebase.

Importowanie pakietów za pomocą OpenUPM

Pakiety zewnętrzne możesz dodawać do projektu Unity za pomocą rejestru OpenUPM. OpenUPM zawiera wiele przydatnych wtyczek i pakietów SDK, np. wtyczkę Google Play Integrity, która pomaga chronić aplikację przed oszustwem i nadużyciami.

Oto jak dodać na przykład wtyczkę Google Play Integrity za pomocą OpenUPM.

OpenUPM-CLI

Jeśli masz zainstalowany interfejs wiersza poleceń OpenUPM, możesz zainstalować rejestr OpenUPM za pomocą tego polecenia:

openupm add com.google.play.integrity

OpenUPM

1. Otwórz ustawienia menedżera pakietów, klikając opcję menu Unity Edytuj > Ustawienia projektu > Menedżer pakietów.

2. Dodaj OpenUPM jako ograniczony rejestr do okna Menedżera pakietów:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Otwórz menu menedżera pakietów, wybierając w menu Unity opcję Okno > Menedżer pakietów.

4. W menu zakresu menedżera wybierz Moje rejestry.

   

5. Na liście pakietów wybierz pakiet Google Play Integrity plugin for Unity i kliknij Zainstaluj.

Importowanie pakietów komponentów za pomocą plików .unitypackage

Zaimportuj plik .unitypackage, wybierając opcję menu UnityAssets > 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 za pomocą okna Menedżera pakietów w Unity, przed zaimportowaniem nowej wersji usuń starą wersję pakietu. Instrukcje znajdziesz poniżej.

Importowanie pakietów UPM za pomocą plików .tgz (wersja 2018.4 lub nowsza)

Zaimportuj pliki .tgz do projektu, 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. W edytorze tekstu otwórz 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 dodać file: do ścieżki pliku .tgz. Jeśli na przykład instalujesz pakiet 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 ponownie stanie się aktywne, ponownie załaduje 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. Zmień plik 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...
     }
   }
   

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 i wybierz Add package from tarball, aby otworzyć przeglądarkę plików.

   

3. W przeglądarce plików wybierz odpowiedni plik tarball.

Niektóre starsze wersje Unity nie obsługują bezpośredniego dodawania plików tarballs. W takim przypadku:

1. Zdekompresuj plik .tgz.

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

   

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

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

Pamiętaj, aby zaimportować też pliki .tgz, które są wymagane przez zależności pakietu. Znajdziesz je na stronie archiwum w sekcji odpowiedniego pakietu.

Jeśli na przykład instalujesz com.google.firebase.storage, musisz zainstalować te pliki .tgz w takiej kolejności:

1. Menedżer zależności zewnętrznych (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Uwierzytelnianie Firebase (com.google.firebase.auth)
4. Pamięć Firebase (com.google.firebase.storage)

Jeśli wolisz dodać wszystkie pliki .tgz naraz, bez martwienia się o kolejność, możesz postępować zgodnie z instrukcjami na karcie manifest.json.

Uwaga: jeśli pakiet został już zainstalowany za pomocą pliku .unitypackage, przed dodaniem nowego pakietu usuń tę wersję pakietu. Instrukcje znajdziesz poniżej.

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 edytować plik manifest.json projektu (patrz instrukcje powyżej) i odwoływać się do lokalnych plików .tgz za pomocą ścieżek względnych.

Jeśli używasz git, zalecamy użycie Git Large File Storage (LFS) do zarządzania dużymi plikami .tgz.

Migracja z pakietów UPM do pakietów komponentów

W niektórych przypadkach możesz chcieć zmienić sposób zarządzania pakietami Google z menedżera pakietów Unity na instalowanie pakietów w folderze Zasoby.

Upewnij się, że wszystkie pakiety Google zostały usunięte z Unity Package Managera za pomocą jednej z tych metod:

Interfejs menedżera pakietów

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

2. W menu w lewym górnym rogu kliknij In Project.

   

3. Aby filtrować według pakietów Google, wpisz com.google na pasku wyszukiwania.

   

4. Kliknij nazwę każdego pakietu, a potem kliknij Remove.

manifest.json

1. W edytorze tekstu otwórz plik Packages/manifest.json w folderze projektu Unity.
2. Sprawdź, czy w sekcji „dependencies” (zależność) są 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 fokus, ponownie załaduje plik manifest.json i usuwa usunięte pakiety.

Po odinstalowaniu tych pakietów z Unity Package Managera możesz pobrać i zaimportować pliki .unitypackage z strony z archiwami.

Migracja z pakietów komponentów do pakietów UPM

W niektórych przypadkach warto zmienić sposób instalowania produktów w drzewie Zasoby na instalowanie i śledzenie produktów za pomocą menedżera pakietów Unity.

Jeśli nie masz pewności, z której metody instalacji korzystasz, w interfejsie Unity sprawdź, czy odpowiednie pakiety Google są widoczne na karcie Projekt w sekcji Zasoby.

Aby przejść na pakiety UPM:

1. Upewnij się, że wszystkie pakiety Google zostały usunięte z folderu Zasoby.

   • Aby odinstalować pakiety Firebase, wykonaj te instrukcje.
   • Aby odinstalować wtyczki Google Play do Unity, usuń folder GooglePlayPlugins w folderze Assets.

2. Zainstaluj pakiety za pomocą menedżera pakietów Unity, jak opisano wyżej.

Instrukcje dotyczące migracji dotyczące poszczególnych usług

Instrukcje dotyczące Firebase znajdziesz tutaj.