Opsi penginstalan tambahan untuk Unity

Daripada mendownload file .zip besar yang berisi semua file .unitypackage untuk .NET 3.X dan .NET 4.X, Anda dapat mendownload paket satu per satu dari situs Google APIs for Unity.

Situs ini menyediakan:

  • Masing-masing file .unitypackage .NET 4.X yang akan diimpor sebagai paket Aset.
  • Masing-masing arsip .tgz yang akan diimpor menggunakan Unity Package Manager.

Hal ini sangat berguna jika aplikasi Anda menggunakan satu produk Firebase, karena setiap file .unitypackage berisi semua dependensi yang diperlukan, dan file .tgz dicantumkan bersama file .tgz terkait yang diperlukan oleh file tersebut.

Halaman ini memberikan petunjuk yang melibatkan penggunaan Unity Package Manager, jadi sebaiknya pelajari juga alat ini di dokumentasi Unity.

Mengimpor paket Firebase sebagai Aset

Saat menginstal produk Firebase dari file .unitypackage yang didownload dari situs Google APIs for Unity, perhatikan hal berikut:

  • Jika menggunakan beberapa produk Firebase di project, Anda harus mendownload dan mengupgrade semua produk Firebase ke versi yang sama.

  • Jangan mencampur metode impor dalam satu project. Artinya, jangan mengimpor produk Firebase dengan alur paket Aset dan menggunakan alur Unity Package Manager.

Setelah mendownload, untuk mengimpor:

  1. Pada project Unity yang terbuka, buka Assets > Import Package > Custom Package.

  2. Di jendela Import Unity Package, klik Import.

Mengimpor paket Firebase menggunakan Unity Package Manager

Saat mengimpor produk Firebase dari file .tgz yang didownload dari arsip Google APIs for Unity, perhatikan hal berikut:

  • Metode ini hanya tersedia pada versi 2018.3+.

  • Jika menggunakan beberapa produk Firebase di project, Anda harus mendownload dan mengupgrade semua produk Firebase ke versi yang sama.

  • Jangan mencampur metode impor dalam satu project. Artinya, jangan mengimpor produk Firebase dengan alur paket Aset dan dengan alur Unity Package Manager.

  • Dependensi untuk setiap file .tgz produk ditautkan bersama dalam file .tgz-nya sendiri. Anda harus mendownload dan mengimpor file .tgz produk dan file .tgz dependensi dalam urutan yang benar:

    1. External Dependency Manager (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. Produk Firebase yang digunakan dalam project Anda. Jika Anda menggunakan Realtime Database atau Cloud Storage, impor Authentication (com.google.firebase.auth) terlebih dahulu.

Setelah mendownload, impor file .tgz ke project Anda menggunakan salah satu metode berikut:

UI Package Manager

  1. Buka jendela Unity Package Manager.
  2. Klik ikon + di pojok kiri atas jendela Package Manager dan pilih Add package from tarball untuk membuka file browser.
  3. Pilih tarball yang diinginkan di file browser.

Beberapa versi Unity 2019 yang lebih lama tidak mendukung penambahan tarball secara langsung. Dalam hal ini, Anda harus:

  1. Mengekstrak file .tgz.
  2. Mengklik ikon + di pojok kiri atas jendela Package Manager dan memilih Add package from disk untuk membuka file browser.
  3. Memilih folder yang diekstrak di file browser.

manifest.json

  1. Buat folder baru di samping folder Packages project Anda dan beri nama GooglePackages.
  2. Letakkan file .tgz ke folder tersebut.
  3. Gunakan editor teks untuk membuka Packages/manifest.json pada folder project Unity Anda.
  4. Tambahkan entri untuk setiap paket yang ingin Anda impor, dengan memetakan nama paket ke lokasi pada disk. Pastikan untuk menambahkan file: ke jalur file .tgz. Misalnya, jika Anda mengimpor com.google.firebase.storage dan dependensinya, manifest.json akan terlihat seperti ini:

    {
      "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. Simpan file manifest.json.

  6. Saat kembali fokus, Unity akan memuat ulang manifest.json dan mengimpor paket yang baru ditambahkan.

Beberapa versi lama Unity tidak mendukung file .tgz di manifest.json. Dalam hal ini, Anda harus:

  1. Mengekstrak file .tgz.
  2. Mengedit manifest.json Anda untuk menggunakan jalur ke folder yang diekstrak, bukan file .tgz, seperti:

    {
      "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...
      }
    }
    

Melakukan migrasi dari Unity Package Manager ke paket Aset

Dalam beberapa kasus, Anda dapat beralih dari menggunakan Unity Package Manager untuk melacak produk Firebase, ke mengimpor produk di folder Assets.

Jika tidak yakin metode impor mana yang Anda gunakan, buka file Packages/manifest.json di folder project Unity. Jika file berisi entri yang dimulai dengan com.google.firebase, berarti project Anda menggunakan Unity Package Manager untuk impor.

Untuk bermigrasi ke paket Aset:

  1. Perhatikan versi paket Firebase saat ini di project Anda, lalu hapus versi tersebut.

    1. Dari menu Window, pilih Package Manager. Di jendela Package Manager, pastikan "Packages: In Project" dipilih.
    2. Perhatikan versi paket Firebase yang diimpor.
    3. Klik setiap nama paket, lalu klik Remove. Pastikan untuk menghapus paket External Dependency Manager (.com.google.external-dependency-manager) serta paket Firebase.
  2. Download dan impor file .unitypackage pengganti. Anda memiliki dua opsi:

    • Jika Anda dapat mengupgrade ke versi terbaru dari setiap paket, download file zip Firebase Unity SDK dan impor seperti yang dijelaskan dalam Menambahkan Firebase ke project Unity.
    • Jika perlu mempertahankan versi .unitypackage saat ini, Anda dapat mendownload dan mengimpor setiap paket seperti yang dijelaskan di atas di halaman ini.

Melakukan migrasi dari paket Asset ke Unity Package Manager

Dalam beberapa kasus, Anda dapat beralih dari mengimpor produk di folder Assets ke mengimpor dan melacak produk dengan Unity Package Manager.

Jika tidak yakin metode impor mana yang Anda gunakan, buka file Packages/manifest.json di folder project Unity. Jika file berisi entri yang dimulai dengan com.google.firebase, berarti project Anda sudah menggunakan Unity Package Manager untuk impor.

Untuk bermigrasi ke Unity Package Manager:

  1. Pastikan semua paket Firebase dan paket External Dependency Manager dihapus dari folder Assets, menggunakan salah satu metode berikut.

    EDM4U UI

    1. Pada project Unity yang terbuka, buka Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages.
    2. Pilih semua paket Firebase dan External Dependency Manager.
    3. Klik Uninstall Selected Package.

    Penghapusan manual

    Dengan menggunakan alat sistem file, hapus folder berikut secara manual:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. Impor paket menggunakan Unity Package Manager, seperti yang dijelaskan di atas di halaman ini.