Desenvolver Suplementos do Office com o Código do Visual Studio
Este artigo descreve como usar o Código do Visual Studio (VS Code) para desenvolver um suplemento do Office.
Observação
Para saber mais sobre como usar o Visual Studio para criar um suplemento do Office, confira Desenvolver suplementos do Office com o Visual Studio.
Pré-requisitos
Node.js (a versão mais recente de LTS). Visite o siteNode.js para transferir e instalar a versão certa para o seu sistema operativo.
A versão mais recente do Yeoman e do Yeoman gerador de Suplementos do Office. Para instalar essas ferramentas globalmente, execute o seguinte comando por meio do prompt de comando.
npm install -g yo generator-officeObservação
Mesmo se você já instalou o gerador Yeoman, recomendamos atualizar seu pacote para a versão mais recente do npm.
Office conectado a uma assinatura Microsoft 365 (incluindo o Office na web).
Observação
Se ainda não tiver o Office, poderá qualificar-se para uma subscrição de programador Microsoft 365 E5 através do Programa para Programadores do Microsoft 365. Para obter detalhes, consulte as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.
Criar um projeto de suplemento usando o gerador Yeoman
Se você estiver usando o VS Code como o seu ambiente de desenvolvimento integrado (IDE), crie o projeto do Suplemento do Office com o Gerador Yeoman para Suplementos do Office. O gerador Yeoman cria um projeto Node.js que pode ser gerenciado com o VS Code ou qualquer outro editor.
Para criar um Suplemento do Office com o gerador Yeoman, siga as instruções eminício rápido em 5 minutos que corresponda ao tipo de suplemento que você deseja criar.
Desenvolver o suplemento usando o VS Code
Quando o gerador Yeoman terminar de criar o projeto do suplemento, abra a pasta raiz do projeto com o VS Code.
Dica
No Windows, navegue até o diretório raiz do projeto por meio da linha de comando e, em seguida, insira code . para abrir essa pasta no VS Code. No Mac, você precisará adicionar o comando code ao caminho antes de poder usá-lo para abrir a pasta do projeto no VS Code.
O gerador Yeoman cria um suplemento básico com funcionalidade limitada. Você pode personalizar o suplemento editando o manifesto, HTML, JavaScript ou TypeScript e arquivos CSS no VS Code. Para obter uma descrição de alto nível sobre a estrutura e os arquivos do projeto no projeto de suplemento que o gerador de Yeoman cria, confira o tópico diretrizes do gerador Yeoman dentro em Início rápido em 5 minutos que corresponda ao tipo de suplemento que você criou.
Criar o projeto de suplemento com o Development Kit de Suplementos do Office (pré-visualização)
O Development Kit de Suplementos do Office é uma extensão Visual Studio Code que lhe permite criar novos projetos diretamente a partir do VS Code. Para obter informações sobre como instalar a extensão e criar projetos a partir de modelos e exemplos, consulte Criar projetos de Suplementos do Office com o Development Kit de Suplementos do Office para Visual Studio Code.
Importante
A extensão do Development Kit de Suplementos do Office só suporta a criação de suplementos que utilizem o manifesto apenas de suplementos. Também cria apenas suplementos do Excel, PowerPoint e Word neste momento. O suporte para o Outlook está em desenvolvimento, assim como exemplos adicionais e outras melhorias. Agradecemos qualquer feedback que tenha sobre a ferramenta. Os pedidos de problemas e funcionalidades devem ser submetidos através de problemas do GitHub no repositório da extensão.
Testar e depurar o suplemento
Os métodos para testar, depurar e solucionar problemas de Suplementos do Office variam de acordo com a plataforma. Para mais informações, confira Testar e depurar Suplementos do Office.
Publique o suplemento
Um Suplemento do Office é formado por um aplicativo Web e um arquivo de manifesto. O aplicativo Web define a interface do usuário e a funcionalidade do suplemento, enquanto o manifesto especifica o local do aplicativo Web e define as configurações e os recursos do suplemento.
Enquanto estiver desenvolvendo o suplemento, você poderá executá-lo em seu servidor Web local (localhost), mas quando estiver pronto para publicá-lo para que outros usuários acessem o, será necessário implantar o aplicativo Web em um servidor Web ou serviço de hospedagem na Web (por exemplo, Microsoft Azure) e atualizar o manifesto para especificar a URL do aplicativo implantado.
Quando o suplemento estiver funcionando conforme desejado e você estiver pronto para publicá-lo para que outros usuários acessem, conclua as etapas a seguir.
Na linha de comando, no diretório raiz do projeto de suplemento, execute o comando a seguir para preparar todos os arquivos para implantação de produção.
npm run buildQuando a compilação for concluída, a pasta distno diretório raiz do projeto de suplemento incluirá os arquivos que você implantará nas etapas subsequentes.
Carregue o conteúdo da pasta dist para o servidor Web que hospedará o suplemento. Você pode usar qualquer tipo de servidor Web ou serviço de hospedagem na Web para hospedar o suplemento.
No VS Code, abra o arquivo de manifesto do suplemento localizado na pasta raiz do projeto (
manifest.xml). Substitua todas as ocorrências dehttps://localhost:3000pela URL do aplicativo Web implementado no servidor Web na etapa anterior.Escolha o método que deseja usar para implantar seu suplemento do Office e siga as instruções para publicar o arquivo de manifesto.