Criando um instalador personalizado para uma solução Office ClickOnce

Você pode criar um programa personalizado de instalação para sua solução do Office, em vez de usar o instalador padrão que é criado pelas ferramentas de desenvolvimento do Office no Visual Studio. Por exemplo, você pode querer usar um script de logon para iniciar a instalação para soluções do Office, ou usar um arquivo em lotes para instalar a solução do Office sem interação do usuário. Esses cenários são ideais se os pré-requisitos estiverem instalados em computadores de usuário final.

Você pode instalar a solução sem abrir um aplicativo do Microsoft Office. Chame a ferramenta de instalação de solução do Office (VSTOInstaller.exe) como parte do processo. Por padrão, a ferramenta é instalada no seguinte local:

compartilhado de %commonprogramfiles% \ microsoft \ VSTO \ 11,0 \ VSTOInstaller.exe

Como alternativa, você pode usar a chave de Registro de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath para localizar o caminho para VSTOInstaller.exe.

Aplica-se a: As informações neste tópico se aplicam a projetos em níveis de documento e aplicativo para a Visualização do Microsoft Office 2013 e o Microsoft Office 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

parâmetros para VSTOInstaller.exe

A tabela a seguir explica os parâmetros que estão disponíveis.

Parâmetro

Definição

/Install ou /I

instalar a solução. Esta opção deve ser seguido pelo caminho de um manifesto de implantação. O caminho pode estar no computador local, um compartilhamento de (UNC) convenção de nomenclatura universal de, ou em um site de HTTP/HTTPS. O caminho pode ser local (c:\foldername\publishfolder), relativo (publish\), ou um local totalmente qualificado (\\servername\foldername ou https://servername/foldername).

/Uninstall ou /U

desinstalar a solução. Esta opção deve ser seguido pelo caminho de um manifesto de implantação. O caminho pode estar no computador local, um compartilhamento de UNC, ou em um site de HTTP/HTTPS. O caminho pode ser local (c:\foldername\publishfolder), relativo (publish\), ou um local totalmente qualificado (\\servername\foldername ou https://servername/foldername).

/Silent ou /S

Instalando ou desinstalar sem avisar para a entrada ou exibir as mensagens. Se um aviso de confiança é necessário, a personalização não está instalado ou não é atualizada.

ou /Help/?

Exibir informações de ajuda.

códigos de erro de VSTOInstaller

os seguintes códigos de erro são retornados por VSTOinstaller.exe.

código de erro

Definição

0

Um dos seguintes cenários ocorridos:

  • Ajuda de VSTOinstaller foi mostrada.

  • a solução foi instalada com êxito.

  • a solução foi desinstalada com êxito.

-100

Verificar as seguintes possibilidades:

  • Algumas opções de linha de comando foram definidas várias vezes. Certifique-se de que cada opção é definida apenas uma vez.

  • Por o menos uma opção de linha de comando é inválido.

tipo “vstoinstaller/?” para exibir a ajuda. Para obter mais informações, consulte Criando um instalador personalizado para uma solução Office ClickOnce.

-101

Por o menos uma opção de linha de comando é inválido. tipo “vstoinstaller/?” para exibir a ajuda.

-200

O URI de manifesto de implantação é inválido. tipo “vstoinstaller/?” para exibir a ajuda.

-201

A solução não pode ser instalado como o manifesto de implantação é inválido. Para obter mais informações, consulte Manifestos de implantação de soluções do Office.

-202

A solução não pode ser instalado como o Visual Studio para a seção do Office manifesto de aplicativo é inválido. Para obter mais informações, consulte Manifestos de aplicativo para soluções do Office.

-203

A solução não pôde ser instalado devido a um erro de download. Verifique o local do arquivo ou URI de rede do manifesto de implantação, e tente novamente.

-300

A solução não pôde ser instalado por causa de uma exceção de segurança. Para obter mais informações, consulte Protegendo soluções do Office.

-400

A solução não pôde ser instalado.

-401

A solução não pôde ser desinstalada.

-500

A operação foi cancelado. Um dos seguintes cenários ocorridos:

  • A solução não pôde ser instalado.

  • A solução não pôde ser desinstalada.

  • O manifesto de implantação não pôde ser baixada.

Consulte também

Tarefas

Como: instalar uma solução Office ClickOnce

Referência

Manifestos de implantação de soluções do Office

Manifestos de aplicativo para soluções do Office

Outros recursos

A publicação de soluções do Office usando o ClickOnce

A publicação de soluções do Office usando o ClickOnce