Implantando o nível de aplicativo Adicionar-ins (sistema de 2003)

  • Artigo

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de aplicativo

Versão do Microsoft Office

  • Microsoft Office 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Implantação de um Microsoft Office 2003 Adicionar - in criado usando Ferramentas do Visual Studio para o Office geralmente significa que, trabalhando com os seguintes arquivos:

  • O assembly principal de Adicionar-in e qualquer assembly dependente como recursos, satélites e bibliotecas auxiliares.

  • O manifesto do aplicativo.

  • O manifesto da implantação (se aplicável).

Quando você implantar sua solução, considere o seguinte Basic diretrizes:

Para implantar o Adicionar - in, execute estas etapas:

  • Copiar o manifesto do aplicativo que é gerado pelo processo de compilação e as entradas de registro necessárias para cada computador cliente.

  • Copiar os assemblies de Adicionar-in (e opcionalmente o manifesto de implantação) para o local de implantação.

O local de implantação pode ser uma pasta local no computador cliente, ou pode ser um local remoto, como um Compartilhar de rede.Para obter mais informações, consulte Modelos de implantação (sistema de 2003) e Como: Implantar soluções do Office (sistema de 2003).

Observação:

Não é nenhuma opção de implantação que permite aos usuários finais usar o COM Adicionar-caixa de diálogo de ins em aplicativos do Microsoft Office 2003 para instalar um Adicionar - que foi criado por meio do Ferramentas do Visual Studio para o Office.

Usando o projeto de instalação

Quando você Criar um projeto de suplemento usando Ferramentas do Visual Studio para o Office, uma instalação de projeto é automaticamente adicionado à solução.Se você desejar implantar sua solução diretamente para o computador cliente, você pode usar esse projeto de instalação para gerar um arquivo do Windows Installer (.msi). O instalador copia os arquivos de solução para o computador cliente e cria as entradas do Registro que são necessários para executar o Adicionar - in.Para obter mais informações sobre o projeto de instalação, consulte Instalação projetos para o nível de aplicativo Adicionar-ins (sistema de 2003).Para obter mais informações sobre as entradas de registro, consulte Entradas de registro para Application-Nível Adicionar-ins.

Limitações do projeto de instalação

O projeto de instalação padrão tem várias limitações:

  • Por padrão, o projeto de instalação não Não Definido a diretiva de segurança.O assembly do suplemento e os assemblies referenciados devem ser concedidos completo Confiar para o Adicionar-in executar.Você pode adicionar uma etapa no projeto de instalação para configurar a diretiva de segurança, ou um administrador pode definir a diretiva de segurança apropriadas.For more information, see Requisitos de segurança para executar o Office Solutions (sistema de 2003).

  • Por padrão, o projeto de instalação não Marcar, ou instalação, o Tempo de execução Ferramentas do Visual Studio para o Office e o assembly interoperabilidade primário (PIA) para o aplicativo do Microsoft Office.Se esses componentes não estiverem instalados no computador do usuário final, o Adicionar - não será executado.Para obter mais informações sobre os pré-requisitos, consulte Como: Preparar os computadores de usuário final para Run Office Solutions (sistema de 2003).

Usando o Assistente de Publicar

Se você quiser ativar atualizações Automáticos assembly, você pode usar o de Publicar Assistente .O de Publicar Assistente cria um manifesto de implantação para a solução e cópias de Tudo arquivos necessários para o local de implantação.

O comando de De publicar de no menu de atalho do projeto em Gerenciador de Soluções inicia o Assistente de publicação .Você identificar o local da pasta para o qual você deseja publicar a solução e o assistente copia o manifesto da implantação para essa pasta.O assistente também copia os assemblies e um manifesto de aplicativo atualizado para uma subpasta da pasta principal de implantação.O nome da subpasta contém um número de versão.Se a opção Automaticamente incremento revisão com cada versão está Selecionadoda no painel Publicar da Designer de Projeto , uma Novo subpasta será criada sempre que você publique a solução.Versões mais antigas permanecem disponíveis.Os manifestos de aplicativo e implantação garantir que a solução sempre usa o correto Assembly.Para obter mais informações, consulte Aplicativo e manifestos de implantação in Office Solutions, Como: Implantar arquivos de solução com o Assistente de Publicar (sistema de 2003) e Publicar a página, Designer de projeto (Sistema de 2007).

Limitações do Assistente de Publicar

O de Publicar Assistente possui várias limitações:

  • O de Publicar Assistente não cria as entradas do Registro que são necessárias para executar o suplemento.Se você usar o de Publicar Assistente para implantar um Adicionar-in, você deve criar essas entradas do Registro você mesmo — por exemplo, usando um arquivo do Registro (. reg).O de Publicar Assistente também não substituir ou remover as entradas do Registro criadas no computador de desenvolvimento quando você compila seu projeto.Para obter mais informações sobre a criação de projetos, consulte Office solução Compilação processo Visão geral.Para obter mais informações sobre as entradas de registro, consulte Entradas de registro para Application-Nível Adicionar-ins.

  • O de Publicar Assistente não conceConfiar Completo ao assembly do suplemento na diretiva de segurança do usuário final.O assembly do suplemento e os assemblies referenciados devem ser concedidos completo Confiar para o Adicionar-in executar.For more information, see Requisitos de segurança para executar o Office Solutions (sistema de 2003).

