Udostępnij za pośrednictwem

Publikowanie rozszerzeń

  • Dotyczy: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Po utworzeniu rozszerzenia należy opublikować je i udostępnić innym osobom do testowania lub używania. W tym artykule przedstawiono kilka opcji publikowania wraz z krokami i wymaganiami w zależności od odbiorców i celu publikowania.

Opcje publikowania

Istnieją trzy podstawowe opcje konfigurowalnych źródeł pakietów, które obsługuje Centrum administracyjne systemu Windows:

  • Kanał NuGet Centrum Administracyjnego Windows firmy Microsoft
  • Własne prywatne źródło danych NuGet
  • Lokalny lub sieciowy zasób plików

Publikowanie w kanale rozszerzeń Windows Admin Center

Domyślnie centrum administracyjne systemu Windows jest połączone ze źródłem danych NuGet obsługiwanym przez zespół produktu Windows Admin Center w firmie Microsoft. Wczesne wersje zapoznawcze nowych rozszerzeń opracowanych przez firmę Microsoft mogą być publikowane w tym kanale informacyjnym i udostępniane użytkownikom programu Windows Admin Center. Zewnętrzni deweloperzy planujący publiczne kompilowanie i wydawanie rozszerzeń mogą również przesłać żądanie opublikowania rozszerzenia do kanału informacyjnego centrum administracyjnego systemu Windows. Przed opublikowaniem w tym kanale deweloperzy zewnętrzni muszą zgodzić się na Umowę wydawcy rozszerzeń i Zasady uczestnictwa rozszerzeń w Centrum administracyjnym systemu Windows.

Publikowanie w innym kanale informacyjnym NuGet

Możesz również utworzyć własne źródło danych NuGet, aby opublikować rozszerzenia w celu użycia jednej z wielu różnych opcji konfigurowania źródła prywatnego lub korzystania z usługi hostingu NuGet. Źródło danych NuGet musi obsługiwać interfejs API NuGet w wersji 2. Ponieważ centrum administracyjne systemu Windows nie obsługuje obecnie uwierzytelniania kanału informacyjnego, kanał informacyjny musi być skonfigurowany tak, aby zezwalał na dostęp do odczytu wszystkim osobom.

Publikowanie w udziale plików

Aby ograniczyć dostęp do rozszerzenia do organizacji lub ograniczonej grupy osób, możesz użyć udziału plików SMB jako źródła danych rozszerzeń. Podczas hostowania kanału rozszerzeń przy użyciu udziału plików są stosowane uprawnienia do zarządzania dostępem do kanału.

Przygotowywanie rozszerzenia do wydania

Pamiętaj, aby przeczytać i wziąć pod uwagę następujące artykuły dotyczące rozwoju:

Rozważ wydanie wersji zapoznawczej

Jeśli udostępniasz wersję zapoznawcza rozszerzenia do celów ewaluacyjnych, zalecamy:

  • Dołącz ciąg "(wersja zapoznawcza)" na końcu tytułu rozszerzenia w .nuspec pliku
  • Wyjaśnij ograniczenia w opisie rozszerzenia w pliku .nuspec

Tworzenie pakietu rozszerzenia

Usługa Windows Admin Center korzysta z pakietów NuGet i kanałów informacyjnych do dystrybucji i pobierania rozszerzeń. Aby pakiet został wysłany, należy wygenerować pakiet NuGet zawierający wtyczki i rozszerzenia. Pojedynczy pakiet może zawierać rozszerzenie UI i plugin Gateway. W poniższej sekcji przedstawiono proces.

Kompilowanie rozszerzenia

Gdy tylko będziesz gotowy do rozpoczęcia pakowania rozszerzenia, utwórz nowy katalog w systemie plików, otwórz konsolę, a następnie wejdź do niego. Ten katalog jest katalogiem głównym, którego używamy do przechowywania wszystkich katalogów nuspec i zawartości tworzących nasz pakiet. Ten folder nazywamy pakietem NuGet w pozostałej części tego artykułu.

Rozszerzenia interfejsu użytkownika

Aby rozpocząć proces zbierania całej zawartości wymaganej dla rozszerzenia interfejsu użytkownika, uruchom polecenie "gulp build" w narzędziu i upewnij się, że kompilacja zakończyła się pomyślnie. Ten proces pakuje wszystkie składniki razem w folderze o nazwie "bundle" znajdującym się w katalogu głównym rozszerzenia (na tym samym poziomie katalogu src). Skopiuj ten katalog i całą jego zawartość do folderu "Pakiet NuGet".

Wtyczki dla bram sieciowych

Korzystając z infrastruktury kompilacji (co może być tak proste, jak otwarcie programu Visual Studio i wybranie przycisku Kompiluj), skompiluj i skompiluj wtyczkę. Otwórz katalog wyjściowy kompilacji, skopiuj bibliotekę DLL lub biblioteki DLL reprezentujące wtyczkę i umieść je w nowym folderze w katalogu "Pakiet NuGet" o nazwie "package". Nie musisz kopiować biblioteki DLL FeatureInterface. Kopiuj tylko te biblioteki DLL, które reprezentują Twój kod.

