Solução de problemas: Como fazer liberar uma nova versão da minha extensão existente?Troubleshooting: How do I release a new version of my existing extension?

Importante

Atualmente, a criação de novas extensões não é oficialmente suportada no Visual Studio 2019 para Mac.Currently, creating new extensions is not officially supported in Visual Studio 2019 for Mac.

O servidor de repositório de extensão de Visual Studio para Mac será movido em 15 de janeiro de 2021.The Visual Studio for Mac extension repository server will be moving on January 15, 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.This move will not impact users that have already downloaded your extension, but will change the way you publish new releases of your extension after this date.

Como autor de uma extensão existente, você precisará seguir um fluxo de trabalho diferente para liberar mais atualizações.As an author of an existing extension, you'll need to follow a different workflow to release further updates. Esse processo consiste em:This process consists of:

  • Configurando um repositório GitHub público para cada extensãoSetting up a public GitHub repository for each extension
  • 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ãoSharing the repository URL to the Visual Studio for Mac team via the extension publishing mailing list
  • Atualizando sua extensão usando o recurso de versões no GitHubUpdating your extension by using the releases feature in GitHub

Instalação inicialInitial setup

Para continuar publicando atualizações em suas extensões, você precisará criar um repositório GitHub público.In order to continue publishing updates to your extensions, you'll need to create a public GitHub repository. 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.If you publish multiple extensions, you'll need to have a separate repository for each one unless you always version and publish them together, in which case you can use a single repository.

Observação

Embora o repositório GitHub para sua extensão precise ser público, você não precisa hospedar nenhum do seu código.While the GitHub repository for your extension needs to be public, you don't need to host any of your code there. Seguir esse processo não exige que você tenha qualquer um de seus códigos no GitHub.Following this process does not require you to have any of your code in GitHub.

Compartilhar o local do seu repositórioShare the location of your repository

Depois de configurar o repositório, envie um email para a lista de endereçamento de publicação de extensão com a URL.Once you've set up the repository, send an email to the extension publishing mailing list with the URL.

Liberar uma nova versãoRelease a new version

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.You'll use the "Create a new release" link on the main page of the repository to begin the process of updating your extension. Depois de selecionar esse link, siga estas etapas:Once you've selected that link, follow these steps:

  1. Adicione informações à versão de marca da versão no seguinte formatoAdd information to the tag version of the release in the following format

    <releaseVersion> - VSM v<targetVersion>v<releaseVersion>-vsm<targetVersion>

    Em que:Where:

    • < releaseVersion > é o número de versão da extensão<releaseVersion> is your extension version number
    • < targetVersion > é a versão mínima do Visual Studio para Mac sua extensão está direcionando<targetVersion> is the minimum version of Visual Studio for Mac your extension is targeting
  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.(Optional) The title and description fields can be filled with any information you'd like; this workflow doesn't use the information in those fields.

  3. Verifique se a caixa de seleção pré-lançamento está desmarcada.Ensure the pre-release checkbox is unchecked. Se estiver marcada, a versão não será selecionada por esse processo de publicação.If it's checked, the release will not be picked up by this publishing process.

  4. Anexe os arquivos . mPack que implementam sua extensão na seção de binários .Attach the .mpack file(s) that implement your extension in the binaries section. É possível anexar vários arquivos . mPack em uma versão.It's possible to attach multiple .mpack files in a release.

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.Visual Studio for Mac will display the latest version of your extension that is compatible with the Visual Studio for Mac installation that was used to access the extension repository.

Desde que você tenha registrado seu repositório 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.As long as you registered your GitHub repository with the Visual Studio for Mac team, your extension release will be picked up by Visual Studio for Mac within 24 hours.

Informações adicionaisAdditional information

  • As versões que não estão em conformidade com os requisitos detalhados acima não serão publicadas.Releases that don't conform to the requirements detailed above won't be published.
  • 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.After January 15, 2021, extension updates will only show up in Visual Studio for Mac 8.0 or newer.
  • As extensões existentes permanecerão disponíveis para Visual Studio para Mac usuários sem nenhuma ação de sua parte.Existing extensions will remain available to Visual Studio for Mac users without any action on your part. Você só precisa seguir as instruções neste guia se publicar uma nova versão após 15 de janeiro de 2021.You only need to follow the instructions in this guide if you publish a new version after January 15, 2021.