Paket Google untuk Unity didistribusikan dalam dua format berbeda:
- Paket aset:
- Memiliki ekstensi
.unitypackage
. - Instal ke direktori
Assets
project Anda. - Dapat diimpor di Unity 5 dan yang lebih baru.
- Umumnya mencakup paket dependen.
- Memiliki ekstensi
- Paket Unity Package Manager (UPM):
- Memiliki ekstensi
.tgz
. - Instal ke direktori
Packages
project Anda. - Dapat diimpor di Unity 2018.4 dan yang lebih baru.
- Mereferensikan paket dependen yang perlu diinstal secara terpisah.
- Memiliki ekstensi
Halaman Packages berisi file .unitypackage
terbaru untuk semua paket
yang tersedia.
Halaman Arsip berisi file .unitypackage
dan .tgz
untuk
semua versi paket.
Di bawah ini Anda dapat menemukan petunjuk cara menginstal kedua jenis paket, beserta petunjuk migrasi untuk bertransisi dari satu jenis ke jenis paket lainnya.
Setelah memahami opsi penginstalan ini, pastikan untuk membaca petunjuk khusus produk tambahan untuk Firebase.
Mengimpor paket Aset dengan file .unitypackage
Impor file .unitypackage
dengan memilih opsi menu Unity Assets > Import package > Custom Package
dan mengimpor semua item.
Tindakan ini akan menambahkan konten paket ke project Anda pada direktori
Assets.
Mengimpor paket UPM dengan file .tgz
(2018.4+)
Impor file .tgz
ke project Anda menggunakan salah satu metode berikut:
manifest.json
- Buat folder baru di samping folder
Packages
project Anda dan beri namaGooglePackages
. - Tempatkan file
.tgz
ke dalam folder tersebut. - Gunakan editor teks untuk membuka
Packages/manifest.json
pada folder project Unity Anda. Tambahkan entri untuk setiap paket yang ingin Anda instal, dengan memetakan nama paket ke lokasi pada disk, secara relatif terhadap file
Packages/manifest.json
. Pastikan untuk menambahkanfile:
ke jalur file.tgz
. Misalnya, jika Anda menginstalcom.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... } }
Simpan file manifest.json.
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:
- Buka kompresi file
.tgz
. - Tempatkan folder yang diekstrak di folder
GooglePackages
. Edit manifest.json 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... } }
UI Pengelola 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 file browser.
Beberapa versi Unity yang lebih lama tidak mendukung penambahan tarball secara langsung. Dalam hal ini, Anda harus:
- Buka kompresi file
.tgz
. Klik ikon
+
di pojok kiri atas jendela Package Manager dan pilihAdd package from disk
untuk membuka file browser.Pilih folder yang diekstrak di file browser.
Pastikan Anda juga mengimpor file .tgz
untuk dependensi paket,
yang dapat Anda temukan tercantum di halaman arsip di bagian
paket yang diinginkan.
Misalnya, jika Anda menginstal com.google.firebase.storage
, Anda akan
menginstal file .tgz
ini dalam urutan berikut:
- Pengelola Dependensi Eksternal (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Firebase Auth (
com.google.firebase.auth
) - Penyimpanan Firebase (
com.google.firebase.storage
)
Jika Anda ingin menambahkan semua file .tgz
sekaligus tanpa mengkhawatirkan urutannya, Anda dapat mengikuti petunjuk di tab manifest.json.
Kontrol versi
Jika Anda menggunakan software kontrol versi untuk mengelola file project, sebaiknya
tambahkan file .tgz
yang relevan ke kontrol versi. Anda dapat mengedit manifest.json
project secara manual (lihat petunjuk di atas) dan mereferensikan file .tgz
lokal menggunakan jalur relatif.
Jika Anda menggunakan git, sebaiknya gunakan Git Large File Storage (LFS) untuk mengelola file .tgz
berukuran besar.
Bermigrasi dari paket UPM ke paket Asset
Dalam beberapa kasus, Anda dapat beralih dari menggunakan Unity Package Manager untuk mengelola paket Google, ke menginstal paket dalam folder Assets.
Pastikan semua paket Google dihapus dari Unity Package Manager menggunakan salah satu metode berikut:
UI Pengelola Paket
- Buka jendela Package Manager Unity.
Pilih
In Project
pada menu dropdown di kiri atas.Ketikkan
com.google
di kotak penelusuran untuk memfilter paket Google.Klik setiap nama paket, lalu klik
Remove
.
manifest.json
- Gunakan editor teks untuk membuka
Packages/manifest.json
pada folder project Unity Anda. - Periksa apakah ada paket dari Google di bagian "dependensi". Nama paket harus diawali dengan "com.google", misalnya "com.google.firebase.app".
- Hapus baris tersebut dan simpan file json.
- Saat kembali fokus, Unity akan memuat ulang file
manifest.json
dan menghapus paket yang dihapus.
Setelah meng-uninstal paket tersebut dari Unity Package Manager, Anda dapat
mendownload dan mengimpor file .unitypackage
pengganti dari halaman
arsip.
Bermigrasi dari paket Asset ke paket UPM
Dalam beberapa kasus, Anda dapat beralih dari menginstal produk di bagian hierarki Aset ke menginstal dan melacak produk dengan Unity Package Manager.
Jika tidak yakin metode penginstalan mana yang Anda gunakan, di UI Unity, periksa apakah paket Google yang diinginkan muncul di tab Project, di bagian Aset.
Untuk bermigrasi ke paket UPM:
Pastikan semua paket Google dihapus dari folder Assets.
- Untuk meng-uninstal paket Firebase, ikuti petunjuk ini.
- Untuk meng-uninstal Play Plugin untuk Unity, hapus folder
GooglePlayPlugins
diAssets
.
Instal paket menggunakan Unity Package Manager, seperti yang dijelaskan di atas.
Petunjuk Migrasi khusus Produk
Lihat di sini untuk mengetahui petunjuk Firebase.