Uzantıları paketle ve yayımla

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Uzantınızı yazdıktan sonra bir sonraki adım paketidir. Ardından, bunu markette yayımlar veya Visual Studio yüklersiniz. Kullanıcılar, kendileriyle paylaşılan uzantıyı Market'te yükleyebilir. Market, Microsoft'un özel ve genel uzantıları, tümleştirmeleri ve diğer tekliflerini sunan genel bir depo.

Önkoşullar

Market'te yayımlamadan önce aşağıdaki gereksinimler listesi karşılıdır.

• Tüm görüntüleri (simgeler, logolar, ekran görüntüleri ve diğer) kullanmak için uygun izinlerin verilmiş olduğundan emin olun
• Market'te overview.md listenizi açıklamak için kapsamlı bir dosya dahil edin
• Uzantınız için en az 128x128 piksel boyutunda bir simge içerir
• Microsoft ürünlerine başvururken kısaltmalar yerine tam ad kullanın. Örneğin, Azure DevOps Services AzDO veya diğer kısaltmalar
• Uzantınız adına marka adlarını kullanmaktan kaçınma

Yayımcı oluşturma

Uzantılar ve tümleştirmeler Visual Studio Market'te yer alan her öğe bir yayımcıya aittir.

Yayımcı bir kullanıcıya, genellikle onu oluşturan kullanıcıya aittir ve diğer kullanıcılarla da paylaşılır.

1. Visual Studio Market Yayımlama Portalı'na oturum açın.

2. Mevcut bir yayımcının üyesi değilseniz bir yayımcı oluşturmanız istenir. Yayımcı oluşturmanız istendiğinde sayfanın en altına inin ve İlgili sitelerin altında Uzantı yayımla'yıseçin.

   • Yayımcınız için bir kimlik belirteci belirtin, örneğin: mycompany-myteam
     • Bu tanımlayıcı, uzantı bildirim dosyanız publisher içinde özniteliğinin değeri olarak kullanılır.
   • Yayımcınız için bir görünen ad belirtin, örneğin: My Team

3. Market Sözleşmesi'Publisher gözden geçirerekOluştur'a seçin.

   

Yayımcı oluşturulduktan sonra, öğeleri yönetmeye yönlendirildiniz ve hiç öğe yok.

Uzantıyı paketle

Uzantılar VSIX 2.0 ile uyumlu .vsix dosyaları olarak paketlenmiştir. Uzantınızı karşıya yüklemek için VSIX 2.0 ile uyumlu bir .vsix dosyası olarak paketiniz gerekir. Microsoft, uzantınızı paket haline (ve yayımlamaya) için platformlar arası komut satırı arabirimi (CLI) sağlar.

Paket aracını (tfx-cli) al

Azure DevOps (tfx-cli) için platformlar arası CLI'Node.jsbileşenini komut satırınıza yükleyebilir npm veya güncelleştirebilirsiniz. npm

npm i -g tfx-cli

Uzantınızı bir .vsix dosyasında paketle

tfx extension create --manifest-globs vss-extension.json

Paket boyutunu denetleme

Paketledikten sonra vsix'in boyutunu kontrol edin. 50 MB'den büyükse iyileştirilmiş olması gerekir. Bunu yapmak için aşağıdaki noktalara bakın:

• Varsa, uzantı paketinde bir kez belirterek ortak bağımlılıkların yinelenenlerini silin.
• Paketin içinde sağlamak yerine çalışma zamanında veya yükleme zamanında şeyleri getirme. Çalışma zamanında araç bağımlılıklarını çekmek için araç yükleyicisi lib'sini kullanmayı göz önünde bulundurabilirsiniz. Lib'in kullanımı, aracın sürüme göre önbelleğe alınarak önbelleğe alınmış olduğu avantajları sunar. Bu nedenle özel aracılar için her derleme indirilemedi. Araç yükleyicisi görevlerinin dışında kullanılab olarak kullandık. Ancak görev, görevin açıklamasında / belgesinde olması gereken bağlantısız senaryolarda (İnternet yok) çalışmaz.
• Bazı müşteriler, görevlerinde bağımlılıklarını ağaçla sallarken WebPack'i başarılı bir şekilde kullandı.

Uzantı yayımlama

Uzantınız paketledikten sonra bir yayımcı altında Market'e yükleyebilirsiniz. Uzantının publisher bildirim dosyasında belirtilen publisher karşıya yük olduğu yayımcının tanımlayıcısıyla eşleşmeli.

Market'e bir uzantı yüklemek için:

1. Visual Studio Market Yayımlama Portalı'na gidin
2. Yeni Upload düğmesini bulun, paketlenmiş .vsix dosyanıza gidin ve karşıya yükle'yi seçin.
3. Hızlı doğrulamadan sonra uzantınız uzantı listesinde görünür:

Bu noktada, uzantınız herhangi bir hesapta görünmez ve siz paylaşmadan yük geri yüksersiniz.

Koruyucu Taramalar

