Otentikasi registry tersedak
Sesuaikan lokasi cache Aset Store

Sesuaikan lokasi cache global

Manajer Paket mempertahankan cache global untuk data registry dan paket yang tidak terkompresi. Cache global termasuk cache anak perusahaan, masing-masing menyajikan tujuan yang berbeda. Manajer Paket menyimpan cache global di lokasi default, yang dapat Anda tumpangkan.

Anda mungkin ingin menimpa lokasi cache untuk beberapa alasan:

  • Anda ingin menghemat ruang di drive internal Anda.
  • Anda ingin menyimpan cache di drive bersama, yang dapat diakses oleh orang lain.
  • Anda ingin menyimpan cache di folder yang tidak dalam direktori sistem.

Secara default, Manajer Paket menggunakan struktur folder berikut untuk cache global:

<global-cache-root>
  ├── npm
  │   └── <registry data (package metadata and tarballs)>
  ├── packages
  │   └── <uncompressed contents of package tarballs>
  └── git-lfs (if enabled)
       └── <downloaded Git LFS files>

Untuk informasi pada lokasi default dari akar cache global, lihat cache global.

Note: Manajer Paket mempertahankan cache terpisah untuk cache global dan cache paket Asset StoreSebuah perpustakaan yang berkembang dari aset gratis dan komersial yang diciptakan oleh Unity dan anggota komunitas. Menawarkan berbagai aset, dari tekstur, model dan animasi ke seluruh contoh proyek, tutorial dan ekstensi Editor. More info
Lihat di Glossary
. Untuk informasi tentang menimpa lokasi default untuk cache Aset Store, lihat Sesuaikan lokasi cache Aset Store.

Untuk menimpa lokasi default dari akar cache global, Anda dapat menggunakan metode berikut:

  • Jendela Preferences adalah metode yang disarankan karena kemudahan dan keabadiannya. Ketika Anda mengubah lokasi paket cache menggunakan metode ini, Unity menyimpan preferensi untuk sesi saat ini dan sesi masa depan.
    • Note: Menggunakan jendela Preferensi menetapkan properti cacheRoot dalam file konfigurasi pengguna. Jika Anda ingin mengatur file konfigurasi secara manual, lihat Menggunakan file konfigurasi.
  • Metode variabel lingkungan tidak permanen, tetapi pengguna canggih mungkin menemukannya lebih disukai dalam kasus penggunaan tertentu.

Catatan penting sebelum Anda mulai

  • Terlepas dari metode yang Anda pilih, mengubah lokasi cache memberitahu Manajer Paket untuk menggunakan lokasi itu akan maju. Paket yang ada yang disimpan dalam lokasi asli tetap berada di struktur folder tersebut.
  • Anda dapat menggunakan variabel lingkungan untuk menimpa lokasi akar cache global atau cache anak perusahaannya ( cache data registri, cache paket yang tidak terkompresi, dan cache Git LFS). Namun, variabel lingkungan dan sifat file konfigurasi tidak setara, sehingga menggunakan metode yang berbeda untuk mengkonfigurasi pengaturan dapat menghasilkan hasil yang tak terduga.
  • Ada beberapa faktor yang mempengaruhi bagaimana mengatur beberapa nilai dengan metode yang berbeda bekerja sama:
    • Jika Anda menggunakan metode variabel lingkungan untuk mengubah lokasi cache, maka Anda tidak dapat menggunakan jendela Preferensi untuk mengubah lokasi.
    • Ketika Anda menggunakan file konfigurasi pengguna, perubahan diterapkan pada akun pengguna saat ini.
    • Jika Anda menetapkan nilai yang berbeda untuk akar cache global dengan variabel lingkungan UPM_CACHE_ROOT dan properti cacheRoot, Manajer Paket menggunakan lokasi dalam variabel lingkungan UPM_CACHE_ROOT.
    • Jika Anda mengatur variabel lingkungan untuk cache data registry (UPM_NPM_CACHE_PATH), cache paket yang tidak terkompresi (UPM_CACHE_PATH), atau cache Git LFS (UPM_GIT_LFS_CACHE_PATH), Manajer Paket menggunakan lokasi yang ditentukan oleh variabel lingkungan, terlepas dari mana akar cache global.
    • Jika Anda mengaktifkan cache Git LFS (UPM_ENABLE_GIT_LFS_CACHE) tanpa pengaturan jalurnya secara eksplisit (UPM_GIT_LFS_CACHE_PATH), Manajer Paket menggunakan folder git-lfs di bawah akar cache global sebagai lokasinya.

