Solução de problemas: Como faço para liberar uma nova versão da minha extensão existente?

Importante

no momento, não há suporte oficialmente para a criação de novas extensões no Visual Studio 2019 para Mac.

o servidor de repositório de extensão de Visual Studio para Mac será movido em 15 de janeiro de 2021. Essa movimentação não afetará os usuários que já baixaram sua extensão, mas mudará a maneira como você publica novas versões da extensão após essa data.

Como autor de uma extensão existente, você precisará seguir um fluxo de trabalho diferente para liberar mais atualizações. Esse processo consiste em:

  • configurando um repositório de GitHub público para cada extensão
  • compartilhando a URL do repositório para a equipe de Visual Studio para Mac por meio da lista de endereçamento de publicação de extensão
  • Atualizando sua extensão usando o recurso de versões no GitHub

Instalação inicial

para continuar publicando atualizações em suas extensões, você precisará criar um repositório de GitHub público. Se você publicar várias extensões, precisará ter um repositório separado para cada um, a menos que você sempre tenha a versão e publique-os juntos, caso em que você pode usar um único repositório.

Observação

embora o repositório de GitHub para sua extensão precise ser público, você não precisa hospedar nenhum do seu código lá. Seguir esse processo não exige que você tenha qualquer um de seus códigos no GitHub.

Compartilhar o local do seu repositório

Depois de configurar o repositório, envie um email para a lista de endereçamento de publicação de extensão com a URL.

Liberar uma nova versão

Você usará o link "criar uma nova versão" na página principal do repositório para iniciar o processo de atualização de sua extensão. Depois de selecionar esse link, siga estas etapas:

  1. Adicione informações à versão de marca da versão no seguinte formato

    <releaseVersion> - VSM v<targetVersion>

    Em que:

    • < releaseVersion > é o número de versão da extensão
    • < targetVersion > é a versão mínima do Visual Studio para Mac sua extensão está direcionando
  2. Adicional Os campos título e Descrição podem ser preenchidos com as informações desejadas; Esse fluxo de trabalho não usa as informações contidas nesses campos.

  3. Verifique se a caixa de seleção pré-lançamento está desmarcada. Se estiver marcada, a versão não será selecionada por esse processo de publicação.

  4. Anexe os arquivos . mPack que implementam sua extensão na seção de binários . É possível anexar vários arquivos . mPack em uma versão.

Visual Studio para Mac exibirá a versão mais recente da extensão que é compatível com a Visual Studio para Mac instalação que foi usada para acessar o repositório de extensões.

contanto que você tenha registrado seu repositório de GitHub com a equipe de Visual Studio para Mac, sua versão de extensão será coletada por Visual Studio para Mac dentro de 24 horas.

Informações adicionais

  • As versões que não estão em conformidade com os requisitos detalhados acima não serão publicadas.
  • após 15 de janeiro de 2021, as atualizações de extensão só aparecerão no Visual Studio para Mac 8,0 ou mais recente.
  • as extensões existentes permanecerão disponíveis para Visual Studio para Mac usuários sem nenhuma ação de sua parte. Você só precisa seguir as instruções neste guia se publicar uma nova versão após 15 de janeiro de 2021.