Pendaftaran Lingkup

Pendaftaran Lingkup memungkinkan Unity untuk berkomunikasi lokasi server registry paket kustom ke Manajer Paket sehingga pengguna memiliki akses ke beberapa koleksi paket pada saat yang sama. Berikut adalah beberapa konsep penting untuk membantu Anda memahami fitur ini:

Concept:	Description:
package registry server	Aplikasi yang melacak paket dan menyediakan tempat untuk menyimpannya. Dalam jendela Manajer Paket Unity, semua paket yang terdaftar di registry Unity muncul di list view ketika Anda memilih konteks Unity Registry.
package manager	Aplikasi yang memberi tahu pengguna apa yang tersedia, dan mengunduh dan menginstal paket apa pun permintaan pengguna untuk proyek mereka. Unity telah menerapkan versi sendiri dari manajer paket, tetapi ada beberapa aplikasi serupa di organisasi lain.
scope	Tentukan nama paket atau namespace (dalam format domain terbalik), seperti com.example.mycompany.animation atau com.example. Ketika pengguna meminta paket, Manajer Paket mengambil paket dari registry yang paling cocok dengan ruang lingkup. Untuk informasi lebih lanjut, lihat Mengelola registries lingkup untuk proyek di bawah ini.

Penyedia paket mengatur server registry kustom untuk host dan mendistribusikan paket kustom selain Unity registry. Paket konsumen mengatur registries lingkup untuk setiap proyek untuk mengakses server registry penyedia paket kustom.

Note: Sebagai penyedia paket, pastikan semua server registry paket yang Anda atur sesuai dengan Syarat Layanan Unity, dan khusus untuk . Unity menyediakan akses ke Manajer Paket untuk memudahkan berbagi pengetahuan dan penciptaan, tetapi bukan sebagai pasar untuk produk pihak ketiga.

Pendaftaran Lingkup dapat membantu:

• Provide new functionality by distributing tools, libraries, and other assets.

  Sebagai penyedia, Anda dapat membuat registry Anda sendiri untuk mendistribusikan alat dan scriptsSepotong kode yang memungkinkan Anda untuk membuat Komponen Anda sendiri, memicu peristiwa permainan, memodifikasi sifat komponen dari waktu ke waktu dan menanggapi input pengguna dengan cara apa pun yang Anda sukai. More info
  Lihat di Glossary (atau jenis aset lainnya) dengan nomor versi yang menunjukkan seberapa matang paket, atau apakah pembaruan memperkenalkan perubahan API melanggar atau perbaikan kecil: Versi Semantik. Dan kode Anda dapat tergantung pada kode dalam paket lain karena Manajer Paket mendukung paket.

  Sebagai konsumen, pengalaman browsing dan menginstal paket kustom pihak ketiga di Manajer Paket sama dengan paket Unity.

• Extend existing Unity’s package features.

  Sebagai konsumen, Anda dapat memiliki pengalaman yang mulus di mana paket kustom menimpa paket Unity tanpa harus secara manual beralih registries atau secara eksplisit menginstal versi paket yang berbeda. Ini karena Anda dapat memetakan paket ke registry tertentu sehingga Manajer Paket mengambil dari salah satu registry Unity atau server registry paket kustom.

• Access packages in a closed network environment.

  Beberapa organisasi bekerja di dalam jaringan tertutup, yang membuatnya sulit untuk mengakses registry paket Unity. Dalam kasus ini, organisasi dapat mengatur registry paket mereka sendiri di dalam jaringan tertutup mereka. Administrator jaringan kemudian dapat disinkronkan secara berkala dengan registry paket Unity untuk memastikan registry lingkup memiliki paket terbaru yang tersedia.

Jika Anda adalah paket konsumen, lihat Mengelola registries lingkup untuk proyek untuk mengetahui cara menghubungkan ke server registry paket kustom yang ada di proyek Unity Anda. Jika Anda adalah produsen paket, lihat Berbagi paket Anda untuk mengetahui paket server registry didukung dan tautan ke informasi tentang cara mengaturnya untuk digunakan dengan Pendaftaran Lingkup.

Sitemap Jika Anda mengatur registry lingkup yang menunjuk ke server registry paket dengan akses terbatas, Anda dapat mengkonfigurasi Manajer Paket untuk lulus token otentikasi npm Anda ke server. Untuk informasi lebih lanjut, lihat Note:.Otentikasi registry tersedak.

Pendaftar lingkup impor

Jika Anda bekerja dalam proyek bersama, dan pengguna lain menambahkan registry lingkup ke proyek, Unity memperingatkan Anda bahwa registry lingkup baru telah ditambahkan.

