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.

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

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.

Aby zaimportować po pobraniu:

  1. W otwartym projekcie Unity przejdź do Assets (Zasoby) > Importuj pakiet > 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ługi Firebase obsługujące przepływ pakietów zasobów i menedżera pakietów Unity przepływu danych.

  • Zależności dotyczące każdego pliku .tgz produktu są połączone w siebie .tgz. Musisz pobrać i zaimportować plik .tgz z produktami oraz .tgz, 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 .tgz pliki do swojego projektu za pomocą jednego z następujące metody:

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 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. 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 zaimportować, wraz z mapowaniem jego nazwy do lokalizacji na dysku. Pamiętaj, aby do ścieżki pliku .tgz dołączyć file:. Dla: np. jeśli importujesz plik com.google.firebase.storage i jego zależności, 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 manifest.json. W takim przypadku wykonaj te czynności:

  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 swoim projekcie 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 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. W pakiecie Menedżera sprawdź, czy „Pakiety: w projekcie”. zaznaczono.
    2. Zwróć uwagę na wersje zaimportowanych pakietów Firebase.
    3. Kliknij każdą nazwę pakietu, a następnie 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 uaktualnić każdy pakiet do najnowszej wersji, pobierz Plik ZIP i zaimportuj pakiet SDK Firebase Unity zgodnie z opisem w sekcji Dodawanie Firebase do swój projekt 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ć przełączyć się z importowania produktów z Assets do importowania i śledzenia 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

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