Publicar suplementos do SharePoint usando o Visual Studio
Saiba como publicar seu Suplemento do SharePoint usando o Microsoft Visual Studio 2013 ou o Visual Studio 2012. Se o suplemento tiver um aplicativo Web associado, você o implantará primeiro.
Em seguida, quanto a todos os Suplementos do SharePoint, você empacota o Suplemento do SharePoint e o publica. Opcionalmente, você também pode optar por enviar seu suplemento para inclusão na Office Store.
Pré-requisitos
- Microsoft Visual Studio 2013 ou Visual Studio 2012 e as Ferramentas de Desenvolvedor do Office para Visual Studio. Para baixar as ferramentas, consulte "Ferramentas" na página Baixar. (O novo Publish Manager não está disponível no Visual Studio 2012 ou em versões anteriores.)
- Microsoft SharePoint
Publicar usando o Visual Studio 2013
Se o Suplemento do SharePoint hospedado pelo provedor tiver um aplicativo Web, implante os arquivos para ele primeiro. Em seguida, como em todos os suplementos do SharePoint, empacote o Suplemento do SharePoint e publique-o.
Importante
Para garantir que a ID do cliente do SharePoint e os valores do Segredo do Cliente sejam publicados com seu projeto Web, o que permite que seu conteúdo da Web acesse dados do SharePoint, publique seu projeto de Suplemento do SharePoint na página Publicar seu suplemento . Você acessa esta página abrindo o menu de atalho para o Suplemento do SharePoint, não o menu de atalho para o aplicativo Web e escolhendo o comando Publicar .
Etapa 1: Implantar o aplicativo Web
Seu Suplemento do SharePoint normalmente tem um aplicativo Web host associado que você precisa implantar em um servidor Web. Para obter mais informações sobre como usar o assistente Publicar Web, confira Como implantar um projeto Web usando a Publicação clicando no Visual Studio.
Para abrir a página Publicar seu suplemento
- Em Gerenciador de Soluções, abra o menu de atalho do projeto suplemento do SharePoint e escolha Publicar.
- A página Publicar seu suplemento é exibida.
Para selecionar ou criar um perfil
Na lista De perfil atual , escolha um perfil para importar ou escolha <Novo ...> para criar um perfil.
Um perfil de publicação especifica o servidor ao qual você está implantando o aplicativo Web, as credenciais necessárias para fazer logon no servidor, os bancos de dados a serem implantados (se aplicável) e outras opções de implantação. Você pode criar diferentes perfis de publicação para atender às suas necessidades. Por exemplo, você pode criar um perfil para teste e outro perfil para publicação.
Se você escolher <Novo ...>, o assistente Criar perfil de publicação será exibido. Você pode usar esse assistente para importar um perfil de publicação de um provedor de hospedagem de sites, como o Azure, ou para criar um perfil e, em seguida, adicionar manualmente o nome do servidor, credenciais e outras configurações. Se você criou um novo perfil em vez de importar um perfil existente, precisará fornecer ID do cliente e valores secretos do cliente, conforme descrito em Diretrizes para registrar suplementos do SharePoint 2013 e Como: Criar IDs do cliente e segredos no Painel do Microsoft Seller.
Se você planeja enviar seu Suplemento do SharePoint para a Office Store, use a ID do cliente e os valores de segredo do cliente criados no Painel do Vendedor. Você pode usar IDs do cliente e valores secretos do cliente gerados usando a página appregnew.aspx durante a fase de desenvolvimento, mas os suplementos que você envia à Office Store devem usar IDs do cliente e segredos do cliente obtidos no Painel do Vendedor. Além disso, você deve criar o perfil de publicação em seu site do Azure e importá-lo para o Visual Studio, em vez de criar um perfil no assistente Criar perfil de publicação . Quando você cria um perfil no Azure, todas as configurações na guia Conexão são fornecidas para você no Visual Studio. Para obter mais informações sobre como importar ou criar um perfil de publicação, consulte Criando um perfil de publicação.
Dica
Se você não puder publicar conteúdo da Web diretamente, poderá criar um pacote de implantação da Web que um administrador pode implantar na Web para você. Para criar um pacote de implantação da Web, crie um novo perfil, escolha a guia Conexão e escolha Pacote de Implantação da Web na lista Publicar método .
Para implantar seu projeto de aplicativo Web
Na página Publicar seu suplemento , escolha o botão Implantar seu projeto Web . A caixa de diálogo Publicar Web é exibida.
Nas guias Conexão e Configurações , preencha todos os valores ausentes.
Para alterar como os arquivos do suplemento do SharePoint são publicados ou se o suplemento usa um banco de dados externo, escolha a guia Configurações . Confira a seção "Configurando a guia Configurações" em Como implantar um projeto Web usando a publicação clicando no Visual Studio.
Para examinar quais itens serão alterados quando o aplicativo Web for implantado, escolha o botão Iniciar Visualização na guia Visualização .
Escolha o botão Publicar para implantar o projeto do aplicativo Web.
Etapa 2: Criar um pacote do suplemento
Na página Publicar seu suplemento , escolha o botão Empacotar o suplemento . O assistente Publicar Suplementos do Office e do SharePoint é exibido.
Na caixa de texto Onde seu site está hospedado? insira a URL do site que hospedará os arquivos de conteúdo do suplemento do SharePoint.
Você deve especificar um endereço que começa com o prefixo "https". Veja Por que meus suplementos precisam ser protegidos por SSL?.
Observação
Os sites do Azure fornecem automaticamente um ponto de extremidade https. Se você publicar seu suplemento em um site da Office Store ou na Office Store, o endereço deverá começar com um prefixo https. No entanto, se você publicar o suplemento em um site local, poderá usar um prefixo http.
Na caixa de texto Qual é a ID do cliente do suplemento? A ID do cliente que você inseriu no perfil de publicação já deve ser exibida.
Se você usou um valor de espaço reservado para a ID do cliente até este ponto, deverá adicionar uma ID real do cliente agora. Essas informações estão inseridas no pacote .app e permitem que seu conteúdo da Web se comunique com o SharePoint no site ao vivo.
Escolha o botão Concluir .
O Visual Studio gera os arquivos necessários para publicar seu Suplemento do SharePoint e, em seguida, abre a pasta de saída de publicação. Para obter informações sobre como instalar o suplemento, consulte Instalar e gerenciar suplementos do SharePoint 2013.
Etapa 3: Publicar seu Suplemento do SharePoint na Office Store
Execute o procedimento a seguir se quiser enviar o Suplemento do SharePoint para a Office Store.
Na página Publicar seu suplemento , escolha o botão Visitar o Painel do Vendedor e entre na conta do Painel do Microsoft Seller.
Consulte Usar o Painel do Vendedor para enviar sua solução ao AppSource.
Escolha adicionar um novo aplicativo, preencha as informações e envie o suplemento para a Office Store. Para obter detalhes, consulte Usar o Painel do Vendedor para enviar sua solução ao AppSource.
Publicar usando o Visual Studio 2012
Quando estiver pronto para empacotar seu Suplemento do SharePoint, abra o assistente De Suplementos do Publish Office , que prepara os arquivos no suplemento do SharePoint para publicação.
Etapa 1: empacotar o suplemento do SharePoint
Em Gerenciador de Soluções, abra o menu de atalho do projeto suplemento do SharePoint e escolha Publicar.
O assistente de Suplementos do Publish Office é exibido. O tipo de Suplemento do SharePoint que você está empacotando determina as páginas que aparecem no assistente. Se o suplemento for hospedado no SharePoint, apenas a página Resumo será exibida. Se o suplemento for hospedado no provedor, as páginas Perfil e Hospedagem também serão exibidas.
Se o Suplemento do SharePoint estiver hospedado no provedor, especifique um nome de perfil de publicação na lista Qual perfil você deseja publicar e escolha o botão Avançar .
O perfil de publicação salva as informações inseridas na página Hospedagem .
Na lista Onde seu site está hospedado? especifique a URL do aplicativo Web que hospedará seu Suplemento do SharePoint.
Nas caixas em Qual é a identidade do suplemento?, especifique a ID do cliente e o segredo do cliente para o suplemento e escolha o botão Avançar .
Consulte Autorização e autenticação de suplementos do SharePoint.
Para todos os tipos de Suplementos do SharePoint, selecione a pasta Abrir saída após a caixa de seleção de empacotamento bem-sucedida , se ela ainda não estiver selecionada e escolha o botão Concluir .
O Visual Studio gera todos os arquivos necessários para publicar seu Suplemento do SharePoint. Você pode encontrar esses arquivos na
app.Publish
pasta da pasta de saída do projeto (por exemplo,%UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish
). Essa pasta conterá um arquivo .app para seu Suplemento do SharePoint e vários arquivos para o aplicativo Web (se o suplemento do SharePoint for baseado em nuvem). Todos os suplementos do SharePoint incluem um arquivo .app, que é o manifesto de suplemento para publicar o Suplemento do SharePoint. Os suplementos do SharePoint hospedados pelo provedor também incluem arquivos para publicar o aplicativo Web host.
Etapa 2: publicar o aplicativo Web
Se o Suplemento do SharePoint estiver hospedado no provedor, normalmente você terá um aplicativo Web host associado que você precisa publicar em um servidor Web. O Visual Studio gera um pacote de implantação e um script para ajudá-lo a executar essa tarefa.
O pacote de implantação do projeto de aplicativo Web está contido em um arquivo compactado (.zip) na app.publish
pasta. Além do arquivo .zip, a app.publish
pasta contém os seguintes arquivos:
Arquivo | Descrição |
---|---|
NomeProjeto.deploy.cmd | Este é um arquivo em lote de linha de comando que chama a Implantação na Web para que você possa instalar mais facilmente o pacote em um prompt de comando. |
NomeProjeto.SetParameters.xml | Este arquivo contém parâmetros que são passados para o Web Deploy quando você usa o arquivo deploy.cmd para instalar o pacote. As configurações do pacote do Visual Studio determinam o valor padrão especificado para cada parâmetro. Você pode alterar esses valores se, por exemplo, quiser instalar o aplicativo Web em vários servidores e usar configurações diferentes para cada servidor. |
NomeProjeto.SourceManifest.xml | Este arquivo contém configurações que o Visual Studio passa para a Implantação da Web e que a Implantação da Web usa para criar o pacote Web. A Implantação da Web requer esse arquivo apenas para criar o pacote. Esse arquivo não é usado quando o pacote é instalado. |
Para obter diretrizes passo a passo, consulte Como instalar um pacote de implantação usando o arquivo deploy.cmd criado usando o Visual Studio
Etapa 3: publicar seu Suplemento do SharePoint
Para publicar seu Suplemento do SharePoint, carregue o arquivo de manifesto de suplemento (.app) do suplemento para a Office Store, o catálogo de Suplementos do Office, o SharePoint, um compartilhamento de arquivos ou o catálogo do Exchange. O manifesto de suplemento do suplemento está localizado na app.publish
pasta, como %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish
. Para obter mais informações sobre como publicar seu Suplemento do SharePoint, consulte Autorização e autenticação de suplementos do SharePoint.