Ketika Anda mengklik tombol Close, jendela Package Manager project settingsPengumpulan yang luas dari pengaturan yang memungkinkan Anda untuk mengkonfigurasi bagaimana Fisika, Audio, Jaringan, Grafik, Input dan banyak bidang lain dari jangkauan proyek Anda. More info
Lihat di Glossary muncul sehingga Anda dapat add, modify, atau registries lingkup remove untuk proyek Anda.

Jika Anda mengklik tombol Read more, Unity membuka halaman ini di browser web default Anda.

Tip:
Untuk mengakses jendela pengaturan proyek Paket Manager setiap saat, gunakan menu utama di Unity (menu: Edit > Project Settings, maka kategori Package Manager) atau pilih Advanced Project Settings dari menu drop-down Pengaturan canggih di jendela Paket Manager.

Mengelola registries lingkup untuk proyek

Untuk mengelola registries paket ruang lingkup dalam proyek Anda, Anda dapat mengedit file manifestasi proyekSetiap proyek Unity memiliki manifestasi proyek, yang bertindak sebagai titik masuk untuk Manajer Paket. File ini harus tersedia di direktori <project>/Packages. Manajer Paket menggunakannya untuk mengkonfigurasi banyak hal, termasuk daftar dependensi untuk proyek itu, serta repositori paket untuk permintaan. More info
Lihat di Glossary Anda langsung atau menggunakan jendela pengaturan proyek Package Manager untuk membiarkan Unity memodifikasi manifestasi untuk Anda.

Proyek ini memanifestasikan menggunakan properti scopedRegistries, yang mengandung array objek konfigurasi registry. Setiap objek mengandung sifat berikut:

Property	JSON Type	Description
name	String	Nama lingkup seperti muncul di antarmuka pengguna. Jendela Paket Manager menampilkan nama ini di Detail paket. Sebagai contoh, "name": "Tools".
url	String	URL ke server registry yang tidak kompatibel. Sebagai contoh, "url": "https://mycompany.example.com/tools-registry" Note: Tidak semua penyedia registry kompatibel dengan Manajer Paket Unity. Pastikan server registry paket Anda mencoba menambahkan implementasi endpoints /-/v1/search atau /-/all.
scopes	Array String	Array lingkup yang dapat Anda peta ke nama paket, baik sesuai dengan nama paket, atau sebagai ruang nama. Wildcards dan pola glob lainnya tidak didukung. Sebagai contoh, "scopes": [ "com.example", "com.example.tools.physics" ] Note: Jenis konfigurasi ini mengasumsikan bahwa paket mengikuti Nama domain terbalik. Ini memastikan bahwa com.unity setara dengan nama paket yang sesuai dengan ruang nama com.unity, seperti com.unity.timeline atau com.unity.2d.animation. Warning: Unity tidak mendukung notasi lingkup npm.

Ketika Manajer Paket memutuskan yang registry untuk mengambil paket dari, itu membandingkan paket name untuk nilai scopes dan menemukan registry yang scopes paling erat pertandingan.

Misalnya, dalam proyek di bawah ini, ada dua registries terskop, "General" dan "Tools":

{
    "scopedRegistries": [
        {
            "name": "General",
            "url": "https://example.com/registry",
            "scopes": [
                "com.example", "com.example.tools.physics"
            ]
        },
        {
            "name": "Tools",
            "url": "https://mycompany.example.com/tools-registry",
            "scopes": [
                "com.example.mycompany.tools"
            ]
        }
    ],
    "dependencies": {
        "com.unity.animation": "1.0.0",
        "com.example.mycompany.tools.animation": "1.0.0",
        "com.example.tools.physics": "1.0.0",
        "com.example.animation": "1.0.0"
    }
}

Ketika Manajer Paket muncul paket com.example.animation, menemukan bahwa ruang nama com.example adalah pertandingan paling dekat dengan namanya, dan oleh karena itu mengambil paket dari registry "General".

Ketika Manajer Paket muncul paket com.example.tools.physics, registry “General” memiliki ruang lingkup yang sesuai dengan nama paket.

Ketika Manajer Paket muncul paket com.example.mycompany.tools.animation, Manajer Paket menemukan bahwa ruang nama com.example.mycompany.tools adalah pertandingan paling dekat dengan namanya dan oleh karena itu mengambil paket dari registry "Tools". Meskipun juga cocok dengan ruang lingkup "General", ruang nama com.example tidak sedekatnya.

Ketika Manajer Paket muncul paket com.unity.animation, Manajer Paket tidak menemukan pertandingan di salah satu registries ruang lingkup, dan oleh karena itu mengambil paket dari registry default.