Menggunakan jendela Preferensi

Untuk menggunakan jendela Preferensi untuk menimpa lokasi default cache global, ikuti langkah-langkah ini.

  1. Gunakan salah satu metode berikut untuk membuka jendela Preferensi:

    • Buka menu Unity (macOS) atau menu Edit (Windows dan Linux) dan pilih Preferences.
    • Buka jendela Paket Manager, klik ikon , dan pilih Preferences.
  2. Pilih kategori Package Manager.

  3. Di bawah Packages, buka menu di samping Cache Location .

  4. Pilih Change Location.

  5. Pilih lokasi baru untuk cache global.

The Preferences window with the Package Manager category selected
Jendela Preferensi dengan kategori Paket Manager yang dipilih

Menggunakan file konfigurasi

Anda dapat secara manual mengedit file konfigurasi yang sama dengan set jendela Preferences untuk menimpa lokasi akar cache global:

  1. Temukan file konfigurasi pengguna .upmconfig.toml. Untuk menemukan lokasi file, lihat File konfigurasi. Jika file tidak ada, buat file teks kosong.

  2. Mengatur properti cacheRoot ke lokasi khusus dengan jalur absolut. Contoh:

    cacheRoot = "/dev/external/shared/Unity/cache"
    

Anda tidak perlu me-restart Editor Unity atau Hub setelah memperbarui properti cacheRoot untuk perubahan untuk mengambil efek.

Menggunakan variabel lingkungan

Dalam skenario yang melibatkan otomasi atau integrasi berkelanjutan, kurang praktis dan lebih rentan kesalahan untuk mengkonfigurasi pengaturan dalam file konfigurasi atau jendela preferensi. Dalam skenario seperti itu, Anda mungkin mempertimbangkan menggunakan variabel lingkungan untuk mengkonfigurasi pengaturan untuk cache global dan cache anak perusahaan. Variabel lingkungan berikut tersedia:

Environment variable: Description:
UPM_CACHE_ROOT Tentukan lokasi cache global ( folder akar yang mengandung data registry dan cache paket yang tidak terkompresi).
UPM_NPM_CACHE_PATH Tentukan jalur absolut ke lokasi di mana Anda ingin paket Manager untuk menyimpan paket metadata dan tarball. Secara default, ini adalah subdirectory npm di bawah akar cache global.
UPM_CACHE_PATH Tentukan jalur absolut ke lokasi di mana Anda ingin Manajer Paket untuk menyimpan konten yang tidak terkompresi dari tarball paket. Secara default, ini adalah subdirectory packages di bawah akar cache global.
UPM_ENABLE_GIT_LFS_CACHE Tentukan nilai apa pun kecuali kosong () untuk mengaktifkan cache Git LFS. Secara default, Manajer Paket menggunakan subdirectory git-lfs di bawah akar cache global, kecuali Anda menentukan jalur yang berbeda menggunakan variabel lingkungan UPM_GIT_LFS_CACHE_PATH.
UPM_GIT_LFS_CACHE_PATH Tentukan jalur absolut ke lokasi di mana Anda ingin Manajer Paket untuk menyimpan Git LFS cache. Dengan mengatur jalur ini, Anda secara otomatis mengaktifkan cache Git LFS.

Important: Ikuti panduan ini ketika Anda menggunakan metode ini:

  • Tutup Editor Unity dan Hub Unity jika sudah berjalan sebelum mengatur variabel lingkungan.
  • Luncurkan Editor Unity atau Hub Unity dari sesi perintah yang sama atau terminal di mana Anda mengatur variabel lingkungan.
  • Setiap variabel lingkungan yang Anda set di atas harus diatur setiap kali Anda meluncurkan Unity.

Untuk informasi tentang mengatur variabel lingkungan, merujuk pada dokumentasi untuk sistem operasi Anda. Untuk pengenalan variabel lingkungan, lihat url https://en.wikipedia.org/wiki/Environment_variable.



  • Menyiapkan akar cache global sekarang didukung dalam file konfigurasi Paket Manager di Unity Panties20212
Otentikasi registry tersedak
Sesuaikan lokasi cache Aset Store