Prepare seu ambiente de desenvolvimento
Vamos começar a desenvolver extensões com o SDK do Windows Admin Center! Neste documento, abordaremos o processo para colocar seu ambiente em funcionamento para criar e testar uma extensão para o Windows Admin Center.
Observação
Novo no SDK do Windows Admin Center? Saiba mais sobre as Extensões de para o Windows Admin Center
Para preparar seu ambiente de desenvolvimento, execute as seguintes etapas:
Pré-requisitos de instalação
Para começar a desenvolver com o SDK, baixe e instale os seguintes pré-requisitos:
- do Windows Admin Center (versão GA ou pré-visualização)
- Visual Studio ou Visual Studio Code
- Node.js (baixe e instale o arquivo .msi para a versão 16.20.2)
- Node Package Manager (6.14.5 ou posterior)
- NuGet (para publicar extensões)
Para ignorar a validação de assinatura que ocorre durante a instalação da extensão em versões do Windows Admin Center em execução com o .NET 8, você também deve alternar o modo de operação do Windows Admin Center para "Desenvolvimento". Para configurar o modo de desenvolvimento, você deve:
- Abra o arquivo
appsettings.json
da instância do Windows Admin Center. Isso pode ser encontrado por padrão emC:\Program Files\WindowsAdminCenter\service\appsettings.json
. - Modifique o campo
OperationMode
na seçãoWindowsAdminCenter/System
para ler "Desenvolvimento" em vez de "Produção".
Observação
Para desenvolver extensões em versões do Windows Admin Center usando o .NET 4.6.2, você precisa instalar e executar o Windows Admin Center no Modo de Desenvolvimento para seguir as etapas abaixo. O Modo de Desenvolvimento permite que o Windows Admin Center carregue pacotes de extensão não assinados. O Windows Admin Center só pode ser instalado no Modo de Desenvolvimento em uma máquina Windows 10.
Para habilitar o Modo de Desenvolvimento, instale o Windows Admin Center a partir da linha de comando com o parâmetro DEV_MODE=1. No exemplo abaixo, substitua <version>
pela versão que você está instalando, ou seja, WindowsAdminCenter1809.msi
.
msiexec /i WindowsAdminCenter<version>.msi DEV_MODE=1
Se você já tiver instalado o Windows Admin Center sem habilitar o Modo de Desenvolvimento, poderá editar o valor da propriedade Modo de Desenvolvimento usando o Editor do Registro. As propriedades do Windows Admin Center podem ser encontradas no seguinte caminho:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ServerManagementGateway
Instalar dependências globais
Em seguida, instale ou atualize as dependências necessárias para os seus projetos, com o Node Package Manager. Essas dependências serão instaladas globalmente e estarão disponíveis para todos os projetos.
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
Observação
Você pode instalar uma versão posterior do @angular/cli, no entanto, esteja ciente de que, se você instalar uma versão maior que 11.2.14, você receberá um aviso durante a etapa de compilação gulp que a versão cli local não corresponde à versão instalada.
Próximos passos
Agora que seu ambiente está preparado, você está pronto para começar a criar conteúdo.
- Criar uma extensão de ferramenta
- Criar uma extensão de solução
- Criar um plugin de gateway
- Saiba mais com os nossos guias
Kit de ferramentas de design do SDK
Confira nosso kit de ferramentas de design do Windows Admin Center SDK! Este kit de ferramentas foi projetado para ajudá-lo a simular rapidamente extensões no PowerPoint usando estilos, controles e modelos de página do Windows Admin Center. Veja como pode ser a sua extensão no Windows Admin Center antes de começar a codificar!