Dodatkowe opcje instalacji Unity

Zamiast pobierać duży plik .zip zawierający wszystkie pliki .unitypackage dla platformy .NET 3.X i .NET 4.X, możesz pobrać pojedyncze pakiety z witryny Google APIs for Unity .

Witryna zapewnia:

  • Poszczególne pliki pakietu .NET 4.X .unitypackage do importowania jako pakiety zasobów.
  • Indywidualne archiwa .tgz do importowania za pomocą Menedżera pakietów Unity.

Jest to szczególnie przydatne, gdy Twoja aplikacja korzysta z pojedynczego 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 zależą.

Ta strona zawiera instrukcje dotyczące Menedżera pakietów Unity, dlatego dobrym pomysłem jest zapoznanie się z narzędziem z dokumentacji Unity .

Zaimportuj pakiety Firebase jako zasoby

Importując produkty Firebase 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 importuj produktów Firebase za pomocą przepływu pakietu Asset i przepływu Menedżera pakietów Unity.

Po pobraniu, aby zaimportować:

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

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

Importuj pakiety Firebase za pomocą Menedżera pakietów Unity

Importując produkty 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 wersji 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 importuj produktów Firebase za pomocą przepływu pakietu Asset i przepływu Menedżera pakietów Unity.

  • Zależności dla każdego pliku .tgz produktu są połączone w osobnych plikach .tgz . Należy pobrać i zaimportować plik .tgz produktu oraz pliki .tgz zależności w odpowiedniej kolejności:

    1. Menedżer zależności zewnętrznych ( com.google.external-dependency-manager )
    2. Rdzeń Firebase ( com.google.firebase.app )
    3. Produkty Firebase użyte w Twoim projekcie. Jeśli korzystasz z bazy danych czasu rzeczywistego lub magazynu w chmurze, 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 opcję Add package from tarball , aby otworzyć przeglądarkę plików.
  3. Wybierz żądany plik tar w przeglądarce plików.

Niektóre starsze wersje Unity 2019 nie obsługują bezpośredniego dodawania paczek tar. 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 opcję 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 swojego projektu i nadaj mu nazwę 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 o dołączeniu file: do ścieżki pliku .tgz . Na przykład, jeśli importujesz com.google.firebase.storage i jego zależności, plik manifest.json będzie wyglądał następująco:

    {
      "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 ostrość, ponownie załaduje manifest.json i zaimportuje nowo dodane pakiety.

Niektóre starsze wersje aparatu Unity nie obsługują plików .tgz w pliku 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 , 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...
      }
    }
    

Przeprowadź migrację z Menedżera pakietów Unity do pakietów zasobów

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

Jeśli nie masz pewności, jakiej 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 , w Twoim projekcie do importu użyto 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żer pakietów . Upewnij się, że w oknie Menedżera pakietów wybrano opcję „Pakiety: W projekcie”.
    2. Zanotuj wersje zaimportowanych pakietów Firebase.
    3. Kliknij nazwę każdego pakietu, a następnie kliknij Usuń . Pamiętaj, aby usunąć pakiet Menedżera zależności zewnętrznych ( .com.google.external-dependency-manager ), a także 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 zaimportuj go zgodnie z opisem w artykule Dodawanie Firebase do projektu Unity .
    • Jeśli chcesz zachować aktualne wersje .unitypackage , możesz pobrać i zaimportować poszczególne pakiety w sposób opisany powyżej na tej stronie.

Przeprowadź migrację 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 w folderze 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, 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 korzysta już z Menedżera pakietów Unity do importu.

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

  1. Upewnij się, że wszystkie pakiety Firebase i pakiet Menedżera zależności zewnętrznych zostały usunięte z folderu Assets , korzystając z jednej z następujących metod.

    Interfejs EDM4U

    1. W otwartym projekcie Unity przejdź do opcji Zasoby > Menedżer zależności zewnętrznych > Procedura 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 .

    Ręczne usuwanie

    Za pomocą narzędzi systemu plików usuń ręcznie następujące 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, jak opisano powyżej na tej stronie.