Bergabunglah dengan kami secara langsung dan online di Firebase Summit pada 18 Oktober 2022. Pelajari cara Firebase dapat membantu Anda mempercepat pengembangan aplikasi, merilis aplikasi dengan percaya diri, dan meningkatkan skala dengan mudah. Daftar sekarang

Opsi instalasi Unity tambahan

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Daripada mengunduh file .zip besar yang berisi semua file .unitypackage untuk .NET 3.X dan .NET 4.X, Anda dapat mengunduh paket individual dari situs Google API untuk Unity .

Situs ini menyediakan:

  • File .NET 4.X .unitypackage individual untuk diimpor sebagai paket Aset.
  • Arsip .tgz individual untuk diimpor menggunakan Unity Package Manager.

Ini sangat berguna saat aplikasi Anda menggunakan satu produk Firebase, karena file .unitypackage individual berisi semua dependensi yang diperlukan, dan file .tgz dicantumkan di samping file .tgz terkait yang menjadi sandarannya.

Halaman ini memberikan instruksi yang melibatkan Unity Package Manager, jadi ada baiknya untuk mempelajari alat ini dari dokumentasi Unity .

Impor paket Firebase sebagai Aset

Saat mengimpor produk Firebase dari file .unitypackage yang diunduh dari Google API untuk situs Unity , perhatikan hal berikut:

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

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

Setelah mengunduh, untuk mengimpor:

  1. Di proyek Unity terbuka Anda, navigasikan ke Assets > Import Package > Custom Package .

  2. Di jendela Impor Paket Persatuan , klik Impor .

Impor paket Firebase menggunakan Unity Package Manager

Saat mengimpor produk Firebase dari file .tgz yang diunduh dari arsip Google API untuk Unity , perhatikan hal berikut:

  • Metode ini hanya tersedia di 2018.3+.

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

  • Jangan mencampur metode impor dalam satu proyek. 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 mereka sendiri. Anda harus mengunduh dan mengimpor file .tgz produk dan file .tgz ketergantungan, dalam urutan yang benar:

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

Setelah mengunduh, impor file .tgz ke proyek Anda menggunakan salah satu metode berikut:

Antarmuka Manajer Paket

  1. Buka jendela Manajer Paket Unity.
  2. Klik ikon + di sudut 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 perlu:

  1. Buka zip file .tgz .
  2. Klik ikon + di sudut kiri atas jendela Package Manager dan pilih Add package from disk untuk membuka file browser.
  3. Pilih folder yang diekstrak di browser file.

manifest.json

  1. Buat folder baru di sebelah folder Packages proyek Anda dan beri nama GooglePackages .
  2. Tempatkan file .tgz ke dalam folder itu.
  3. Gunakan editor teks untuk membuka Packages/manifest.json di bawah folder proyek Unity Anda.
  4. Tambahkan entri untuk setiap paket yang ingin Anda impor, memetakan nama paket ke lokasi di disk. Pastikan untuk menambahkan file: ke jalur file .tgz . Misalnya, jika Anda mengimpor com.google.firebase.storage dan ketergantungannya, manifest.json Anda 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 Unity mendapatkan kembali fokusnya, Unity akan memuat ulang manifest.json dan mengimpor paket yang baru ditambahkan.

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

  1. Buka zip file .tgz .
  2. Edit manifest.json Anda untuk menggunakan jalur ke folder yang diekstrak, alih-alih 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...
      }
    }
    

Bermigrasi dari Unity Package Manager ke paket Aset

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

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

Untuk bermigrasi ke paket Aset:

  1. Catat versi paket Firebase saat ini di proyek Anda dan hapus.

    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 Hapus . Pastikan untuk menghapus paket External Dependency Manager ( .com.google.external-dependency-manager ) serta paket Firebase.
  2. Unduh dan impor file .unitypackage pengganti. Anda memiliki dua opsi:

    • Jika Anda dapat meningkatkan ke versi terbaru dari setiap paket, unduh file zip Firebase Unity SDK dan impor seperti yang dijelaskan dalam Menambahkan Firebase ke proyek Unity Anda .
    • Jika Anda perlu mempertahankan versi .unitypackage saat ini, Anda dapat mengunduh dan mengimpor paket individual seperti yang dijelaskan di atas pada halaman ini.

Bermigrasi dari paket Aset ke Unity Package Manager

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

Jika Anda tidak yakin metode impor mana yang Anda gunakan, di folder proyek Unity Anda, buka file Packages/manifest.json . Jika file berisi entri yang dimulai dengan com.google.firebase , proyek 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.

    Antarmuka Manajer Paket

    1. Di proyek Unity terbuka Anda, navigasikan ke Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
    2. Pilih semua paket Firebase dan External Dependency Manager.
    3. Klik Copot Paket yang Dipilih .

    Penghapusan manual

    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 pada halaman ini.