Uw ontwikkelomgeving voorbereiden

Laten we aan de slag gaan met het ontwikkelen van extensies met de Windows Admin Center SDK. In dit document behandelen we het proces om uw omgeving aan de slag te laten gaan om een extensie voor Windows-beheercentrum te bouwen en te testen.

Voer de volgende stappen uit om uw ontwikkelomgeving voor te bereiden:

Vereisten installeren

Als u wilt beginnen met ontwikkelen met de SDK, downloadt en installeert u de volgende vereisten:

• Windows Admin Center (GA- of preview-versie)
• Visual Studio of Visual Studio Code
• Node.js versie 24.18.1 (download en installeer de LTS-versie)
• Node Pakketbeheer (6.14.5 of hoger)
• NuGet (voor publicatie-extensies)
• Git voor Windows (bevat OpenSSL voor het genereren van zelfondertekende certificaten)

Als u de handtekeningvalidatie wilt omzeilen die optreedt tijdens de installatie van de extensie in Windows Admin Center-versies die worden uitgevoerd met .NET 8, moet u ook de bewerkingsmodus van het Windows-beheercentrum overschakelen naar 'Ontwikkeling'. Als u de ontwikkelingsmodus wilt configureren, moet u het volgende doen:

• Open het appsettings.json-bestand van het Windows Admin Center-exemplaar. Dit is standaard te vinden op C:\Program Files\WindowsAdminCenter\service\appsettings.json.
• Wijzig het OperationMode veld onder de sectie WindowsAdminCenter/System om 'Ontwikkeling' te lezen in plaats van 'Productie'.

Globale afhankelijkheden installeren

Installeer of update vervolgens afhankelijkheden die nodig zijn voor je projecten met behulp van Node Pakketbeheer. Installeer deze afhankelijkheden globaal zodat alle projecten er toegang toe hebben.

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

Bereid je omgeving voor op zijdelings laden

Nadat je je extensie hebt gemaakt, wil je die in Windows Admin Center sideloaden om te testen. Om dit te doen, voer je de volgende eenmalige stappen uit voor de ontwikkelmap van je extensie:

1. Open PowerShell als beheerder en maak een certificaatmap aan:

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

2. Genereer een zelfondertekend certificaat met behulp van Git's 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. Importeer het nieuwe certificaat in je Trusted Root:

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

4. Open C:\Program Files\WindowsAdminCenter\Service\appsettings.json in Visual Studio Code als administrator.
5. Zoek de corsSites array en voeg de sideloading URL toe (poort 4200 is de standaard).

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

6. Zoek de CSPFrameAncestors array en voeg de sideloading URL toe (poort 4200 is de standaard).

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

7. Sla het bestand op en start vervolgens de Windows Admin Center-service opnieuw in je beheerder PowerShell-venster door het volgende uit te voeren:

     Restart-Service WindowsAdminCenter
   

Sideloading door volledig gekwalificeerde domeinnaam te gebruiken

Om je Windows Admin Center-extensie via een URL te sideloaden die de volledig gekwalificeerde domeinnaam (FQDN) van je machine bevat, volg je deze extra configuratiestappen:

1. Gebruik Git's OpenSSL om een zelfondertekend certificaat te genereren dat onderwerpalternatieve namen bevat voor zowel localhost als de 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. Importeer het nieuwe certificaat in je Trusted Root:

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

3. Update C:\Program Files\WindowsAdminCenter\Service\appsettings.json om URL's met de FQDN-oorsprong op te nemen:

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

4. Sla het bestand op en start vervolgens de Windows Admin Center-service opnieuw in je beheerder PowerShell-venster door het volgende uit te voeren:

     Restart-Service WindowsAdminCenter
   

Volgende stappen

Nu uw omgeving is voorbereid, kunt u beginnen met het maken van inhoud.

• Een hulpprogramma-extensie maken
• Een oplossingsextensie maken
• Een gateway-plug-in maken
• Meer informatie met onze handleidingen

SDK-ontwerptoolkit

Bekijk onze Ontwerptoolkit voor Windows Admin Center SDK. Deze toolkit is ontworpen om u te helpen snel extensies in PowerPoint te maken met behulp van Stijlen, besturingselementen en paginasjablonen in Het Windows-beheercentrum. Bekijk hoe uw extensie eruit kan zien in het Windows-beheercentrum voordat u begint met coderen.