Statik içerik barındırma

Azure DevOps Hizmetleri

Uzantınız için HTML, CSS ve JavaScript dosyaları gibi statik içeriği kendi hizmetinizde, Azure veya Heroku gibi bir üçüncü taraf barındırma hizmetinde veya doğrudan Azure DevOps Services'te barındırmayı seçin.

Önemli

Uzantınızın TFS veritabanında özel bir tablo oluşturması gerekiyorsa, bunu 'dbo' şemasını kullanarak oluşturmayın. Bunun yerine, özel tablolar ayrı bir şemada oluşturulmalıdır. Örneğin, 'YourExtensionName'.

Tavsiye

En son uzantı geliştirme kılavuzu için, tema oluşturma ve VSS.SDK'den geçiş dahil, Azure DevOps Uzantısı SDK geliştirici portalına bakın.

Azure DevOps Services'te barındırma

Bu modelde, statik içerik uzantınızın .vsix dosyasıyla birlikte paketlenmiş ve https://publisher.gallerycdn.vsassets.io konumunda bulunan genel bir uç noktadan sunulur.

Uzantınızın statik içeriği, Azure DevOps Services'ten verileri geliştirirken veya süslerken kullanışlıdır. Uzantı pub'ı, uzantınızın barındırma hizmetlerini ayarlamanıza, yönetmenize veya ödemenize (uzantı yayımcısı) ihtiyaç duymaz

Steps

  1. Uzantı bildirim dosyanızda, özelliği aracılığıyla files eklemek istediğiniz dosyaları belirtin:
    {
      "files": [
        {
            "path": "scripts", "addressable": true
        },
        {
            "path": "images/extra/icon1.png", "addressable": true
        }
      ]
    }
    
  2. baseUri Uzantı bildiriminizden özelliğini (ayarlandıysa) kaldırın.
  3. Uzantınızı paketleme (adımlar)
  4. Uzantınızı yayımlama (veya yeniden yayımlama) (adımlar)
> [! ÖNEMLİ] >.vsix'inize dahil edilen statik içerik dosyalarında değişiklik yaptığınızda uzantınızın sürümünü artırdığınızdan emin olun.

Unutmayın:

  • özniteliği tarafından path belirtilen değer bir klasör veya tek bir dosya olabilir. Bir klasör varsa, klasörün tamamı (ve alt klasörler) dahil edilir.
  • addressable Özniteliği önemlidir ve Visual Studio Codespaces'a dosya URL'lerini adreslenebilir hale getirmesini söyleyen özelliktir.
  • Tüm addressable varlık istekleri büyük/küçük harfe duyarlıdır. Yüklenen varlığın yazım durumu ile varlık isteği farklı olduğunda HTTP 404 (Bulunamadı) hatasıyla sonuçlanır.
  • BaseUri belirtmiyor veya boş bir değer ayarlamıyorsanız Visual Studio Codespaces çalışma zamanında statik içeriğiniz Azure DevOps Services tarafından barındırıyormuş gibi temel URI'yi hesaplamasını söyler.

Üçüncü taraf bir hizmette barındırma

Bu modelde statik içerik kendi hizmetinizden sunulur ve uzantınızın .vsix dosyasına eklenmez.

Steps

  1. baseUri Uzantı bildiriminizdeki özelliği ayarlayın. Örneğin, değerinin https://myservice.net/extension olduğunu ve bu hub katkısını varsayalım:
    "baseUri": "https://myservice.net/extension",
    "contributions": [
        {
             "id": "Fabrikam.HelloWorld",
             "type": "ms.vss-web.hub",
             "targets": [
                 "ms.vss-work-web.work-hub-group"
             ],
             "properties": {
                 "name": "Hello",
                 "uri": "hello-world.html"
             }
         }
    ]

Azure DevOps Services, https://myservice.net/extension/hello-world.html konumunda hub işlendiğinde bu hub'ın içeriğini yükler.

Sonraki adım