Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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 zainstalowania jako pakiety zasobów.
  • Pojedyncze archiwa .tgz do zainstalowania za pomocą Unity Package Manager.

Jest to szczególnie przydatne, gdy aplikacja korzysta z jednego produktu .unitypackage , 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 .

Zainstaluj pakiety Firebase jako zasoby

Instalując produkty .unitypackage z plików .unitypackage pobranych z witryny Google APIs for Unity , pamiętaj o następujących kwestiach:

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

  • Nie mieszaj metod instalacji w jednym projekcie. Oznacza to, że nie instaluj produktów Firebase z przepływem pakietów zasobów i przepływem Unity Package Manager.

Po pobraniu, aby zainstalować:

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

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

Zainstaluj pakiety Firebase za pomocą Unity Package Manager

Podczas instalowania 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 projekcie używasz wielu produktów Firebase, musisz pobrać i uaktualnić wszystkie produkty Firebase do tej samej wersji.

  • Nie mieszaj metod instalacji w jednym projekcie. Oznacza to, że nie instaluj 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 w ich własnych plikach .tgz . Musisz pobrać i zainstalować 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 korzystasz z Bazy danych czasu rzeczywistego lub Cloud Storage, najpierw zainstaluj 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 zainstalować, mapując nazwę pakietu na lokalizację na dysku. Pamiętaj, aby dołączyć file: do ścieżki pliku .tgz . Na przykład, jeśli instalujesz 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 plik 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 instalowanie produktów w folderze Assets .

Jeśli nie masz pewności, której metody instalacji 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 instalacji Unity Package Manager.

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 zainstalowanych 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ć każdy pakiet do najnowszej wersji, pobierz plik ZIP pakietu Firebase Unity SDK i zainstaluj go zgodnie z opisem w sekcji Dodawanie Firebase do projektu Unity .
    • Jeśli chcesz zachować aktualne wersje .unitypackage , możesz pobrać i zainstalować 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 instalowania produktów w folderze Assets na instalowanie i śledzenie produktów za pomocą Unity Package Manager.

Jeśli nie masz pewności, której metody instalacji 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ż Unity Package Manager do instalacji.

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 Zewnętrzny menedżer zależności.
    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. Zainstaluj pakiety za pomocą Unity Package Manager, jak opisano powyżej na tej stronie.