Dodatkowe opcje instalacji środowiska Unity

Zamiast pobierać duży plik .zip zawierający wszystkie pliki .unitypackage zarówno dla .NET 3.X, jak i .NET 4.X, możesz pobrać poszczególne pakiety ze strony interfejsów API Google dla Unity.

Witryna zawiera:

  • Pojedyncze pliki .NET 4.X .unitypackage do zaimportowania jako pakiety zasobów.
  • Pojedyncze archiwa .tgz do zaimportowania za pomocą menedżera pakietów Unity.

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

Ta strona zawiera instrukcje dotyczące menedżera pakietów Unity, warto więc dowiedzieć się więcej o tym narzędziu z dokumentacji Unity.

Importuj pakiety Firebase jako zasoby

Podczas importowania produktów Firebase z plików .unitypackage pobranych z witryny interfejsów API Google dla Unity pamiętaj o następujących 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ług Firebase z użyciem przepływu pakietów zasobów ani procesu w Menedżerze pakietów Unity.

Aby zaimportować po pobraniu:

  1. W otwartym projekcie Unity przejdź do Assets (Zasoby) i wybierz Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy).

  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 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ług Firebase za pomocą przepływu pakietów zasobów ani procesu w Menedżerze pakietów Unity.

  • Zależności dotyczące każdego pliku .tgz produktu są umieszczone w osobnych plikach .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. Podstawowy pakiet funkcji Firebase (com.google.firebase.app)
    3. Usługi Firebase używane w Twoim projekcie. Jeśli używasz Bazy danych czasu rzeczywistego lub Cloud Storage, najpierw zaimportuj Uwierzytelnianie (com.google.firebase.auth).

Po pobraniu zaimportuj do projektu pliki .tgz, 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 tarball 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 okna 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. Za pomocą edytora tekstu otwórz Packages/manifest.json w folderze projektu Unity.

  4. Dodaj wpis dotyczący każdego pakietu, który chcesz zaimportować, mapując jego nazwę na lokalizację na dysku. Pamiętaj, aby do ścieżki pliku .tgz dołączyć file:. Jeśli na przykład importujesz atrybut com.google.firebase.storage i jego zależność, 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 manifest.json i zaimportuje nowo dodane pakiety.

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

  1. Rozpakuj plik .tgz.

  2. Zmień plik manifest.json, aby użyć ścieżki do wyodrębnionego folderu zamiast pliku .tgz w następujący 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...
  }
}

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

W niektórych przypadkach możesz chcieć przejść z Menedżera pakietów Unity do śledzenia usług Firebase na importowanie produktów w folderze Assets.

Jeśli nie masz pewności, jakiej metody importowania używasz, otwórz plik Packages/manifest.json w folderze projektu Unity. Jeśli plik zawiera wpisy rozpoczynające się od com.google.firebase, Twój projekt do importowania używał Menedżera pakietów Unity.

Aby przeprowadzić migrację do pakietów zasobów:

  1. Zanotuj bieżące wersje pakietów Firebase w projekcie i je usuń.

    1. W menu Okno wybierz Menedżer pakietów. Sprawdź, czy w oknie Menedżer pakietów zaznaczona jest opcja „Pakiety: w projekcie”.
    2. Zwróć uwagę na wersje zaimportowanych pakietów Firebase.
    3. Kliknij każdą nazwę pakietu, a następnie kliknij Usuń. Pamiętaj, by usunąć pakiet zewnętrznego menedżera zależności (.com.google.external-dependency-manager) oraz pakiety Firebase.

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

    • Jeśli możesz uaktualnić każdy pakiet do najnowszej wersji, pobierz plik ZIP pakietu SDK Firebase Unity i zaimportuj go zgodnie z opisem w sekcji Dodawanie Firebase do projektu Unity.
    • Jeśli chcesz zachować bieżące wersje .unitypackage, możesz pobierać i importować 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ć przełączyć się z importowania produktów z folderu Assets na importowanie i śledzenie produktów za pomocą menedżera pakietów Unity.

Jeśli nie masz pewności, jakiej metody importowania używasz, otwórz plik Packages/manifest.json w folderze projektu Unity. Jeśli plik zawiera wpisy rozpoczynające się od com.google.firebase, Twój projekt używa już do importowania menedżera pakietów Unity.

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

  1. Usuń wszystkie pakiety Firebase i pakiet zewnętrznego menedżera zależności z folderu Assets, używając jednej z poniższych metod.

    Interfejs EDM4U

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

    Usunięcie ręczne

    Przy użyciu 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 za pomocą menedżera pakietów Unity w sposób opisany powyżej na tej stronie.