Paketleme kimlik ön eki ayırma
Paket sahipleri kimlik ön eklerini ayırarak kimliklerini ayırabilir ve koruyabilir. Paket tüketicilerine, kullandıkları paketler tanımlayıcı özelliklerinde yanıltıcı olmadığında ek bilgiler sağlanır.
nuget.org ve Visual Studio 2017 sürüm 15.4 veya üzeri, paket ayrılmış kimlik ön eki adlandırma düzeniyle eşleşdiği sürece sahipler tarafından ayrılmış paket kimliği ön eki ile gönderilen paketler için görsel bir gösterge gösterir. Aşağıdaki başvuruda, kimlik ön eki ayırmasının ne gerektirdiği ve bir sahibin kimlik ön eki için nasıl başvurabileceği açıklanmaktadır.
Kimlik ön eki rezervasyon ayrıntıları
Paket kimliği ön eki ayrıldığında, hem nuget.org galerisinde hem de Visual Studio'da çeşitli şeyler gerçekleşir. Buna ek olarak, kimlik ön eki ayırmaları tarafından desteklenen gelişmiş senaryolar vardır. Örneğin, ön ek 'genel' olarak ayarlanır ve ön ek alt kümelerini birden çok sahipe temsilci olarak atanır.
nuget.org kimlik ön eki rezervasyonu
nuget.org bir ön ek ayrıldığında aşağıdakiler gerçekleşir:
Ön ek rezervasyonu, nuget.org bir sahip veya sahip kümesiyle ilişkilendirilir.
Ayrılmış kimlik ön eki ile eşleşen bir kimlikle nuget.org bir paket gönderildiğinde, paket kimlik ön ekini rezerve eden sahiplerden kaynaklanmadığı sürece reddedilir.
Ayrılmış kimlik ön eki ile eşleşen ve kimlik ön ekini rezerve eden sahiplerden gelen tüm paketlerde Visual Studio 2017 sürüm 15.4 veya sonraki bir sürümde ve nuget.org paketin ayrılmış kimlik ön eki altında olduğunu belirten görsel bir gösterge bulunur. Bu, hem yeni paket gönderimleri hem de sahipler altındaki mevcut paketler için geçerlidir. Not: Visual Studio'daki gösterge yalnızca paket kaynağı olarak tek bir akış seçildiğinde görünür.
Ayrılmış kimlik ön eki ile eşleşen, ancak ayrılmış ön ekin sahibine ait olmayan önceden var olan tüm paketler değişmeden kalır (listeden çıkarılmazlar, ancak görsel göstergeye de sahip olmazlar). Ayrıca, bu paketlerin sahipleri pakete yeni sürümler göndermeye devam edebilecektir.
Bu değişiklikler aşağıdaki koşulları temel alır ve birkaç ek kısıtlama uygular:
Bir paketin yalnızca bir sahibinin görsel göstergenin görünmesi için ayrılmış ön eke sahip olması gerekir (birden çok sahibi olan paketler için).
Bir veya daha fazla sahibin ayrılmış ön eke sahip olduğu ve bir veya daha fazla sahibin ayrılmış ön eke sahip olmadığı bir paketin birden fazla sahibi varsa, yalnızca ayrılmış ön eki olan sahipler ayrılmış ön eke sahip diğer sahipleri kaldırabilir. Ayrılmış ön eke sahip olmayan sahipler, ayrılmış ön eke sahiplerini kaldıramaz. Yine de ön eki ayrılmış olmayan diğer sahipleri kaldırabilirler.
Bir paket görsel göstergeye sahip olduğunda, her zaman görsel göstergeye sahip olmalıdır (ayrılmış ön eke sahip en az bir sahibin her zaman sahip olarak kalacağını garanti eder)
Gelişmiş ön ek ayırma senaryoları
Alt düzeltme temsilcisi ve ön ekleri genel olarak işaretleme de dahil olmak üzere aşağıda açıklanan birkaç gelişmiş ön ek ayırma senaryosu vardır. Aşağıda, yapılabilecek daha gelişmiş ön ek rezervasyonları yer almaktadır.
Ön ek ayırma sırasında sahip, diğer sahiplere ön ek alt kümelerinin (veya ön ekin) temsilini isteyebilir. Örneğin , 'Microsoft' 'Microsoft.*' sahibiyse, ancak 'aspnet' 'Microsoft.AspNet.*' ayırmak istiyorsa, 'Microsoft' aspnet hesabına 'Microsoft.AspNet.*' atamayı seçebilir.
Ön ek ayırma sırasında, sahip bir ön ekin genel olmasını seçebilir. Bu, onlara paketin ayrılmış ön ekten geldiğini gösteren görsel göstergeyi vermeye devam eder, ancak herhangi bir sahip için ön ekte gelecek paket gönderimlerini engellemez. Bu, birçok katkıda bulunanı olan açık kaynak projelerde yararlıdır. En üstteki veya temel katkıda bulunanların ön eki ayrılmış olabilir, ancak tüm katkıda bulunanlara açık olabilir.
Ön ek rezervasyon görseli göstergesi
Paket ayrılmış ön ekten geldiğinde, nuget.org galerisinde ve Visual Studio 2017 sürüm 15.4 veya sonraki sürümlerinde aşağıdaki görsel göstergeleri görürsünüz:
nuget.org Galerisi
Visual Studio
Kimlik ön eki ayırma uygulama işlemi
Ön ek kimliği rezervasyonu için kabul ölçütlerini gözden geçirin.
Gerektirebilecek gelişmiş ön ek ayırma senaryolarına ek olarak ayırmak istediğiniz ön ekleri belirleyin.
nuget.org üzerinde sahip görünen adı ve ayrıca istediğiniz ayrılmış ön ekleri içeren bir posta account@nuget.org gönderin. Ön ek alt kümelerini birden çok sahipe temsilci olarak seçiyorsanız, tüm sahip görünen adlarından ve ön ek alt kümelerinden bahseddiğinizden emin olun.
Başvuru gönderildikten sonra size kabul veya ret bildirimi gönderilir (reddedilmeye neden olan ölçütlerle). Sahip kimliğini onaylamak için ek tanımlayıcı sorular sormamız gerekebilir.
Kimlik ön eki rezervasyon ölçütleri
Kimlik ön eki rezervasyonu için herhangi bir uygulamayı gözden geçirirken, NuGet.org ekibi uygulamayı aşağıdaki ölçütlere göre değerlendirir. Bir ön ekin ayrılması için tüm ölçütlerin karşılanması gerekmediğini, ancak karşılanan ölçütlerle ilgili önemli bir kanıt yoksa uygulamanın reddedilebileceğini unutmayın (açıklama verilmiştir):
Paket kimliği ön eki rezervasyon sahibini düzgün ve net bir şekilde tanımlayacak mı?
Paket kimliği ön eki, herhangi bir sahip veya kuruluşa ait olmaması gereken ortak bir özellik mi? Dört karakterden kısa kimlik ön eki rezervasyonlarından kaçının ve yaygın veya genel sözcüklerden kaçının.
Paket kimliği ön ekinin rezerve edilmemesi belirsizliğe, karışıklığa veya topluluğa başka zararlar vermez mi?
Kimlik ön eki ayırmanızdaki NuGet.org paketleri yayımlarken aşağıdaki en iyi yöntemler göz önünde bulundurulmalıdır:
Paket kimliği ön eki ile eşleşen paketlerin tanımlayıcı özellikleri açık ve tutarlı mı (özellikle paket yazarı)?
Paketlerin bir lisansı var mı (lisans meta verileri öğesini ve kullanım dışı bırakılan NOT licenseUrl'i kullanarak)?
Paketlerin bir simgesi varsa (iconUrl meta veri öğesini kullanarak), simge meta veri öğesini de kullanıyorlar mı? IconUrl'i kaldırmak gerekli değildir, ancak eklenmiş simgelerin kullanılması gerekir.
Yukarıdaki noktalara ek olarak tam paket yazma en iyi yöntemler kılavuzunu gözden geçirmeyi göz önünde bulundurun.
Üçüncü taraf akış sağlayıcısı senaryoları
Üçüncü taraf bir akış sağlayıcısı ön ek rezervasyonları sağlamak için kendi hizmetini uygulamakla ilgileniyorsa, bunu NuGet V3 akış sağlayıcılarındaki arama hizmetini değiştirerek yapabilir. Akış arama hizmetindeki değişiklik özelliği eklemektir verified . NuGet istemcisi V2 akışında eklenen özelliği desteklemez.
Daha fazla bilgi için API'nin arama hizmeti hakkındaki belgelere bakın.
Paket Kimliği Ön Eki Rezervasyon Uyuşmazlık İlkesi
NuGet.org sahibine yukarıdaki ölçütlere uygun bir paket kimliği ön eki rezervasyonu atandığını veya ticari marka veya telif haklarını ihlal ettiğini düşünüyorsanız, lütfen söz konusu kimlik ön ekini, kimlik ön ekinin sahibini ve atanan ön ek rezervasyonunu değiştirme nedenini içeren bir e-posta gönderinsupport@nuget.org.