Tworzenie pliku nuspec

Aby utworzyć pakiet NuGet, należy najpierw utworzyć .nuspec plik. .nuspec Plik jest manifestem XML zawierającym metadane pakietu NuGet. Ten manifest służy zarówno do kompilowania pakietu, jak i do dostarczania informacji konsumentom. Umieść ten plik w katalogu głównym folderu "Pakiet NuGet".

Oto przykładowy .nuspec plik i lista wymaganych lub zalecanych właściwości. Pełny schemat można znaleźć w dokumentacji narzędzia nuspec. Zapisz plik do .nuspec folderu głównego projektu, używając wybranej nazwy pliku.

Ważne

<id> Wartość w .nuspec pliku musi być zgodna z wartością "name" w pliku projektu manifest.json lub w przeciwnym razie opublikowane rozszerzenie nie zostanie pomyślnie załadowane w Centrum administracyjnym systemu Windows.

<?xml version="1.0">
<package>
  <metadata>
    <id>contoso.project.extension</id>
    <version>1.0.0</version>
    <title>Contoso Hello Extension</title>
    <authors>Contoso</authors>
    <owners>Contoso</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.hello-extension</projectUrl>
    <licenseUrl>http://YourLicenseLink</licenseUrl>
    <iconUrl>http://YourLogoLink</iconUrl>
    <description>Hello World extension by Contoso</description>
    <copyright>(c) Contoso. All rights reserved.</copyright>
    <tags></tags>
  </metadata>
  <files>
    <file src="bundle\**\*.*" target="ux" />
    <file src="package\**\*.*" target="gateway" />
  </files>
</package>
Nazwa właściwości Wymagane/zalecane Opis
Identyfikator Wymagane Unikalny identyfikator pakietu w ramach kanału informacyjnego. Ta wartość musi być zgodna z wartością "name" w pliku manifest.json projektu. Aby uzyskać wskazówki, zobacz Wybieranie unikatowego identyfikatora pakietu .
tytuł Wymagane do publikowania w kanale informacyjnym centrum administracyjnego systemu Windows Przyjazna nazwa pakietu wyświetlanego w Menedżerze rozszerzeń programu Windows Admin Center.
wersja Wymagane Wersja rozszerzenia. Korzystanie z semantycznego przechowywania wersji (konwencja SemVer) jest zalecane, ale nie jest wymagane.
Autorzy Wymagane W przypadku publikowania w imieniu firmy użyj swojej nazwy firmy.
opis Wymagane Podaj opis funkcjonalności rozszerzenia.
iconUrl Zalecane podczas publikowania w kanale Centrum Administracyjnego systemu Windows Adres URL ikony do wyświetlenia w Menedżerze rozszerzeń.
URL projektu Wymagane do publikowania w kanale informacyjnym centrum administracyjnego systemu Windows Adres URL witryny internetowej rozszerzenia. Jeśli nie masz oddzielnej witryny internetowej, użyj adresu URL strony internetowej pakietu w kanale informacyjnym NuGet.
licenseUrl (adres URL licencji) Wymagane do publikowania w kanale informacyjnym centrum administracyjnego systemu Windows Adres URL umowy licencyjnej dla użytkownika końcowego rozszerzenia.
Pliki Wymagane Te dwa ustawienia konfigurują strukturę folderów, której oczekuje program Windows Admin Center dla rozszerzeń interfejsu użytkownika i wtyczek bramy.

Uwaga

Od wersji Windows Admin Center 2410 packageType pole jest przestarzałe i nie powinno być używane. Dalsze użycie tego pola może spowodować nieprawidłowe odczytanie pliku NuGet.

Kompilowanie rozszerzenia pakietu NuGet

Korzystając z utworzonego .nuspec pliku, musisz teraz utworzyć plik pakietu .nupkg NuGet, który możesz przesłać i opublikować w repozytorium NuGet.

  1. Pobierz narzędzie CLI nuget.exe ze strony NuGet Client Tools.
  2. Uruchom polecenie nuget.exe pack <>.nuspec file name> , aby utworzyć .nupkg plik.

Podpisz pakiet NuGet swojego rozszerzenia

Wszystkie .dll pliki zawarte w rozszerzeniu muszą być podpisane przy użyciu certyfikatu z zaufanego autorytetu certyfikacyjnego. Domyślnie niepodpisane pliki .dll są blokowane przed uruchomieniem, gdy Centrum Administracyjne systemu Windows działa w trybie produkcyjnym.

Wszystkie pliki javascript zawarte w rozszerzeniu muszą być podpisane przy użyciu certyfikatu z zaufanego urzędu certyfikacji.

Pakiet NuGet rozszerzenia musi być również podpisany, aby zapewnić integralność pakietu. Windows Admin Center używa serwera Kestrel, który ładuje certyfikaty TLS/SSL według nazwy podmiotowej certyfikatu. Upewnij się, że tylko jeden certyfikat jest zainstalowany z unikatową nazwą podmiotu i że certyfikat jest prawidłowy.

