Compartilhar via

Empacotar e implantar soluções do SharePoint

  • Artigo

Normalmente, uma solução do SharePoint é implantada em um servidor do SharePoint usando um arquivo de pacote de solução (.wsp). Você pode usar o Visual Studio para organizar seus Itens de Projeto do SharePoint em Recursos e criar um pacote para implantar seus recursos do SharePoint.

Este tópico fornece as seguintes informações:

Criar recursos e pacotes

Você pode usar o Visual Studio para agrupar elementos relacionados do SharePoint em um Recurso. Por exemplo, um Recurso para definição de uma lista de Contatos pode incluir a instância de lista e a definição da lista. Você pode combinar esses dois elementos em um único Recurso para fins de implantação. Para obter mais informações sobre recursos, consulte Bloco de Construção: Recursos.

Em seguida, você pode criar um pacote de solução do SharePoint (.wsp) para agrupar vários recursos, definições de site, assemblies e outros arquivos em um único pacote, que armazena os arquivos em um formato necessário para o SharePoint para implantar os arquivos no servidor. Para obter mais informações, confira Bloco de construção: Soluções.

Suporte aos recursos e à ferramenta de empacotamento

Você pode usar as ferramentas de desenvolvimento do SharePoint no Visual Studio para organizar rapidamente seus arquivos do SharePoint em pacotes de Recursos e soluções para facilitar a implantação. Você pode usar as ferramentas a seguir para configurar o pacote de recursos e soluções.

  • Designer de Recursos e Designer de Pacotes.

  • Gerenciador de Empacotamento, uma janela de ferramentas.

  • Gerenciador de Soluções.

Designer de Recursos e Designer de Pacotes

Você pode criar Recursos, definir escopos e marcar outros Recursos como dependências usando o Designer de Recursos. O designer também exibe o arquivo XML final que descreve cada recurso. Para obter mais informações, consulte Criar recursos do SharePoint.

Aplique o recurso a um site ou grupo específico de sites definindo seu escopo no Designer de Recursos. Se um recurso for ativado para um site individual, o recurso só funcionará nesse site específico. Se um recurso for ativado para um conjunto de sites, os itens no recurso se aplicarão ao conjunto inteiro de sites. Para obter mais informações, consulte Escopo do Elemento.

Se o recurso depender de outros recursos, você poderá definir uma dependência de ativação de recursos para marcar os recursos dependentes antes de disponibilizar o recurso. A dependência de ativação de recurso verifica se os recursos dependentes já estão ativados nesse escopo. Para obter mais informações, consulte Dependências de ativação e escopo.

No Designer de Pacotes, você pode agrupar elementos do SharePoint em um único pacote de solução e configurar se deseja redefinir o servidor Web durante a implantação. Para definir o tipo de servidor de implantação, use a janela Propriedades. O designer também gera o arquivo XML que descreve o conteúdo do pacote. Para obter mais informações, consulte Criar pacotes de solução do SharePoint.

Durante a implantação, o serviço IIS (Serviços de Informações da Internet) é interrompido para copiar os arquivos de solução para o servidor do SharePoint. Usando o Designer de Pacotes no Visual Studio, você pode selecionar se o servidor Web deve ser reiniciado. Para configurar se a solução será implantada em um servidor Web front-end ou em um servidor de aplicativos, use a janela Propriedades. Para obter mais informações, consulte Elemento da Solução (Solução).

Gerenciador de Empacotamento

Para complementar o Designer de Recursos e o Designer de Pacotes, você pode usar o Gerenciador de Empacotamento para agrupar seus arquivos do SharePoint em Recursos e pacotes. Além disso, você pode ver a exibição hierárquica do pacote, Recursos, itens de projeto do SharePoint e arquivos. O Gerenciador de Empacotamento é uma janela de ferramentas que você pode usar para concluir as seguintes tarefas:

  • Abrir arquivos e itens de projeto do SharePoint.

  • Arrastar e soltar os itens de projeto do SharePoint de um Recurso para outro.

  • Arrastar e soltar itens de projeto e Recursos do SharePoint de um pacote para outro.

  • Adicionar um novo Recurso a um pacote.

  • Abrir um designer de pacotes ou Recurso.

  • Validar Recursos e pacotes.

    As ferramentas de desenvolvimento do SharePoint no Visual Studio possuem regras de validação para ajudar a garantir que o pacote de soluções seja formado corretamente. Além disso, as regras verificam se o arquivo de solução .wsp pode ser implantado e ativado com êxito em um servidor do SharePoint. Para obter mais informações sobre o esquema XML para Recursos, consulte Esquemas de recursos.

    Você pode adicionar regras personalizadas de validação de Recursos e pacotes ao sistema de projetos do SharePoint. Para obter mais informações, consulte Como criar um recurso personalizado e regras de validação de pacotes para soluções do SharePoint.

    Para obter mais informações sobre o Gerenciador de Empacotamento, consulte Como adicionar recursos e itens a um Pacote e removê-los usando o Gerenciador de Empacotamento.