Atualizando Assemblies implantados (versão)

Se você implantar uma solução denominada OutlookAddin1 para a pasta C:\DeployFolder, a estrutura de arquivos será esta aparência:

C:\DeployFolder

Esta pasta contém o seguinte arquivo e subpasta:

  • O manifesto da implantação (OutlookAddin1.Aplicativo).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Esta pasta contém os seguintes arquivos:

    • Os assemblies.

    • O manifesto do aplicativo (OutlookAddin1.dll.manifest).

    • Uma Copiar do manifesto da implantação.

Se você atualizar o assembly e republicar a solução, a estrutura de diretório será esta aparência:

C:\DeployFolder

Esta pasta contém os seguintes arquivos e subpastas:

  • O manifesto da implantação (atualizado para apontar para o manifesto do aplicativo em C:\DeployFolder\OutlookAddin1_1.0.0.1).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Esta pasta contém os seguintes arquivos:

    • Os módulos Original.

    • O manifesto do aplicativo original.

    • O manifesto da implantação original.

    C:\DeployFolder\OutlookAddin1_1.0.0.1

    Esta pasta contém os seguintes arquivos:

    • Os assemblies atualizados.

    • O manifesto do aplicativo atualizado.

    • Uma Copiar do manifesto da implantação atualizado.

Essa estrutura será repetida sempre que você atualize o Adicionar no assembly.

Usando MSBuild na linha de comando

Você também pode usar MSBuild em um prompt de comando para publicar sua solução.Quando você usa o MSBuild em um prompt de comando, você pode publicar seus arquivos de solução para um local e modificar simultaneamente o manifesto da implantação e o manifesto do aplicativo atualizado para apontar para um local diferente.Para executar o MSBuild em um prompt de comando para publicar sua solução, use a sintaxe a seguir.

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Por exemplo, se você deseja publicar um projeto C# chamado OutlookAddin1 ao \\PublishServer\PublishFolder a pasta compartilhada, mas você pretende mover o manifesto da implantação, manifesto de aplicativo atualizado e o assembly do suplemento para a pasta compartilhada \\DeploymentServer\DeploymentFolder no futuro, você deve executar o comando a seguir.

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\OutlookAddin1\OutlookAddin1.csproj

Para obter mais informações sobre como usar o MSBuild em um prompt de comando, consulte Criando aplicativos de ClickOnce na linha de comando.

Implantando Adicionar-ins no Windows Vista

Se os usuários finais executar sua solução no Windows Vista, você deve levar as restrições de segurança do Windows Vista em consideração quando você configurar a implantação ou os usuários não poderão instalar atualizações.

Se você usar o Assistente de publicação para publicar atualizações Adicionar-in para um HTTP ou Local da Rede, usuários finais em computadores que estejam executando o Windows Vista pode carregar o assembly atualizações somente sob as seguintes condições:

  • O manifesto do aplicativo é instalado uma pasta no computador usuário final que pode ser modificado por um aplicativo com permissões padrão.

    - ou -

  • O usuário executa o aplicativo Microsoft Office com permissões de administrador.

Quando você publicar uma atualização para um Adicionar-in, o Tempo de execução Ferramentas do Visual Studio para o Office tenta copiar o manifesto do aplicativo atualizado para o usuário final computador na Avançar vez que o usuário abre o aplicativo.O tempo de execução, em seguida, usa as informações no manifesto do atualizado para carregar o assembly atualizado.No Windows Vista, os aplicativos executados com permissões padrão não é possível substituir arquivos em determinadas pastas, incluindo % ProgramFiles %.Portanto, se o manifesto do aplicativo estiver instalado em uma pasta que requer permissões de administrador, o aplicativo pode carregar o assembly atualizado apenas se o usuário executa o aplicativo como administrador.Como alternativa, o usuário pode executar o aplicativo com permissões padrão se o manifesto do aplicativo é instalado em uma pasta que não requer permissões de administrador, tais como % UserProfile %.

Observação:

Por padrão, t projeto de instalação he que é criado com Adicionar - projetos instala o aplicativo de manifesto para % CommonProgramFiles %.

Aplicativo e manifestos de implantação

Manifestos de aplicativo e implantação possibilitam um add-in atualizar propriamente dito com as últimas Assembly.For more information, see Aplicativo e manifestos de implantação in Office Solutions.

Você pode alterar o manifesto de aplicativo ou implantação de uma solução várias vezes durante a vida da solução.Existem dois motivos principais por que você deve atualizar os manifestos de:

Consulte também

Conceitos

Implantando soluções do Office (Sistema de 2003)

Instalação projetos para o nível de aplicativo Adicionar-ins (sistema de 2003)

Projetos de Instalação e Implantação

Referência

Entradas de registro para Application-Nível Adicionar-ins