Compartilhar via

Hospedagem de conteúdo estático

Azure DevOps Services

Escolha hospedar conteúdo estático para sua extensão, como arquivos HTML, CSS e JavaScript, em seu próprio serviço, em um serviço de hospedagem de terceiros, como o Azure ou o Heroku, ou em Azure DevOps Services diretamente.

Importante

Se sua extensão precisar criar uma tabela personalizada no banco de dados TFS, não crie-a usando o esquema 'dbo'. Em vez disso, as tabelas personalizadas devem ser criadas em um esquema separado. Por exemplo, 'YourExtensionName'.

Dica

Confira nossa documentação mais recente sobre o desenvolvimento de extensão usando o SDK da Extensão do Azure DevOps.

Hospedar no Azure DevOps Services

Nesse modelo, o conteúdo estático é empacotado com o arquivo .vsix da extensão e é fornecido de um ponto de extremidade público em https://publisher.gallerycdn.vsassets.io.

O conteúdo estático da sua extensão é útil quando você está aprimorando ou decorando dados de Azure DevOps Services. O pub de extensão não exige que você (o editor de extensões) configure, gerencie ou pague pelos serviços de hospedagem para sua extensão

Etapas

  1. No arquivo de manifesto da extensão, especifique os arquivos que você deseja incluir por meio da files propriedade :
    {
  "files": [
    {
        "path": "scripts", "addressable": true
    },
    {
        "path": "images/extra/icon1.png", "addressable": true
    }
  ]
}
  2. Remova a baseUri propriedade (se definida) do manifesto da extensão.
  3. Empacotar sua extensão (etapas)
  4. Publicar (ou republicar) sua extensão (etapas)
> [! IMPORTANTE] > Não deixe de incrementar a versão da extensão ao fazer alterações em arquivos de conteúdo estático incluídos no .vsix.

Tenha em mente que:

  • O valor especificado pelo path atributo pode ser uma pasta ou um arquivo individual. Se uma pasta, toda a pasta (e qualquer subpasta) será incluída.
  • O addressable atributo é importante e é o que informa aos Codespaces do Visual Studio para tornar a URL do arquivo endereçável.
  • Todas as addressable solicitações de ativo diferenciam maiúsculas de minúsculas. Se a solicitação de um ativo tiver um caso diferente do ativo carregado real, isso resultará em um erro HTTP 404 (Não encontrado).
  • Não especificar um baseUri ou definir um valor vazio informa ao Visual Studio Codespaces em runtime para calcular o URI base como se o conteúdo estático fosse hospedado por Azure DevOps Services.

Hospedar em seu próprio serviço (ou em um serviço de terceiros)

Nesse modelo, o conteúdo estático é fornecido do seu próprio serviço e não está incluído no arquivo .vsix da sua extensão.

Etapas

  1. Defina a baseUri propriedade em seu manifesto de extensão Por exemplo, supondo um valor de e esta contribuição de https://myservice.net/extension hub:
    "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 carrega o conteúdo desse hub quando ele é renderizado em https://myservice.net/extension/hello-world.html.

Próximas etapas

Empacotar, publicar e instalar extensões