Dodatkowe opcje instalacji Unity

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

Witryna zapewnia:

  • Pojedyncze pliki .NET 4.X .unitypackage do zaimportowania jako pakiety zasobów.
  • Pojedyncze archiwa .tgz do zaimportowania za pomocą Unity Package Manager.

Jest to szczególnie przydatne, gdy aplikacja korzysta z jednego produktu Firebase, ponieważ poszczególne pliki .unitypackage zawierają wszystkie potrzebne zależności, a pliki .tgz są wymienione obok powiązanych plików .tgz , od których są zależne.

Ta strona zawiera instrukcje dotyczące Unity Package Manager, więc dobrze jest zapoznać się z narzędziem z dokumentacji Unity .

Importuj pakiety Firebase jako zasoby

Podczas importowania produktów .unitypackage z plików .unitypackage pobranych z witryny Google APIs for Unity pamiętaj o następujących kwestiach:

  • Jeśli w swoim projekcie używasz wielu produktów Firebase, musisz pobrać i uaktualnić wszystkie produkty Firebase do tej samej wersji.

  • Nie mieszaj metod importu w jednym projekcie. Oznacza to, że nie należy importować produktów Firebase z przepływem pakietów zasobów i przepływem Unity Package Manager.

Po pobraniu, aby zaimportować:

  1. W otwartym projekcie Unity przejdź do Zasoby > Importuj pakiet > Pakiet niestandardowy .

  2. W oknie Importuj pakiet Unity kliknij opcję Importuj .

Importuj pakiety Firebase za pomocą Unity Package Manager

Podczas importowania produktów Firebase z plików .tgz pobranych z archiwum Google APIs for Unity pamiętaj o następujących kwestiach:

  • Ta metoda jest dostępna tylko w 2018.3+.

  • Jeśli w swoim projekcie używasz wielu produktów Firebase, musisz pobrać i uaktualnić wszystkie produkty Firebase do tej samej wersji.

  • Nie mieszaj metod importu w jednym projekcie. Oznacza to, że nie należy importować produktów Firebase z przepływem pakietów zasobów i przepływem Unity Package Manager.

  • Zależności dla każdego pliku .tgz produktu są połączone obok we własnych plikach .tgz . Musisz pobrać i zaimportować plik .tgz produktu oraz pliki zależności .tgz 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. Produkty 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 pliki .tgz do swojego projektu, korzystając z jednej z następujących 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 żądaną paczkę w przeglądarce plików.

Niektóre starsze wersje Unity 2019 nie obsługują bezpośredniego dodawania tarballi. W takim przypadku będziesz musiał:

  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ść pliki .tgz w tym folderze.
  3. Użyj edytora tekstu, aby otworzyć Packages/manifest.json w folderze projektu Unity.

  4. Dodaj wpis dla każdego pakietu, który chcesz zaimportować, mapując nazwę pakietu na lokalizację na dysku. Pamiętaj, aby dołączyć file: do ścieżki pliku .tgz . Na przykład, jeśli importujesz com.google.firebase.storage i jego zależności, Twój 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 koncentrację, przeładuje 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 powinieneś:

  1. Rozpakuj plik .tgz .

  2. Edytuj swój manifest.json , aby użyć ścieżki do wyodrębnionego folderu zamiast 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 Unity Package Manager do Asset Packages

W niektórych przypadkach możesz chcieć przełączyć się z używania Unity Package Manager do śledzenia produktów Firebase na importowanie produktów 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 zaczynające się od com.google.firebase , Twój projekt używał do importu Menedżera pakietów Unity.

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

  1. Zanotuj aktualne wersje pakietów Firebase w swoim projekcie i usuń je.

    1. Z menu Okno wybierz Menedżera pakietów . W oknie Menedżera pakietów upewnij się, że wybrana jest opcja „Pakiety: w projekcie”.
    2. Zwróć uwagę na wersje zaimportowanych pakietów Firebase.
    3. Kliknij nazwę każdego pakietu, a następnie kliknij Usuń . Pamiętaj, aby usunąć pakiet External Dependency Manager ( .com.google.external-dependency-manager ) oraz pakiety Firebase.

  2. Pobierz i zaimportuj zastępcze pliki .unitypackage . Masz dwie opcje:

    • Jeśli możesz uaktualnić do najnowszej wersji każdego pakietu, pobierz plik ZIP pakietu Firebase Unity SDK i zaimportuj go zgodnie z opisem w sekcji Dodawanie Firebase do projektu Unity .
    • Jeśli chcesz zachować bieżące wersje .unitypackage , możesz pobrać i zaimportować poszczególne pakiety, jak opisano powyżej na tej stronie.

Migracja z pakietów zasobów do Unity Package Manager

W niektórych przypadkach możesz chcieć przełączyć się z importowania produktów w folderze Assets na importowanie i śledzenie produktów za pomocą Unity Package Manager.

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 zaczynające się od com.google.firebase , Twój projekt używa już do importu Unity Package Manager.

Aby przeprowadzić migrację do Unity Package Manager:

  1. Upewnij się, że wszystkie pakiety Firebase i pakiet External Dependency Manager zostały usunięte z folderu Assets , korzystając z jednej z poniższych metod.

    Interfejs Menedżera Pakietów

    1. W otwartym projekcie Unity przejdź do pozycji Assets > External Dependency Manager > Program obsługi wersji > Odinstaluj pakiety zarządzane .
    2. Wybierz wszystkie pakiety Firebase i External Dependency Manager.
    3. Kliknij Odinstaluj wybrany pakiet .

    Usuwanie ręczne

    Korzystając z narzędzi systemu plików, ręcznie usuń następujące foldery:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Importuj pakiety za pomocą Unity Package Manager, jak opisano powyżej na tej stronie.