Po opublikowaniu rozszerzenia w kanale rozszerzeń Windows Admin Center firmy Microsoft, firma Microsoft doda swój podpis oprócz Twojego podpisu.

Wskazówka

Aby sprawdzić, czy pakiet jest poprawnie podpisany, możesz użyć następującego polecenia:

nuget.exe verify -All <packageName>.nuget

Testowanie pakietu NuGet rozszerzenia

Pakiet rozszerzenia jest teraz gotowy do testowania. Przekaż plik do kanału NuGet lub skopiuj go do folderu udostępnionego. Aby wyświetlić i pobrać pakiety z innego kanału lub zasobu plików, należy zmienić konfigurację kanału, aby ustawić go na swój kanał NuGet lub zasób plików. Podczas testowania upewnij się, że właściwości są poprawnie wyświetlane w Menedżerze rozszerzeń i możesz pomyślnie zainstalować i odinstalować rozszerzenie.

Opublikuj swoje rozszerzenie w kanale Windows Admin Center

Publikując w kanale informacyjnym centrum administracyjnego systemu Windows, możesz udostępnić rozszerzenie dowolnemu użytkownikowi centrum administracyjnego systemu Windows. Ponieważ zestaw WINDOWS Admin Center SDK jest nadal w wersji zapoznawczej, chcemy ściśle współpracować z Tobą, aby pomóc w rozwiązywaniu problemów programistycznych i ułatwić dostarczanie użytkownikom jakości produktu i środowiska.

Przed złożeniem wniosku o przegląd rozszerzenia do firmy Microsoft, należy wysłać wiadomość e-mail do wacextensionrequest@microsoft.com z zamiarem opublikowania rozszerzenia w publicznym kanale. Zapewniamy kopie umowy wydawcy rozszerzeń oraz polityki uczestnictwa rozszerzeń do przeglądu i zaznaczenia na piśmie.

Przed wydaniem początkowej wersji rozszerzenia zalecamy przesłanie żądania przeglądu rozszerzenia do firmy Microsoft co najmniej 2–3 tygodnie przed wydaniem. Zapewnienie 2–3 tygodni przed wydaniem zapewnia wystarczająco dużo czasu na dokonanie przeglądu i w razie potrzeby wprowadzenie zmian w rozszerzeniu. Gdy rozszerzenie będzie gotowe do opublikowania, musisz wysłać je do nas w celu przejrzenia. Jeśli Twoje rozszerzenie zostanie zatwierdzone, opublikujemy je w kanale. Wysyłając pakiet rozszerzenia firmy Microsoft, wyrażasz zgodę na powiązanie z warunkami umowy wydawcy rozszerzeń i zasadami uczestnictwa rozszerzeń.

Następnie, jeśli chcesz opublikować aktualizację rozszerzenia, musisz przesłać kolejne żądanie do przeglądu. W zależności od zakresu zmian czasy realizacji przeglądów aktualizacji są zazwyczaj krótsze.

Przesyłanie żądania przeglądu rozszerzenia do firmy Microsoft

Aby przesłać żądanie przeglądu rozszerzenia, podaj następujące informacje i wyślij jako wiadomość e-mail na wacextensionrequest@microsoft.comadres . Odpowiadamy na Twoją wiadomość e-mail w ciągu tygodnia.

Windows Admin Center — informacje o żądaniach przeglądu rozszerzenia:

  • Nazwa i adres e-mail właściciela/dewelopera rozszerzenia (do 3 użytkowników). Jeśli publikujesz rozszerzenie w imieniu firmy, podaj firmowy adres e-mail.
  • Nazwa firmy (wymagana tylko w przypadku wydania rozszerzenia w imieniu firmy)
  • Nazwa rozszerzenia
  • Data docelowa wydania (szacowanie)
  • W przypadku przesyłania nowego rozszerzenia — opis rozszerzenia (zaleca się wczesne szkice projektowe, makiety lub zrzuty ekranu)
  • Przegląd aktualizacji rozszerzenia — opis zmian (dołącz zrzuty ekranu produktu, jeśli interfejs użytkownika uległ znacznej zmianie)

Przesyłanie pakietu rozszerzenia do przeglądu i publikowania

Upewnij się, że postępuj zgodnie z poprzednimi instrukcjami dotyczącymi tworzenia pakietu rozszerzenia , a .nuspec plik jest poprawnie zdefiniowany, a pliki są podpisane. Zalecamy również posiadanie witryny internetowej projektu, w tym:

  • Szczegółowy opis rozszerzenia, w tym zrzuty ekranu lub wideo
  • Adres e-mail lub funkcja witryny internetowej w celu otrzymywania opinii lub pytań

Gdy będziesz gotowy do opublikowania rozszerzenia, wyślij wiadomość e-mail na adres wacextensionrequest@microsoft.com. Udostępniamy instrukcje dotyczące sposobu wysyłania pakietu rozszerzenia. Po otrzymaniu pakietu przejrzymy go. Po zatwierdzeniu pakietu rozszerzenia opublikujemy go w kanale informacyjnym centrum administracyjnego systemu Windows.