Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

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 APIs for 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 bersama file .tgz terkait yang menjadi sandarannya.

Halaman ini memberikan instruksi yang melibatkan Unity Package Manager, jadi merupakan ide bagus untuk mempelajari alat ini dari dokumentasi Unity .

Impor paket Firebase sebagai Aset

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

  • Jika Anda menggunakan beberapa produk Firebase dalam proyek, 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 Anda yang terbuka, navigasikan ke Assets > Import Package > Custom Package .

  2. Di jendela Import Unity Package , klik Import .

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 harus mendownload dan mengupgrade semua produk Firebase ke versi yang sama.

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

  • Ketergantungan 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. Pengelola Ketergantungan Eksternal ( com.google.external-dependency-manager )
    2. Inti Firebase ( 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 Package Manager Unity.
  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 browser file.

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

  1. Buka zip file .tgz .
  2. Klik ikon + di pojok kiri atas jendela Package Manager dan pilih Add package from disk untuk membuka browser file.
  3. Pilih folder yang diekstraksi 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, petakan nama paket ke lokasi di disk. Pastikan untuk menambahkan file: ke jalur file .tgz . Misalnya, jika Anda mengimpor com.google.firebase.storage dan dependensinya, 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. Ketika Unity mendapatkan kembali fokusnya, itu 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 diekstraksi, 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 Pengelola Paket Unity 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 mengupgrade 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 mengimpor.

Untuk bermigrasi ke Unity Package Manager:

  1. Pastikan semua paket Firebase dan paket Manajer Ketergantungan Eksternal dihapus dari folder Assets , menggunakan salah satu metode berikut.

    Antarmuka Manajer Paket

    1. Di proyek Unity terbuka Anda, arahkan 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.