Tillägg för publicering

När du har utvecklat tillägget vill du publicera det och göra det tillgängligt för andra att testa eller använda. I den här artikeln introducerar vi några publiceringsalternativ tillsammans med stegen och kraven beroende på målgruppen och syftet med publiceringen.

Publiceringsalternativ

Det finns tre primära alternativ för konfigurerbara paketkällor som stöds av Windows Admin Center:

• NuGet-feed för Microsofts offentliga Windows Admin Center
• Din egen privata NuGet-feed
• Lokal delning eller nätverksdelning

Publicera till Windows Admin Center-tilläggsflödet

Som standard är Windows Administrationscenter anslutet till en NuGet-feed som underhålls av Windows Admin Center-produktteamet på Microsoft. Tidiga förhandsversioner av nya tillägg som utvecklats av Microsoft kan publiceras i det här flödet och göras tillgängliga för Windows Admin Center-användare. Externa utvecklare som planerar att skapa och släppa tillägg offentligt kan också skicka en begäran till Publicera tillägget till Windows Admin Center-feeden. Innan du publicerar det här flödet måste externa utvecklare godkänna Windows Admin Centers Extension Publisher Agreement och Extension Participation Policy.

Publicera till en annan NuGet-feed

Du kan också skapa en egen NuGet-feed för att publicera dina tillägg till med någon av de många olika alternativen för att konfigurera en privat källa eller använda en NuGet-värdtjänst. NuGet-feeden måste ha stöd för NuGet v2-API:et. Eftersom Windows Admin Center för närvarande inte stöder feedautentisering måste flödet konfigureras för att tillåta läsåtkomst till vem som helst.

Publicera till en filresurs

Om du vill begränsa åtkomsten till ditt tillägg till din organisation eller till en begränsad grupp personer kan du använda en SMB-fildelning som ett tilläggsflöde. När du använder en filresurs som värd för ditt tilläggsflöde tillämpas fil- och mappbehörigheter för att hantera åtkomst till feeden.

Förberedelser för tillägget inför lanseringen

Se till att du läser och överväger följande utvecklingsartiklar:

• Kontrollera verktygets synlighet
• strängar och lokalisering

Överväg att släppa som en förhandsversion

Om du släpper en förhandsversion av tillägget i utvärderingssyfte rekommenderar vi att du:

• Lägg till (förhandsversion) i slutet av tilläggets rubrik i filen .nuspec
• Förklara begränsningarna i tilläggets beskrivning i filen .nuspec

Skapa ett tilläggspaket

Windows Admin Center använder NuGet-paket och -feeds för att distribuera och ladda ned tillägg. För att paketet ska levereras måste du generera ett NuGet-paket som innehåller dina plugin-program och tillägg. Ett enda paket kan innehålla ett gränssnittstillägg och ett Gateway-plugin-program. I följande avsnitt går vi igenom processen.

Skapa ditt tillägg

Så snart du är redo att börja paketera tillägget skapar du en ny katalog i filsystemet, öppnar en konsol och sedan CD i den. Den här katalogen är den rotkatalog som vi använder för att innehålla alla nuspec- och innehållskataloger som utgör vårt paket. Vi kallar denna mapp NuGet Package för resten av denna artikel.

Gränssnittstillägg

Börja processen med att samla in allt innehåll som behövs för ett gränssnittstillägg genom att köra "gulp build" på verktyget och se till att bygget lyckas. Den här processen paketar ihop alla komponenter i en mapp med namnet "bundle" som finns i rotkatalogen för tillägget (på samma nivå som src-katalogen). Kopiera den här katalogen och allt dess innehåll till mappen "NuGet Package".

Gateway-plugins

Kompilera och skapa plugin-programmet genom att använda din bygginfrastruktur (vilket kan vara lika enkelt som att öppna Visual Studio och välja knappen Skapa). Öppna utdatakatalogen för bygget, kopiera DLL eller DLL:er som representerar plugin-programmet och placera dem i en ny mapp i katalogen "NuGet Package" med namnet "package". Du behöver inte kopiera DLL:en FeatureInterface, bara DLL eller DLL:er som representerar din kod.

Skapa nuspec-filen

Om du vill skapa NuGet-paketet måste du först skapa en .nuspec fil. En .nuspec fil är ett XML-manifest som innehåller NuGet-paketmetadata. Det här manifestet används både för att skapa paketet och för att ge information till konsumenter. Placera den här filen vid roten i mappen "NuGet-paket".

Här är ett exempel .nuspec fil och listan över obligatoriska eller rekommenderade egenskaper. Det fullständiga schemat finns i referensen nuspec. Spara .nuspec-filen i projektets rotmapp med ett valfritt filnamn.

<?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>

Obligatoriska eller rekommenderade egenskaper

Skapa tillägget NuGet-paketet

Med hjälp av den .nuspec fil som du skapade måste du nu skapa NuGet-paketet .nupkg fil som du kan ladda upp och publicera till NuGet-feeden.

