Preparare l'ambiente di sviluppo

  • Si applica a: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Iniziamo a sviluppare estensioni con Windows Admin Center SDK. In questo documento verrà illustrato il processo per rendere operativo l'ambiente usato per compilare e testare un'estensione per Windows Admin Center.

Note

Se non si ha familiarità con Windows Admin Center SDK, vedere Estensioni per Windows Admin Center per altre informazioni.

Tip

Crea una cartella per memorizzare tutti i tuoi file di sviluppo delle estensioni Windows Admin Center per ridurre l'esecuzione dei comandi.

Per preparare l'ambiente di sviluppo, eseguire la procedura seguente:

Installare i prerequisiti

Per iniziare a sviluppare con l'SDK, scaricare e installare i prerequisiti seguenti:

Per ignorare la convalida della firma che si verifica durante l'installazione dell'estensione nelle versioni di Windows Admin Center in esecuzione con .NET 8, devi anche impostare la modalità operativa di Windows Admin Center su "Sviluppo". Per configurare la modalità di sviluppo, è necessario:

  • Apri il file di appsettings.json dell'istanza di Windows Admin Center. Questo è possibile trovare per impostazione predefinita a C:\Program Files\WindowsAdminCenter\service\appsettings.json.
  • Modificare il campo OperationMode nella sezione WindowsAdminCenter/System per leggere "Sviluppo" anziché "Produzione".

Installare le dipendenze globali

Successivamente, installa o aggiorna le dipendenze richieste per i tuoi progetti utilizzando Node Gestione pacchetti. Installa queste dipendenze a livello globale così tutti i progetti possono accedervi.

npm install -g @angular/cli@20.3.25

npm install -g gulp
npm install -g typescript
npm install -g eslint
npm install -g @microsoft/windows-admin-center-sdk@latest

Note

Puoi installare una versione successiva di @angular/cli. Tuttavia, se installi una versione superiore a 20.3.25, vedrai un avviso durante il passaggio di build gulp che la versione locale della CLI non corrisponde a quella installata.

Prepara l'ambiente per il caricamento laterale

Dopo aver creato la tua estensione, vuoi installarla manualmente nel Windows Admin Center per test. Per farlo, esegui i seguenti passaggi preliminari da eseguire una sola volta nella directory di sviluppo della tua estensione:

  1. Apri PowerShell come amministratore e crea una directory di certificati: 
    New-Item -ItemType Directory -Path "C:<path>\certificate"
  2. Genera un certificato autofirmato usando OpenSSL di Git: 
    & "C:\Program Files\Git\usr\bin\openssl.exe" req -x509 -newkey rsa:2048 -nodes -keyout C:\<path-to-extension-directory>\certificate\localhost.key -out C:\<path-to-extension-directory>\certificate\localhost.cert -days 365 -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost"
  3. Importa il nuovo certificato nella tua Trusted Root: 
     Import-Certificate -FilePath "C:\<path-to-extension-directory>\certificate\localhost.cert" -CertStoreLocation "Cert:\LocalMachine\Root"
  4. Apri C:\Program Files\WindowsAdminCenter\Service\appsettings.json in Visual Studio Code come amministratore.
  5. Trova l'array corsSites e aggiungi l'URL di sideloading (la porta 4200 è la predefinita). 
     "CorsSites": [
   "https://localhost:4200"
 ]
  6. Trova l'array CSPFrameAncestors e aggiungi l'URL di sideloading (la porta 4200 è la predefinita). 
     "CSPFrameAncestors": [
   "'self'",
   ... existing entries ...
   "https://localhost:4200"
 ]
  7. Salva il file, poi riavvia il servizio Windows Admin Center nella finestra PowerShell della tua amministrazione eseguendo:
      Restart-Service WindowsAdminCenter

Importante

Queste istruzioni fanno riferimento a certificati autofirmati per sviluppo e test. Non usare certificati autofirmati sulle macchine di produzione per i carichi di lavoro di produzione.

Sideloading utilizzando un nome di dominio completamente qualificato

Per eseguire il sideload di un'estensione di Windows Admin Center tramite un URL che include il nome di dominio completo (FQDN) del computer, segui questi passaggi di configurazione aggiuntivi:

  1. Usa OpenSSL di Git per generare un certificato autofirmato che contenga nomi alternativi del soggetto sia per localhost sia per il FQDN: 
    & "C:\Program Files\Git\usr\bin\openssl.exe" req -x509 -newkey rsa:2048 -nodes -keyout C:\<path-to-extension-directory>\certificate\localhost.key -out C:\<path-to-extension-directory>\certificate\localhost.cert -days 365 -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost,DNS:<FQDN>"
  2. Importa il nuovo certificato nella tua Trusted Root: 
     Import-Certificate -FilePath "C:\<path-to-extension-directory>\certificate\localhost.cert" -CertStoreLocation "Cert:\LocalMachine\Root"
  3. Aggiornamento C:\Program Files\WindowsAdminCenter\Service\appsettings.json per includere URL con origine FQDN: 
     "CorsSites": [
   "https://localhost:4200",
   "https://<FQDN>:4200"
 ],
 "CSPFrameAncestors": [
   "'self'",
   ... existing entries ...
   "https://localhost:4200",
   "https://<FQDN>:4200"
 ]
  4. Salva il file, poi riavvia il servizio Windows Admin Center nella finestra PowerShell della tua amministrazione eseguendo:
      Restart-Service WindowsAdminCenter

Passaggi successivi

Dopo aver preparato l'ambiente, è possibile iniziare a creare contenuti.

Toolkit di progettazione dell'SDK

Vedere il toolkit di progettazione dell'SDK di Windows Admin Center. Questo toolkit è progettato per poter simulare rapidamente le estensioni in PowerPoint usando stili, controlli e modelli di pagina di Windows Admin Center. Vedere come può apparire la propria estensione in Windows Admin Center prima di iniziare a scrivere il codice.

  • Last updated on