Reservasi prefiks ID paket

Artikel
08/10/2023

Pemilik paket dapat memesan dan melindungi identitas mereka dengan memesan awalan ID. Konsumen paket diberikan informasi tambahan ketika paket yang mereka konsumsi tidak menipu dalam properti identifikasi mereka.

nuget.org dan Visual Studio 2017 versi 15.4 atau yang lebih baru menunjukkan indikator visual untuk paket yang dikirimkan oleh pemilik dengan awalan ID paket yang dipesan, selama paket cocok dengan pola penamaan awalan ID yang dipesan. Referensi di bawah ini menjelaskan apa yang diperlukan reservasi awalan ID, dan bagaimana pemilik dapat mengajukan awalan ID.

Detail reservasi awalan ID

Ketika awalan ID paket dicadangkan, beberapa hal terjadi pada galeri nuget.org , serta di Visual Studio. Selain itu, ada skenario lanjutan yang didukung oleh reservasi awalan ID, seperti mengatur awalan sebagai 'publik', mendelegasikan subset awalan ke beberapa pemilik.

Reservasi awalan ID pada nuget.org

Ketika awalan dicadangkan pada nuget.org, hal berikut akan terjadi:

Reservasi awalan dikaitkan dengan pemilik atau sekumpulan pemilik di nuget.org.
Setiap kali paket dikirimkan ke nuget.org dengan ID yang cocok dengan awalan ID yang dipesan, paket ditolak kecuali berasal dari pemilik yang memesan awalan ID.
Paket apa pun yang cocok dengan awalan ID yang dipesan dan berasal dari pemilik yang memesan awalan ID akan memiliki indikator visual di Visual Studio 2017 versi 15.4 atau yang lebih baru, dan pada nuget.org menunjukkan bahwa paket berada di bawah awalan ID yang dipesan. Ini berlaku untuk pengiriman paket baru serta paket yang ada di bawah pemilik. Catatan: Indikator di Visual Studio hanya muncul jika umpan tunggal dipilih sebagai sumber paket.
Semua paket yang ada sebelumnya yang cocok dengan awalan ID yang dipesan, tetapi tidak dimiliki oleh pemilik prefiks yang dipesan akan tetap tidak berubah (tidak akan terdaftar, tetapi mereka juga tidak akan memiliki indikator visual). Selain itu, pemilik paket ini masih akan dapat mengirimkan versi baru ke paket.

Perubahan ini didasarkan pada kondisi berikut dan memberlakukan beberapa batasan tambahan:

Hanya satu pemilik paket yang perlu memiliki awalan yang dipesan agar indikator visual muncul (untuk paket dengan beberapa pemilik).
Jika ada lebih dari satu pemilik paket di mana satu atau beberapa pemilik memiliki awalan yang dipesan dan satu atau beberapa pemilik tidak memiliki awalan yang dipesan, maka hanya pemilik dengan awalan yang dipesan yang dapat menghapus pemilik lain dengan awalan yang dipesan. Pemilik yang tidak memiliki awalan yang dicadangkan tidak dapat menghapus pemilik dengan awalan yang dicadangkan. Mereka masih dapat menghapus pemilik lain yang juga tidak memiliki awalan yang dipesan.
Setelah paket memiliki indikator visual, paket harus selalu memiliki indikator visual (menjamin bahwa setidaknya satu pemilik dengan awalan yang dipesan akan selalu tetap menjadi pemilik)

Skenario reservasi awalan tingkat lanjut

Ada beberapa skenario reservasi awalan tingkat lanjut yang dijelaskan di bawah ini, termasuk delegasi subprefiks, dan menandai awalan sebagai publik. Di bawah ini adalah reservasi awalan yang lebih canggih yang dapat dilakukan.

Selama reservasi awalan, pemilik dapat meminta delegasi subset awalan (atau awalan) kepada pemilik lain. Misalnya, jika 'Microsoft' memiliki 'Microsoft.*', tetapi 'aspnet' ingin memesan 'Microsoft.AspNet.*', 'Microsoft' dapat memilih untuk mendelegasikan 'Microsoft.AspNet.*' ke akun aspnet .
Selama reservasi awalan, pemilik dapat memilih untuk membuat prefiks publik. Ini masih akan memberi mereka indikator visual yang menunjukkan bahwa paket berasal dari awalan yang dipesan, tetapi tidak akan memblokir pengiriman paket di masa mendatang pada awalan untuk pemilik mana pun. Ini berguna untuk proyek sumber terbuka dengan banyak kontributor - kontributor teratas atau inti dapat memiliki awalan yang dicadangkan, tetapi masih dapat terbuka untuk semua kontributor.

