2022-05-17 15:58:52 +00:00
# Estensione di VSCode per i corsi
2022-05-13 15:33:16 +00:00
2022-05-17 15:58:52 +00:00
Questo dettaglia le linee guida della manutenzione del repo [freeCodeCamp/courses-vscode-extension ](https://github.com/freeCodeCamp/courses-vscode-extension ) che contiene il codice sorgente per l'estensione [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
## Pubblicazione dell'estensione
2022-05-13 15:33:16 +00:00
2022-06-29 12:29:05 +00:00
Una GitHub Action pubblica automagicamente l'estensione nel Visual Studio Marketplace, al rilascio di un nuovo GitHub Release.
2022-05-13 15:33:16 +00:00
2022-06-29 12:29:05 +00:00
1. Impacchetta una nuova versione dell'estensione:
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-29 12:29:05 +00:00
Dove `<tag_type>` è uno dei seguenti: `major` , `minor` , `patch` .
2022-05-13 15:33:16 +00:00
2022-06-29 12:29:05 +00:00
2. Fai il push della nuova versione a `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-29 12:29:05 +00:00
Facoltativamente, puoi fare il push direttamente a `upstream/main` , ma aprire una PR è raccomandato per un sanity check.
2022-05-13 15:33:16 +00:00
2022-06-29 12:29:05 +00:00
3. Crea una nuova GitHub Release usando la GitHub UI:
2022-05-13 15:33:16 +00:00
2022-06-29 12:29:05 +00:00
- Implementa correttamente il numero di versione, quando crei una nuova tag.
2022-06-30 15:22:34 +00:00
- Fai l'upload del file `.vsix` con la nuova release.
- Pubblica la release, e conferma che l'azione ha avuto successo.
2022-05-13 15:33:16 +00:00
2022-06-30 15:22:34 +00:00
> [!NOTE] Creare una release richiede permessi di scrittura sul repository `freeCodeCamp/courses-vscode-extension`.
2022-05-13 15:33:16 +00:00
2022-05-17 15:58:52 +00:00
## Pubblicare l'estensione manualmente
2022-05-13 15:33:16 +00:00
2022-06-30 15:22:34 +00:00
Un upload manuale al Visual Studio Marketplace può essere fatto, seguendo questi step:
2022-05-13 15:33:16 +00:00
2022-06-30 15:22:34 +00:00
1. Visita https://marketplace.visualstudio.com/ e fai log in
2. Naviga alla [pagina freeCodeCamp Publisher ](https://marketplace.visualstudio.com/manage/publishers/freecodecamp )
3. Seleziona l'estensione rilevante, e seleziona `Update`
4. Carica il file dai tuoi file locali