Gerenciador de Soluções

Você pode usar Gerenciador de Soluções para navegar e abrir os arquivos do projeto do SharePoint. Use o menu de contexto no Gerenciador de Soluções para adicionar Recursos e Receptores de eventos de recursos. Além disso, você pode abrir os Designers de Recursos e Designers de Pacotes para configurar os Recursos e pacotes para implantação.

Implantar soluções do SharePoint

Depois de personalizar os Recursos e o pacote no Visual Studio, você pode criar um arquivo .wsp para implantar em servidores do SharePoint. Você pode usar o Visual Studio para depurar e testar o ,wsp somente no servidor do SharePoint do computador de desenvolvimento. Para obter mais informações sobre como implantar suas soluções do SharePoint em um servidor remoto do SharePoint, consulte Implantando uma solução.

Você também pode personalizar as etapas de implantação no computador de desenvolvimento. Para obter mais informações, consulte Implantar, publicar e atualizar pacotes de soluções do SharePoint.

Implantar arquivos em soluções do SharePoint

Normalmente, quando você adiciona um item de projeto do SharePoint à sua solução do SharePoint, todos os arquivos necessários são incluídos. Os arquivos que podem ser compilados (arquivos de código) são incorporados ao assembly de saída da solução. No entanto, talvez você também precise adicionar arquivos não compiláveis, por exemplo, .xml, .txtou arquivos de recurso a um projeto do SharePoint. Esses arquivos não são empacotados automaticamente em sua solução. Para garantir que eles sejam empacotados, adicione os arquivos a uma pasta mapeada ou a um item de projeto do SharePoint.

Os arquivos adicionados às pastas mapeadas são copiados automaticamente para o hive do SharePoint quando a solução é implantada. Os arquivos adicionados a um item de projeto do SharePoint são implantados no local especificado na propriedade Local de Implantação para cada arquivo, que é parcialmente definido com base na propriedade Tipo de Implantação. Por padrão, o valor da propriedade Tipo de Implantação é NoDeployment, o que significa que o arquivo não é implantado com a solução. Você deve definir outro valor para a propriedade para incluir o arquivo no pacote.

Por exemplo, para adicionar um arquivo .xml a um projeto do SharePoint, execute uma destas ações:

  • Adicione uma Pasta Mapeada "Layouts" do SharePoint ao seu projeto. Isso cria no Gerenciador de Soluções uma pasta chamada Layouts que tem uma subpasta para o projeto. Adicione o arquivo.xml à nova subpasta. Por padrão, o arquivo é implantado no sistema de arquivos do SharePoint em ..\TEMPLATE\LAYOUTS\<Nome da Pasta>. Para obter informações sobre como adicionar pastas mapeadas, consulte Como adicionar e remover pastas mapeadas.

  • Adicione o arquivo .xml à pasta de um item de projeto do SharePoint e altere a propriedade Tipo de Implantação do arquivo .xml de NoDeployment para outra configuração, como RootFile ou ElementFile. A configuração apropriada de Tipo de Implantação depende do arquivo e do projeto. Para obter mais informações sobre as configurações da propriedade Tipo de Implantação, consulte Desenvolver soluções do SharePoint.

    Se um arquivo adicionado não se aplicar a nenhum projeto específico na solução, você poderá adicionar um Projeto vazio do SharePoint à sua solução e, em seguida, adicionar os arquivos adicionais a ele. Outra alternativa para implantar arquivos no SharePoint, especialmente no banco de dados de conteúdo, é adicionar um módulo ao projeto e, em seguida, adicionar os arquivos ao módulo. Para obter mais informações, confira Usar Módulos para Incluir arquivos na Solução.

Confira também