Share via

Publicar seu suplemento usando o Visual Studio

  • Artigo

Seu pacote de Suplemento do Office contém um arquivo de manifesto XML que deve ser usado para publicar o suplemento. Você terá que publicar os arquivos do aplicativo Web do seu projeto separadamente. Este artigo descreve como implantar seu projeto Web e empacotar seu suplemento usando o Visual Studio 2019.

Observação

Para saber mais sobre como publicar um Suplemento do Office criado com o gerador Yeoman e desenvolvido com o Código do Visual Studio ou qualquer outro editor, confira Publicar um suplemento desenvolvido com o Código do Visual Studio.

Para implantar seu projeto Web usando o Visual Studio 2019

Conclua as etapas a seguir para implantar seu projeto Web usando o Visual Studio 2019.

  1. Na guia Compilar, escolha Publicar [Nome do seu suplemento].

  2. Na janela Escolha um destino de publicação, escolha uma das opções de publicação para o seu destino preferido. Cada destino de publicação exige que você inclua mais informações para começar, como um local de pasta ou uma Máquina Virtual do Azure. Depois de especificar um local de publicação e preencher todas as informações necessárias, selecione Publicar

    Observação

    Escolher um destino de publicação especifica o servidor ao qual você está implantando, as credenciais necessárias para entrar no servidor, os bancos de dados a serem implantados e outras opções de implantação.

  3. Para obter mais informações sobre as etapas de implantação de cada opção de destino de publicação, confira Primeiro contato com a implantação no Visual Studio.

Para empacotar e publicar seu suplemento usando IIS, FTP ou implantação da Web usando o Visual Studio 2019

Conclua as etapas a seguir para empacotar seu suplemento usando o Visual Studio 2019.

  1. Na guia Compilar, escolha Publicar [Nome do seu suplemento].

  2. Na janela Escolha um destino de publicação, escolha IIS, FTP, etc e selecione Configurar. Em seguida, selecione Publicar.

  3. Será exibido um assistente que o ajudará durante todo o processo. Verifique se o método de publicação é o método preferido, como implantação da Web.

  4. Na caixa URL de destino, digite a URL do site que hospedará os arquivos de conteúdo do seu suplemento e, em seguida, selecione Avançar. Se você pretende enviar seu suplemento ao AppSource, escolha o botão Validar conexão para identificar problemas que possam impedir a aceitação do seu suplemento. Você deve resolver todos os problemas antes de enviar seu suplemento para a loja.

  5. Confirme as configurações desejadas, incluindo Opções de publicação de arquivo e selecione Salvar.

    Importante

    Embora não seja estritamente obrigatório em todos os cenários de suplemento, é altamente recomendável o uso do ponto de extremidade do HTTPS para o suplemento. Os suplementos que não estiverem protegidos por SSL (HTTPS) geram erros e avisos de conteúdo não seguro durante o uso. Se você planeja executar seu suplemento no Office na Web ou publicar seu suplemento no AppSource, ele deve estar protegido por SSL. Se o suplemento acessar serviços e dados externos, ele deve estar protegido por SSL para proteger os dados em trânsito. Certificados autoassinados podem ser usados para desenvolvimento e teste, desde que sejam aceitos como confiáveis no computador local. Os sites do Azure fornecem automaticamente um ponto de extremidade HTTPS.

Agora é possível carregar seu manifesto XML no local apropriado para publicar seu suplemento. É possível encontrar o manifesto XML em OfficeAppManifests na pasta app.publish. Por exemplo:

%UserProfile%\Documents\Visual Studio 2019\Projects\MyApp\bin\Debug\app.publish\OfficeAppManifests

Implantar atualizações

Ao adicionar recursos ou corrigir bugs no suplemento, você precisará implantar as atualizações. Se o suplemento for implantado por um ou mais administradores em suas organizações, algumas alterações de manifesto exigirão que o administrador consenta com as atualizações. Os usuários serão bloqueados do suplemento até que o consentimento seja concedido. As alterações de manifesto a seguir exigirão que o administrador consenta novamente.

Observação

Sempre que você fizer uma alteração no manifesto, você deve aumentar o número de versão do manifesto.

Confira também