Market kullanıcısı olarak, Market'te bir uzantı edinen kullanıcılar kötü amaçlı yazılım (kötü amaçlı yazılım) Visual Studio bekler. Bunu sağlamak için, yayımlanan her uzantı paketinde bir virüs taraması çalıştırmış oluruz. Bu, her yeni uzantı ve her uzantı güncelleştirmesi için gerçekleştirilir. Tarama temizleninceye kadar uzantıyı Market'te genel kullanım için yayımlamayız.

Belirtilen virüs taraması, uzantının yürütülmesi sırasında değil yalnızca uzantı yayımlaması sırasında çalıştırılır.

Ayrıca Market'te her uzantı için bir içerik taraması da gerçekleştireceğiz. Bu, her yeni uzantı ve her uzantı güncelleştirmesi için gerçekleştirilir. Bu şekilde Market sayfalarında uygunsuz veya rahatsız edici içeriklerin ortaya atılmasından kaçınacağız.

Uzantı paylaşma

Uzantıyı TFS veya TFS'ye yükleymeden önce bir kuruluşla Azure DevOps gerekir. Uzantıyı çalıştırmanın tek yolu bu olduğu için paylaşım, uzantı geliştirme ve test etme sırasında bir gereksinimdir.

Bir uzantıyı paylaşmak için aşağıdaki görevleri gerçekleştirin:

1. Menüyü getirmek için uzantı öğesinin üç noktalarını seçin

2. Paylaş düğmesini seçin

   

3. Bu uzantıyı görünür yapmak için kuruluşun adını belirtin

   • Örneğin, uzantıyı kuruluşa görünür hale dev.azure.com/fabrikam-fiber-inc belirtin.

Uzantı yükleme

Paylaşılan bir uzantıyı yüklemek için:

1. Kuruluş giriş sayfasında, sağ üst köşedeki Market simgesini seçin ve "Uzantıları Yönet"i seçin:

   

2. Uzantıyı Bu kuruluşla paylaşılan kategorisi altında bulun:

   

3. Öğeyi Market'te açmak için kartı seçin

4. Öğenin ayrıntılar sayfasında Yükle düğmesini seçin

5. Uzantıyı paylaştığınız kuruluşu seçin ve yükleme işlemiyle devam edin.

Uzantıyı güncelleştirme

Zaten yayımlanmış bir uzantıyı değiştirmek için güncelleştirin.

1. Görüntülenen öğeler listesinden bir uzantı seçin.
2. Sağ tıklayın ve örneğin için Güncelleştir'i seçin.
3. Uzantınızı doğrulama.
4. Üretim sürümünde de aynı güncelleştirmeleri publisher.extension (örneğin, ) yapma.
5. Uzantınız için .vsix'e göz atarak karşıya yükleyin.

Uzantının güncelleştirilmiş sürümü otomatik olarak zaten yüklü olan hesaplara yüklenir. Uzantının gelecekte yüklü olduğu yeni hesaplar da en son sürümü alır.

Uzantınızı genel hale (herkes görebilir)

Uzantınızı genel yapma hakkında daha fazla bilgi için Listelemenizi genel yapma'ı ziyaret edin.

Uzantıyı yayımdan kaldır

Artık Bunları Market'te sunmak veya yanlışlıkla yayımlamak istemiyorsanız, ücretsiz uzantıları yayımdan kaldırabilirsiniz/serbest listesine sızabilirsiniz.

Uzantınızı Market'te kaldırmak istemeniz gereken bazı senaryolar:

• Başka bir uzantı geliştirdin ve artık geçerli uzantıyı sunmak istemiyorsanız.
• Uzantınız bir soruna sahip, bu nedenle sorunu çözene kadar uzantınızı Market'den kaldırmak istiyorsanız.
• Uzantınızı yanlışlıkla genel olarak yayımladınız.

Yayımdan kaldır için yayımcı sayfasındaki uzantıyı seçin ve menüde Yayımdan kaldır'ı seçin. Uzantınız Market'te hemen yayımlanmamıştır ve yeni kullanıcılar uzantıyı yükleyemmektedir. Derecelendirme ve incelemeler uzantılarınız bozulmadan kalır.

Uzantınızı Market'te yeniden sunmak için menüde Yayımla'yı seçin.

Uzantınız sıfır (0) yüklemesi varsa uzantınızı marketten tamamen kaldırmayı da seçebilirsiniz. Bunu yapmak için menüden Kaldır'ı seçin. Bu eylem geri alınamaz.

Uzantı gereksinimlerini yayımdan kaldırma veya kaldırma

Uzantının yayımdan kaldırılması veya kaldırılması için belirli ölçütler karşılanılmalıdır:

Önemli:Yasal veya güvenlik sorunları nedeniyle uzantınızı kaldırmanız gerekirse Market ekibine ulaşın. İsteği gözden geçirecek ve uzantıyı el ile silebilirsiniz.

İletişim

Öğeleri Visual Studio Market'te yayımlama hakkında sorular vsmarketplace@microsoft.com gönderin.