Dodatkowe opcje instalacji środowiska Unity

Zamiast pobierać duży plik .zip zawierający wszystkie elementy typu .unitypackage .NET 3.X i .NET 4.X możesz pobrać z znajdziesz na stronie interfejsów API Google dla Unity.

Na stronie znajdziesz:

• Pojedyncze pliki .NET 4.X .unitypackage do zaimportowania jako pakiety komponentów.
• pojedyncze archiwa .tgz, które można zaimportować za pomocą menedżera pakietów Unity;

Jest to szczególnie przydatne, gdy Twoja aplikacja korzysta z pojedynczej usługi Firebase, ponieważ poszczególne pliki .unitypackage zawierają wszystkie potrzebne zależności, Pliki (.tgz) są wyświetlane obok powiązanych plików (.tgz), od których są zależne.

Ta strona zawiera instrukcje dotyczące Menedżera pakietów Unity, więc warto znajdziesz więcej informacji o tym narzędziu z dokumentacji Unity.

Uwaga: jeśli nadal musisz używać .NET 3.x, pobierz cały pakiet SDK Firebase zgodnie z opisem w artykule Dodawanie Firebase do projektu Unity.

Importuj pakiety Firebase jako zasoby

Podczas importowania produktów Firebase z .unitypackage plików pobranych z Witryna interfejsów API Google dla Unity, pamiętaj o tych 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ługi Firebase korzystające z procesu obsługi pakietów zasobów i pakietu Unity Proces menedżera.

Po pobraniu pliku zaimportuj go:

1. W otwartym projekcie Unity kliknij Zasoby > Importuj pakiet > Własny pakiet.

2. 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 projekcie używasz kilku 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 należy importować produktów Firebase za pomocą procesu importowania pakietu zasobów ani menedżera pakietów Unity.

• Zależności dotyczące każdego pliku .tgz produktu są połączone w siebie .tgz. Musisz pobrać i zaimportować plik .tgz produktu oraz pliki .tgz zależności w odpowiedniej kolejności:

  1. Zewnętrzny menedżer zależności (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Usługi Firebase używane w Twoim projekcie. Jeśli używasz wersji Realtime Database lub Cloud Storage, najpierw zaimportuj wersję Authentication (com.google.firebase.auth).

Po pobraniu zaimportuj pliki .tgz do projektu, korzystając z jednej z tych metod:

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. Wybierz odpowiedni plik tar 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:

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.
3. Wybierz wyodrębniony folder w przeglądarce plików.

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 zaimportować, wraz z mapowaniem jego nazwy do lokalizacji na dysku. Dodaj file: do ścieżki pliku .tgz. Jeśli na przykład importujesz pakiet com.google.firebase.storage i jego zależności, pakiet 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 fokus, ponownie załaduje manifest.json i importuje nowo dodane pakiety.

Niektóre starsze wersje Unity nie obsługują plików .tgz w manifest.json. W takim przypadku:

1. Rozpakuj plik .tgz.

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

Migracja z menedżera pakietów Unity do pakietów zasobów

W niektórych przypadkach możesz przejść z Menedżera pakietów Unity na śledzić usługi Firebase, a także importować produkty w folderze Assets.

Jeśli nie masz pewności, której metody importowania używasz, w folderze projektu Unity otwórz plik Packages/manifest.json. Jeśli plik zawiera wpisy od com.google.firebase Twój projekt używał menedżera pakietów Unity przez importowanie.

Aby przejść na pakiety komponentów:

1. Zapisz obecne wersje pakietów Firebase w projekcie i usuń je.

   1. W menu Okno wybierz Menedżer pakietów. W oknie Menedżer pakietów sprawdź, czy wybrana jest opcja „Pakiety: w projekcie”.
   2. Zanotuj wersje zaimportowanych pakietów Firebase.
   3. Kliknij nazwę każdego pakietu, a potem kliknij Usuń. Pamiętaj, aby usunąć Pakiet zewnętrznego menedżera zależności (.com.google.external-dependency-manager) jak i pakiety Firebase.

2. Pobierz i zaimportuj zastępcze pliki .unitypackage. Dostępne są dwie opcje:

   • Jeśli możesz przejść na najnowszą wersję każdego pakietu, pobierz plik zip pakietu Firebase Unity SDK i zaimportuj go zgodnie z instrukcjami w artykule Dodawanie Firebase do projektu Unity.
   • Jeśli chcesz zachować bieżące wersje .unitypackage, możesz pobrać i importuj 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ć zmienić importowanie produktów w folderze Assets na importowanie i śledzenie produktów za pomocą menedżera pakietów Unity.

Jeśli nie masz pewności, której metody importowania używasz, w swoim projekcie Unity otwórz plik Packages/manifest.json. Jeśli plik zawiera wpisy od com.google.firebase Twój projekt korzysta już z pakietu Unity Menedżer do importowania.

Aby przeprowadzić migrację do menedżera pakietów Unity:

1. Sprawdź, czy wszystkie pakiety Firebase i pakiet zewnętrznego menedżera zależności zostaną usunięte z folderu Assets przy użyciu jednej z tych metod.

   Interfejs EDM4U

   1. W otwartym projekcie Unity przejdź do Assets (Zasoby) > Zewnętrzni Menedżer zależności > Moduł obsługi wersji > Odinstalowywanie zarządzane Przesyłki.
   2. Wybierz wszystkie pakiety Firebase i zewnętrzny menedżer zależności.
   3. Kliknij Odinstaluj wybrany pakiet.

   Usunięcie ręczne

   Za pomocą 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

2. Zaimportuj pakiety przy użyciu menedżera pakietów Unity w sposób opisany powyżej. na tej stronie.