Indikator visual reservasi awalan

Ketika paket berasal dari awalan yang dipesan, Anda akan melihat indikator visual di bawah ini pada galeri nuget.org dan di Visual Studio 2017 versi 15.4 atau yang lebih baru:

Galeri nuget.org nuget.org Gallery

Visual Studio

Proses aplikasi reservasi awalan ID

Tinjau kriteria penerimaan untuk reservasi ID awalan.
Tentukan awalan yang ingin Anda pesan, selain skenario reservasi awalan tingkat lanjut yang mungkin Anda perlukan.
Kirim email ke account@nuget.org dengan nama tampilan pemilik di nuget.org, serta awalan cadangan yang Anda minta. Jika Anda mendelegasikan subset awalan ke beberapa pemilik, pastikan Anda menyebutkan semua nama tampilan pemilik dan subset awalan.

Setelah aplikasi dikirimkan, Anda akan diberi tahu tentang penerimaan atau penolakan (dengan kriteria yang menyebabkan penolakan). Kami mungkin perlu mengajukan pertanyaan identifikasi tambahan untuk mengonfirmasi identitas pemilik.

Kriteria reservasi awalan ID

Saat meninjau aplikasi apa pun untuk reservasi awalan ID, tim NuGet.org akan mengevaluasi aplikasi terhadap kriteria di bawah ini. Harap dicatat bahwa tidak semua kriteria perlu dipenuhi agar awalan dicadangkan, tetapi aplikasi dapat ditolak jika tidak ada bukti substansial dari kriteria yang terpenuhi (dengan penjelasan yang diberikan):

Apakah awalan ID paket dengan benar dan jelas mengidentifikasi pemilik reservasi?
Apakah awalan ID paket adalah sesuatu yang umum yang seharusnya bukan milik pemilik atau organisasi individu? Hindari reservasi awalan ID yang lebih pendek dari empat karakter dan hindari kata umum atau umum.
Apakah tidak akan menyimpan awalan ID paket menyebabkan ambiguitas, kebingungan, atau bahaya lainnya bagi komunitas?

Saat menerbitkan paket untuk NuGet.org dalam reservasi awalan ID Anda, praktik terbaik berikut harus dipertimbangkan:

Apakah properti identifikasi paket yang cocok dengan awalan ID paket jelas dan konsisten (terutama penulis paket)?
Apakah paket memiliki lisensi (menggunakan elemen metadata lisensi dan NOT licenseUrl yang tidak digunakan lagi)?
Jika paket memiliki ikon (menggunakan elemen metadata iconUrl), apakah paket tersebut juga menggunakan elemen metadata ikon ? Ini bukan persyaratan untuk menghapus ikonUrl tetapi ikon yang disematkan harus digunakan.

Pertimbangkan untuk meninjau panduan praktik terbaik penulisan paket lengkap selain poin di atas.

Skenario penyedia umpan pihak ketiga

Jika penyedia umpan pihak ketiga tertarik untuk menerapkan layanan mereka sendiri untuk menyediakan reservasi awalan, mereka dapat melakukannya dengan memodifikasi layanan pencarian di penyedia umpan NuGet V3. Perubahan dalam layanan pencarian umpan adalah menambahkan verified properti . Klien NuGet tidak akan mendukung properti yang ditambahkan di umpan V2.

Untuk informasi selengkapnya, lihat dokumentasi tentang layanan pencarian API.

Kebijakan Sengketa Reservasi Awalan ID Paket

Jika Anda yakin pemilik di NuGet.org diberi reservasi awalan ID paket yang bertentangan dengan kriteria yang tercantum di atas, atau pelanggaran pada merek dagang atau hak cipta apa pun, silakan kirim email support@nuget.org dengan awalan ID yang dimaksud, pemilik awalan ID, dan alasan untuk membahayakan reservasi awalan yang ditetapkan.

Share via