Esercizio - Configurare il file package.json

Completato

Si supponga di essere uno sviluppatore che usa Node.js presso la società Tailwind Traders. Sapere come configurare un nuovo progetto Node.js è una competenza importante. Il programma di installazione include la generazione di un package.json file e la creazione di alcuni script comuni da usare per tutto il ciclo di vita del progetto.

Aprire il progetto nel contenitore di sviluppo

È stato fornito un ambiente di sviluppo semplice. Se nel computer è già installato Node.js LTS, è possibile ignorare questa sezione e clonare il repository di esempio e usare l'ambiente locale.

Sviluppo remoto (browser)

1. Avviare il processo per creare un nuovo codespace GitHub nel ramo main del repository GitHub MicrosoftDocs/node-essentials.

   Aprire questo progetto in GitHub Codespaces

2. Nella pagina Crea codespace esaminare le impostazioni di configurazione del codespace e quindi selezionare Crea nuovo codespace

   

3. Attendere l'avvio del codespace. Questo processo di avvio può richiedere alcuni minuti.

4. Aprire un nuovo terminale nel codespace.

   Suggerimento

   È possibile usare il menu principale per passare all'opzione di menu Terminale e quindi selezionare l'opzione Nuovo terminale.

   

5. Verificare che Node.js sia installato nell'ambiente:

   node --version
   

   Il contenitore di sviluppo usa una versione Node.js LTS, ad esempio v20.5.1. La versione esatta potrebbe essere diversa.

6. Gli esercizi rimanenti in questo progetto si svolgono nel contesto di questo contenitore di sviluppo.

Sviluppo locale (Docker)

1. Aprire Visual Studio Code nel contesto di una directory vuota.

2. Assicurarsi che l'estensione Dev Containers sia installata in Visual Studio Code.

3. Aprire un nuovo terminale nell'editor.

   Suggerimento

   È possibile usare il menu principale per passare all'opzione di menu Terminale e quindi selezionare l'opzione Nuovo terminale.

   

4. Clonare il repository GitHub MicrosoftDocs/node-essentials nella directory corrente.

   git clone https://github.com/MicrosoftDocs/node-essentials.git
   

5. Aprire il repository nel codice con i comandi seguenti nel terminale.

   cd node-essentials
   code .
   

6. Aprire il riquadro comandi, cercare i comandi Dev Containers e quindi selezionare Dev Containers: Reopen in Container (Dev Containers: Riapri nel contenitore).

   Suggerimento

   Visual Studio Code potrebbe richiedere automaticamente di riaprire la cartella esistente all'interno di un contenitore di sviluppo. Questa funzionalità equivale a usare il riquadro comandi per riaprire l'area di lavoro corrente in un contenitore.

   

7. Verificare che Node.js sia installato nell'ambiente:

   node --version
   

   Il contenitore di sviluppo usa una versione Node.js LTS, ad esempio v20.5.1. La versione esatta potrebbe essere diversa.

8. Gli esercizi rimanenti in questo progetto si svolgono nel contesto di questo contenitore di sviluppo.

Configurare un nuovo progetto Node.js

Per questa unità è stato fornito il codice sorgente JavaScript. Il processo consiste nel creare il package.json file.

1. Nel terminale passare alla cartella per questo esercizio:

   cd node-dependencies/3-exercise-package-json
   

2. Visualizzare il contenuto della cartella:

   ls -R
   

   In questa cartella dovrebbe essere visualizzata una sottocartella src contenente un file diindex.js:

    ./src:
        index.js
   

3. Eseguire il comando seguente per creare il package.json file con valori predefiniti:

   npm init -y
   

   Il file package.json simile a questo esempio:

   {
     "name": "3-exercise-package-json",
     "version": "1.0.0",
     "description": "",
     "main": "index.js",
     "scripts": {
       "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [],
     "author": "",
     "license": "ISC"
   }
   

4. Modificare con questi valori di package.json proprietà:

   • name: "tailwind-trader-api"
   • description: "HTTP API to manage items from the Tailwind Traders database"
   • main: "index.js"
   • keywords: ["API", "database"]
   • author: "Sam"

   Il file package.json dovrebbe ora essere simile a questo codice:

   {
     "name": "tailwind-trader-api",
     "version": "1.0.0",
     "description": "HTTP API to manage items from the Tailwind Traders database",
     "main": "index.js",
     "dependencies": {},
     "devDependencies": {},
     "scripts": {
       "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": ["api", "database"],
     "author": "Sam",
     "license": "ISC"
   }
   

5. scripts Nella sezione aggiungere un nuovo script denominato start sopra lo test script:

   "start": "node ./src/index.js",
   

6. Salvare le modifiche e chiudere il file package.json.

7. Avviare il progetto con l'azione start immettendo questo comando:

   npm start
   

   Dovrebbe essere visualizzato questo output:

   Welcome to this application
   

È ora disponibile un file valido package.json su cui è possibile eseguire la compilazione man mano che il progetto cresce.