2022-05-17 15:58:52 +00:00
# Extensão do VSCode Courses
2022-05-13 15:33:16 +00:00
2022-05-17 15:58:52 +00:00
Aqui detalharemos as diretrizes de manutenção para o [freeCodeCamp/courses-vscode-extension ](https://github.com/freeCodeCamp/courses-vscode-extension ) repositório que contém o código-fonte para a extensão [freeCodeCamp - Courses ](https://marketplace.visualstudio.com/items?itemName=freeCodeCamp.freecodecamp-courses ).
2022-05-13 15:33:16 +00:00
2022-05-17 15:58:52 +00:00
## Publicando a extensão
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
Uma GitHub Action publica automaticamente a extensão no Visual Studio Marketplace, no lançamento de uma nova GitHub Release.
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
1. Pacote de uma nova versão da extensão:
2022-05-13 15:33:16 +00:00
```bash
2022-06-21 14:21:39 +00:00
npm run pack -- < tag_type >
2022-05-13 15:33:16 +00:00
```
2022-06-22 12:52:48 +00:00
Onde `<tag_type>` é: `major` , `minor` ou `patch` .
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
2. Faça o push da nova versão para `main` :
2022-05-13 15:33:16 +00:00
```bash
2022-06-21 14:21:39 +00:00
git commit -am "< tag_type > (< version > ): < description > "
git push
2022-05-13 15:33:16 +00:00
```
2022-06-22 12:52:48 +00:00
Como opção, você pode fazer o push diretamente para `upstream/main` , mas abrir um novo PR é recomendado para fins de verificação de sanidade.
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
3. Crie uma GitHub Release usando a UI do GitHub:
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
- Incremente corretamente o número da versão ao criar uma nova tag.
- Faça o upload do arquivo `.vsix` com a release.
- Publique a release e confirme que a action foi um sucesso.
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
> [!NOTE] Criar uma release exige acesso de escrita ao repositório `freeCodeCamp/courses-vscode-extension`.
2022-05-13 15:33:16 +00:00
2022-05-17 15:58:52 +00:00
## Publicando a extensão manualmente
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
Um upload manual para o Visual Studio Marketplace pode ser feito seguindo estes passos:
2022-05-13 15:33:16 +00:00
2022-06-22 12:52:48 +00:00
1. Visite https://marketplace.visualstudio.com/ e faça login
2. Navegue até a [página do editor do freeCodeCamp ](https://marketplace.visualstudio.com/manage/publishers/freecodecamp )
3. Selecione a extensão relevante e selecione `Update`
4. Faça o upload do arquivo a partir de seus arquivos locais