Przygotowywanie środowiska projektowego

Zacznijmy opracowywać rozszerzenia za pomocą zestawu WINDOWS Admin Center SDK! W tym dokumencie omówimy proces uruchamiania środowiska w celu skompilowania i przetestowania rozszerzenia dla centrum administracyjnego systemu Windows.

Aby przygotować środowisko programistyczne, wykonaj następujące kroki:

Instalowanie wymagań wstępnych

Aby rozpocząć programowanie przy użyciu zestawu SDK, pobierz i zainstaluj następujące wymagania wstępne:

• Windows Admin Center (wersja ogólnie dostępna lub wersja zapoznawcza)
• Visual Studio lub Visual Studio Code
• Node.js wersja 24.18.1 (pobierz i zainstaluj wersję LTS)
• Node Menedżer pakietów (wersja 6.14.5 lub nowsza)
• NuGet (w przypadku rozszerzeń publikowania)
• Git dla Windows (zawiera OpenSSL do generowania certyfikatów podpisanych samodzielnie)

Aby pominąć walidację podpisu, która występuje podczas instalacji rozszerzenia w wersjach programu Windows Admin Center uruchomionych przy użyciu platformy .NET 8, należy również przełączyć tryb operacji Centrum administracyjnego systemu Windows na "Programowanie". Aby skonfigurować tryb programowania, musisz:

• Otwórz plik appsettings.json instancji Windows Admin Center. Można to znaleźć domyślnie w C:\Program Files\WindowsAdminCenter\service\appsettings.json.
• Zmodyfikuj pole OperationMode w sekcji WindowsAdminCenter/System, tak aby brzmiało "Rozwój" zamiast "Produkcja".

Instalowanie zależności globalnych

Następnie zainstaluj lub zaktualizuj zależności wymagane dla swoich projektów, korzystając z Node Menedżer pakietów. Instaluj te zależności globalnie, aby wszystkie projekty miały do nich dostęp.

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

Przygotuj środowisko do sideloadu

Po utworzeniu rozszerzenia warto zainstalować je w Windows Admin Center do testowania. Aby to zrobić, wykonaj następujące jednorazowe kroki dla katalogu programistycznego swojego rozszerzenia:

1. Otwórz PowerShell jako administrator i stwórz katalog certyfikatów:

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

2. Wygeneruj certyfikat podpisany samodzielnie, korzystając z OpenSSL 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. Zaimportuj nowy certyfikat do swojego Trusted Root:

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

4. Otwórz C:\Program Files\WindowsAdminCenter\Service\appsettings.json w Visual Studio Code jako administrator.
5. Znajdź tablicę corsSites i dodaj adres URL do ładowania bocznego (domyślnie jest używany port 4200).

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

6. Znajdź tablicę CSPFrameAncestors i dodaj adres URL do ładowania bocznego (port 4200 jest domyślny).

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

7. Zapisz plik, a następnie zrestartuj usługę Windows Admin Center w oknie PowerShell administratora, uruchamiając:

     Restart-Service WindowsAdminCenter
   

Sideload z użyciem w pełni kwalifikowanej nazwy domeny

Aby załadować lokalnie rozszerzenie Windows Admin Center za pomocą adresu URL zawierającego w pełni kwalifikowaną nazwę domenową (FQDN) tego komputera, wykonaj następujące dodatkowe kroki konfiguracyjne:

1. Użyj OpenSSL z Git, aby wygenerować certyfikat z podpisem własnym, który zawiera alternatywne nazwy podmiotu zarówno dla localhost, jak i dla nazwy 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. Zaimportuj nowy certyfikat do swojego Trusted Root:

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

3. Zaktualizuj C:\Program Files\WindowsAdminCenter\Service\appsettings.json, tak aby uwzględniał adresy URL ze źródłem FQDN:

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

4. Zapisz plik, a następnie zrestartuj usługę Windows Admin Center w oknie PowerShell administratora, uruchamiając:

     Restart-Service WindowsAdminCenter
   

Dalsze kroki

Teraz, po przygotowaniu środowiska, możesz rozpocząć tworzenie zawartości.

• Stwórz rozszerzenie narzędzia
• Tworzenie rozszerzenia rozwiązania
• Utwórz wtyczkę bramy
• Dowiedz się więcej z naszymi przewodnikami

Zestaw narzędzi do projektowania zestawu SDK

Zapoznaj się z naszym zestawem narzędzi SDK Windows Admin Center ! Ten zestaw narzędzi ułatwia szybkie projektowanie rozszerzeń w programie PowerPoint przy użyciu stylów, kontrolek i szablonów stron Windows Admin Center. Zobacz, jak twoje rozszerzenie może wyglądać w Centrum administracyjnym systemu Windows przed rozpoczęciem kodowania!