Förbereda utvecklingsmiljön

Nu ska vi börja utveckla tillägg med Windows Admin Center SDK! I det här dokumentet går vi igenom processen för att få igång din miljö för att skapa och testa ett tillägg för Windows Admin Center.

Utför följande steg för att förbereda utvecklingsmiljön:

Installera förutsättningar

Om du vill börja utveckla med SDK:et laddar du ned och installerar följande krav:

• Windows Admin Center (GA eller förhandsversion)
• Visual Studio eller Visual Studio Code
• Node.js version 24.18.1 (ladda ner och installera LTS-versionen)
• Node Správca balíkov (6.14.5 eller senare)
• NuGet (för publiceringstillägg)
• Git för Windows (inkluderar OpenSSL för att generera självsignerade certifikat)

Om du vill kringgå signaturverifiering som inträffar under tilläggsinstallationen i Windows Admin Center-versioner som körs med .NET 8, bör du även växla åtgärdsläget för Windows Admin Center till "Utveckling". För att konfigurera utvecklingsläge måste du:

• Öppna Windows Admin Center-instansens appsettings.json-fil. Detta finns som standard på C:\Program Files\WindowsAdminCenter\service\appsettings.json.
• Ändra fältet OperationMode under avsnittet WindowsAdminCenter/System för att läsa "Utveckling" i stället för "Produktion".

Installera globala beroenden

Installera eller uppdatera sedan beroenden som krävs för dina projekt genom att använda Node Správca balíkov. Installera dessa beroenden globalt så att alla projekt kan komma åt dem.

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

Förbered din miljö för sideloading

Efter att du har skapat ditt tillägg vill du sideloada det i Windows Admin Center för testning. För att göra det, genomför följande steg som bara behöver göras en gång för katalogen för tilläggsutveckling:

1. Öppna PowerShell som administratör och skapa en certifikatkatalog:

   New-Item -ItemType Directory -Path "C:<path>\certificate"
   

2. Generera ett självsignerat certifikat genom att använda Gits OpenSSL:

   & "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. Importera det nya certifikatet till din Trusted Root:

    Import-Certificate -FilePath "C:\<path-to-extension-directory>\certificate\localhost.cert" -CertStoreLocation "Cert:\LocalMachine\Root"
   

4. Öppna C:\Program Files\WindowsAdminCenter\Service\appsettings.json i Visual Studio Code som administratör.
5. Hitta arrayen corsSites och lägg till sideloading-URL:en (port 4200 är standard).

    "CorsSites": [
      "https://localhost:4200"
    ]
   

6. Hitta arrayen CSPFrameAncestors och lägg till sideloading-URL:en (port 4200 är standard).

    "CSPFrameAncestors": [
      "'self'",
      ... existing entries ...
      "https://localhost:4200"
    ]
   

7. Spara filen och starta sedan om Windows Admin Center-tjänsten i ditt administratörsfönster PowerShell genom att köra:

     Restart-Service WindowsAdminCenter
   

Sideloading genom att använda fullt kvalificerat domännamn

För att installera ditt tillägg för Windows Admin Center från en URL som innehåller datorns fullständigt kvalificerade domännamn (FQDN) följer du dessa ytterligare konfigurationssteg:

1. Använd Gits OpenSSL för att generera ett självsignerat certifikat som innehåller subjektalternativa namn för både localhost och 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. Importera det nya certifikatet till din Trusted Root:

    Import-Certificate -FilePath "C:\<path-to-extension-directory>\certificate\localhost.cert" -CertStoreLocation "Cert:\LocalMachine\Root"
   

3. Uppdatera C:\Program Files\WindowsAdminCenter\Service\appsettings.json för att inkludera URL:er med FQDN-ursprung:

    "CorsSites": [
      "https://localhost:4200",
      "https://<FQDN>:4200"
    ],
    "CSPFrameAncestors": [
      "'self'",
      ... existing entries ...
      "https://localhost:4200",
      "https://<FQDN>:4200"
    ]
   

4. Spara filen och starta sedan om Windows Admin Center-tjänsten i ditt administratörsfönster PowerShell genom att köra:

     Restart-Service WindowsAdminCenter
   

Nästa steg

Nu när din miljö har förberetts är du redo att börja skapa innehåll.

• Skapa ett verktygstillägg
• Skapa ett lösningstillägg
• Skapa ett gateway-plugin-program
• Läs mer med våra guider

SDK-designverktyg

Kolla in vår Windows Admin Center SDK design toolkit! Den här verktygslådan är utformad för att hjälpa dig att snabbt modellera tillägg i PowerPoint med format, kontroller och sidmallar i Windows Administrationscenter. Se hur tillägget kan se ut i Administrationscenter för Windows innan du börjar koda!