Compartilhar via

Preparar seu ambiente de desenvolvimento

  • Artigo
  • Aplica-se a:
    ✅ Windows Admin Center, ✅ Windows Admin Center Preview

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 a fim de 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 do Windows Admin Center

Para preparar seu ambiente de desenvolvimento, execute as seguintes etapas:

Instalar pré-requisitos

Para começar a desenvolver com o SDK, baixe e instale os seguintes pré-requisitos:

Para ignorar a validação de assinatura que ocorre durante a instalação da extensão nas 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 de appsettings.json da instância do Windows Admin Center. Isso pode ser encontrado por padrão em C:\Program Files\WindowsAdminCenter\service\appsettings.json.
  • Modifique o campo OperationMode na seção WindowsAdminCenter/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. Modo de dev permite que o Windows Admin Center carregar os pacotes de extensão não assinados. O Windows Admin Center só pode ser instalado no Modo de Desenvolvimento em um computador Windows 10.

Para habilitar o modo Dev, instale o Windows Admin Center na linha de comando com o parâmetro DEV_MODE = 1. No exemplo a seguir, substitua <version> com a versão que você está instalando, isto é, WindowsAdminCenter1809.msi.

msiexec /i WindowsAdminCenter<version>.msi DEV_MODE=1

Se você já instalou 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 para 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 dependências necessárias para os projetos, com o Gerenciador de pacote de nó. 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

É possível instalar uma versão posterior do @angular/cli, no entanto, lembre-se de que, se você instalar uma versão superior à 11.2.14, receberá um aviso durante a etapa de build do Gulp de que a versão da CLI local não corresponde à versão instalada.

Próximas etapas

Agora que seu ambiente está preparado, você está pronto para começar a criar conteúdo.

Kit de ferramentas de design do SDK

Confira nosso kit de ferramentas de design do SDK do Windows Admin Center! Este kit de ferramentas foi projetado para ajudar você a simular rapidamente extensões no PowerPoint usando estilos de Windows Admin Center, controles e modelos de página. Veja como sua extensão pode ser em Windows Admin Center antes de começar a codificar!