1. Ladda ned nuget.exe CLI-verktyget från NuGet-klientverktygswebbplatsen.
2. Kör nuget.exe pack <>.nuspec file name> för att skapa .nupkg-filen.

Signera ditt NuGet-tilläggspaket

Alla .dll filer som ingår i tillägget måste signeras med ett certifikat från en betrodd certifikatutfärdare (CA). Som standard blockeras osignerade .dll filer från att köras när Windows Administrationscenter körs i produktionsläge.

Javascript-filer som ingår i tillägget måste signeras med ett certifikat från en betrodd certifikatutfärdare (CA).

NuGet-tillägget måste också signeras för att säkerställa paketets integritet. Windows Admin Center använder en Kestrel-server som läser in TLS/SSL-certifikat med certifikatets ämnesnamn. Kontrollera att endast ett certifikat har installerats med ett unikt ämnesnamn och att certifikatet är giltigt.

När du publicerar ett tillägg till Microsofts Windows Admin Center-tilläggsflöde signerar Microsoft paketet ovanpå din signatur.

nuget.exe verify -All <packageName>.nuget

Testa ditt NuGet-tilläggspaket

Ditt tilläggspaket är nu redo för testning! Ladda upp .nupkg-filen till en NuGet-feed eller kopiera den till en filresurs. Om du vill visa och ladda ned paket från en annan feed eller filresurs måste du ändra din feedkonfiguration så att den pekar på din NuGet-feed eller filresurs. När du testar kontrollerar du att egenskaperna visas korrekt i Extension Manager och att du kan installera och avinstallera tillägget.

Publicera tillägget till Windows Admin Center-feeden

Genom att publicera till Windows Admin Center-feeden kan du göra ditt tillägg tillgängligt för alla Windows Admin Center-användare. Eftersom Windows Admin Center SDK fortfarande är i förhandsversion vill vi arbeta nära dig för att lösa utvecklingsproblem och hjälpa dig att leverera en kvalitetsprodukt och upplevelse till dina användare.

Innan du skickar en begäran om granskning av tillägg till Microsoft måste du skicka ett e-postmeddelande till wacextensionrequest@microsoft.com som uttrycker avsikten att publicera ett tillägg till det offentliga flödet. Vi förser dig med kopior av utgivaravtalet för tillägg och tilläggspolicyn för att granska och bekräfta skriftligen.

Innan du släpper den första versionen av tillägget rekommenderar vi att du skickar en begäran om granskning av tillägg till Microsoft minst 2–3 veckor före lanseringen. Om vi tillåter 2–3 veckor innan lanseringen har vi tillräckligt med tid för att granska och för att du ska kunna göra ändringar i tillägget om det behövs. När tillägget är redo att publiceras måste du skicka det till oss för granskning. Om ditt tillägg godkänns publicerar vi det till feeden åt dig. Genom att skicka ditt tilläggspaket till Microsoft godkänner du att du är bunden av villkoren i tilläggsutgivaravtalet och tilläggspolicyn för deltagande.

Om du vill släppa en uppdatering av tillägget måste du sedan skicka en ny begäran om granskning. Beroende på omfånget för ändring är handläggningstiderna för uppdateringsgranskningar i allmänhet kortare.

Skicka en begäran om granskning av tillägg till Microsoft

Om du vill skicka en begäran om granskning av tillägg anger du följande information och skickar som ett e-postmeddelande till wacextensionrequest@microsoft.com. Vi svarar på din e-post inom en vecka.

Windows Admin Center – Information om begäran om tilläggsgranskning:

• Namn och e-postadress för tilläggets ägare/utvecklare (upp till 3 användare). Om du släpper ett tillägg för ditt företags räkning anger du företagets e-postadress.
• Företagsnamn (krävs endast om du släpper ett tillägg för ditt företags räkning)
• Tilläggsnamn
• Utgivningsmåldatum (uppskattning)
• För inlämning av nytt tillägg – Tilläggsbeskrivning (tidiga designtrådsramar, skärmockups eller produktbilder rekommenderas)
• För granskning av tilläggsuppdatering – Beskrivning av ändringar (inkludera produktskärmskärmar om användargränssnittet har ändrats avsevärt)

Skicka in ditt tilläggspaket för granskning och publicering

Se till att du följer anvisningarna ovan för att skapa ett tilläggspaket och att .nuspec-filen har definierats korrekt och att filerna är signerade. Vi rekommenderar också att du har en projektwebbplats, inklusive:

• Detaljerad beskrivning av tillägget, inklusive skärmbilder eller video
• E-postadress eller webbplatsfunktion för att få feedback eller frågor

När du är redo att publicera tillägget skickar du e-post till wacextensionrequest@microsoft.com. Vi ger instruktioner om hur du skickar ditt tilläggspaket till oss. När vi har fått ditt paket granskar vi det. När ditt tilläggspaket har godkänts publicerar vi till Windows Admin Center-flödet.