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:
Di proyek Unity Anda yang terbuka, navigasikan ke Assets > Import Package > Custom Package .
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:- Pengelola Ketergantungan Eksternal (
com.google.external-dependency-manager
) - Inti Firebase (
com.google.firebase.app
) - Produk Firebase yang digunakan dalam proyek Anda. Jika Anda menggunakan Realtime Database atau Cloud Storage, impor Authentication (
com.google.firebase.auth
) terlebih dahulu.
- Pengelola Ketergantungan Eksternal (
Setelah mengunduh, impor file .tgz
ke proyek Anda menggunakan salah satu metode berikut:
Antarmuka Manajer Paket
- Buka jendela Package Manager Unity.
- Klik ikon
+
di pojok kiri atas jendela Package Manager dan pilihAdd package from tarball
untuk membuka file browser. - 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:
- Buka zip file
.tgz
. - Klik ikon
+
di pojok kiri atas jendela Package Manager dan pilihAdd package from disk
untuk membuka browser file. - Pilih folder yang diekstraksi di browser file.
manifest.json
- Buat folder baru di sebelah folder
Packages
proyek Anda dan beri namaGooglePackages
. - Tempatkan file
.tgz
ke dalam folder itu. - Gunakan editor teks untuk membuka
Packages/manifest.json
di bawah folder proyek Unity Anda. 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 mengimporcom.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... } }
Simpan file
manifest.json
.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:
- Buka zip file
.tgz
. 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:
Catat versi paket Firebase saat ini di proyek Anda dan hapus.
- Dari menu Window , pilih Package Manager . Di jendela Package Manager , pastikan "Packages: In Project" dipilih.
- Perhatikan versi paket Firebase yang diimpor.
- Klik setiap nama paket, lalu klik Hapus . Pastikan untuk menghapus paket External Dependency Manager (
.com.google.external-dependency-manager
) serta paket Firebase.
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:
Pastikan semua paket Firebase dan paket Manajer Ketergantungan Eksternal dihapus dari folder
Assets
, menggunakan salah satu metode berikut.Antarmuka Manajer Paket
- Di proyek Unity terbuka Anda, arahkan ke Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
- Pilih semua paket Firebase dan External Dependency Manager.
- 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
Impor paket menggunakan Unity Package Manager, seperti yang dijelaskan di atas pada halaman ini.