Préparer votre environnement de développement
Commençons à développer des extensions avec le Windows Admin Center SDK ! Dans ce document, nous allons aborder le processus de mise en place et d’exécution de votre environnement pour créer et tester une extension pour Windows Admin Center.
Notes
Vous découvrez le Windows Admin Center SDK ? En savoir plus sur les extensions pour Windows Admin Center
Pour préparer votre environnement de développement, suivez les étapes suivantes :
Prérequis à installer
Pour commencer à développer avec le SDK, téléchargez et installez les prérequis suivants :
- Windows Admin Center (version GA ou préliminaire)
- Visual Studio ou Visual Studio Code
- Node.js (téléchargez et installez le fichier .msi pour la version 16.20.2)
- Node Package Manager (6.14.5 ou version ultérieure)
- NuGet (pour la publication d’extensions)
Pour contourner la validation de signature qui se produit lors de l’installation de l’extension dans les versions de Windows Admin Center exécutées avec .NET 8, vous devez également basculer votre mode d’opération Windows Admin Center sur « Développement ». Pour configurer le mode de développement, vous devez :
- Ouvrez le fichier
appsettings.json
de votre instance Windows Admin Center. Vous pouvez le trouver par défaut àC:\Program Files\WindowsAdminCenter\service\appsettings.json
. - Modifiez le champ
OperationMode
sous la sectionWindowsAdminCenter/System
pour lire « Développement » au lieu de « Production ».
Notes
Pour développer des extensions sur des versions de Windows Admin Center à l’aide de .NET 4.6.2, vous devez installer et exécuter Windows Admin Center en mode développement pour suivre les étapes ci-dessous. Le Mode Dev permet à Windows Admin Center de charger des packages d’extension non signés. Windows Admin Center ne peut être installé qu’en mode Dev sur un ordinateur Windows 10.
Pour activer le mode Dev, installez Windows Admin Center à partir de la ligne de commande avec le paramètre DEV_MODE=1. Dans l’exemple ci-dessous, remplacez <version>
par la version que vous installez, c’est-à-dire WindowsAdminCenter1809.msi
.
msiexec /i WindowsAdminCenter<version>.msi DEV_MODE=1
Si vous avez déjà installé Windows Admin Center sans activer le mode Dev, vous pouvez modifier la valeur de la propriété du mode Dev à l’aide de l’Éditeur du Registre. Les propriétés de Windows Admin Center se trouvent sous le chemin d’accès suivant :
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ServerManagementGateway
Installez les dépendances globales
Ensuite, installez ou mettez à jour les dépendances requises pour vos projets, avec Node Package Manager. Ces dépendances sont installées globalement et sont disponibles pour tous les projets.
npm install -g @angular/cli@11.2.14
npm install -g gulp
npm install -g typescript
npm install -g tslint
npm install -g @microsoft/windows-admin-center-sdk@latest
Notes
Vous pouvez installer une version ultérieure de @angular/cli, mais sachez que si vous installez une version supérieure à 11.2.14, vous recevrez un avertissement lors de l’étape de génération gulp que la version cli locale ne correspond pas à la version installée.
Étapes suivantes
Maintenant que votre environnement est préparé, vous êtes prêt à commencer à créer du contenu.
- Créer une extension d'outil
- Créer une extension de solution
- Créer un plug-in de passerelle
- Pour en savoir plus, consultez nos guides
SDK - Kit de ressources de conception
Consultez notre Kit de ressources de conception - SDK Windows Admin Center. Ce kit de ressources est conçu pour vous aider à créer rapidement des extensions fictives dans PowerPoint à l’aide de styles, de contrôles et de modèles de page Windows Admin Center. Découvrez à quoi peut ressembler votre extension dans Windows Admin Center avant de commencer à coder.