Manifestos de aplicativo para soluções do Office
Um manifesto de aplicativo é um arquivo XML que descreve os assemblies que são carregados em uma solução do Microsoft Office. As ferramentas de desenvolvimento do Microsoft Office no Visual Studio usam o esquema de manifesto do aplicativo ClickOnce definido na referência de manifesto do aplicativo ClickOnce.
Os manifestos de aplicativo para soluções do Office usam os seguintes elementos e atributos ClickOnce.
| Element | Descrição | Atributos |
|---|---|---|
| <Elemento assembly> (aplicativo ClickOnce) | Obrigatório. Elemento de nível superior. | manifestVersion |
| <Elemento assemblyIdentity> (aplicativo ClickOnce) | Obrigatório. Identifica o assembly primário do aplicativo ClickOnce. | name version publicKeyToken processorArchitecture linguagem |
| <Elemento trustInfo> (aplicativo ClickOnce) | Identifica os requisitos de segurança do aplicativo. | Nenhum |
| <Elemento entryPoint> (aplicativo ClickOnce) | Obrigatório. Identifica o ponto de entrada do código do aplicativo para execução. | name dependencyName customHostSpecified |
| <Elemento de dependência> (aplicativo ClickOnce) | Obrigatório. Identifica cada dependência necessária para que o aplicativo seja executado. Como opção, identifica assemblies que precisam ser pré-instalados. | Nenhum |
| <Elemento file> (aplicativo ClickOnce) | Obrigatório. Identifica cada arquivo não-assembly que é usado pelo aplicativo. Pode incluir dados de isolamento COM (Component Object Model) associados ao arquivo. | name size |
Os manifestos de aplicativo para soluções do Office têm o seguinte elemento no co.v1 namespace.
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Esses manifestos de aplicativo também têm os seguintes elementos e atributos no vstav3 namespace.
<addIn>
<entryPointsCollection>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
</entryPointsCollection>
<update></update>
<postActions>
<postAction>
<postActionData>
</postActionData>
<postAction>
</postActions>
<application>
<customizations>
<customization>
</customization>
</customizations>
</application
</addIn>
| Element | Descrição | Atributos |
|---|---|---|
| <Elemento customHostSpecified> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Marca o manifesto especificamente como uma solução do Office. | Nenhum |
| <Elemento addin> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Armazena pontos de entrada em um único namespace. | Nenhum |
| <Elemento entryPointsCollection> (desenvolvimento do Office no Visual Studio) | Obrigatório. Agrupa todos os assemblies para uma ou mais soluções do Office. | id |
| <Elemento entryPoints> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Agrupa todos os assemblies para executar uma solução do Office. | Nenhum |
| <Elemento entryPoint> (desenvolvimento do Office no Visual Studio) | Obrigatório. Identifica o assembly a ser executado em uma solução do Office. | class contrato |
| <Elemento update> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Configura atualizações para a solução. | Habilitado expiration |
| <Elemento postActions> (Desenvolvimento do Office no Visual Studio) | Opcional. Agrupa todas as ações pós-implantação, que são executadas após a instalação das soluções do Office. | Nenhum |
| <Elemento postAction> (Desenvolvimento do Office no Visual Studio) | Opcional. Identifica uma ação pós-implantação. | Nenhum |
| <Elemento postActionData> (Desenvolvimento do Office no Visual Studio) | Opcional. Configura dados para uma ação pós-implantação. | Nenhum |
| <Elemento de aplicativo> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Encapsula as informações específicas do aplicativo em um único nó. | Nenhum |
| <Elemento customizations> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Armazena todas as informações específicas do host do aplicativo em um namespace separado. | Nenhum |
| <> Elemento customization (Desenvolvimento do Office no Visual Studio) | Obrigatório. Armazena informações específicas do host do aplicativo em um namespace separado. | xmlns |
| <Elemento document> (Desenvolvimento do Office no Visual Studio) | Necessário apenas para soluções em nível de documento. Armazena informações específicas de personalização. | solutionId |
| <Elemento appAddin> (Desenvolvimento do Office no Visual Studio) | Necessário apenas para soluções em nível de aplicativo. Armazena informações específicas de personalização. | application loadBehavior keyName |
| <Elemento friendlyName> (Desenvolvimento do Office no Visual Studio) | Opcional. Armazena o nome do suplemento VSTO que aparece na lista de suplementos VSTO instalados. | Nenhum |
| <elemento description> (desenvolvimento do Office no Visual Studio) | Necessário apenas para suplementos VSTO. Armazena a descrição que aparece na lista de programas instalados. | Nenhum |
| <Elemento formRegions> (Desenvolvimento do Office no Visual Studio) | Necessário apenas para suplementos VSTO do Outlook que incluem regiões de formulário. | Nenhum |
| <Elemento formRegion> (Desenvolvimento do Office no Visual Studio) | Necessário apenas para suplementos VSTO do Outlook que incluem regiões de formulário. | Nome |
| <Elemento vstoRuntime> (Desenvolvimento do Office no Visual Studio) | Obrigatório. Descreve uma versão específica do Visual Studio Tools for Office runtime que é suportada pela solução do Office. | release version supportUrl |
Comentários
Você pode editar manualmente manifestos de aplicativo e implantação em soluções do Office. Depois, você deve assinar novamente os manifestos de aplicativo e implantação usando a Ferramenta de Geração e Edição de Manifesto (mage.exe e mageui.exe). Para obter mais informações, confira Como assinar novamente manifestos de aplicativo e implantação.
Local do arquivo
Um manifesto de aplicativo é específico para uma única versão de uma solução. Por esse motivo, os manifestos do aplicativo devem ser armazenados separadamente dos manifestos de implantação. O Visual Studio coloca os arquivos específicos da versão em um subdiretório com o nome da versão associada no subdiretório Arquivos de Aplicativo na pasta de publicação.
Sintaxe de nome de arquivo
O nome de um arquivo de manifesto do aplicativo deve ser o nome completo e a extensão do aplicativo, conforme identificado no elemento assemblyIdentity , seguido pela extensão .manifest. Por exemplo, um manifesto de aplicativo que se refere à personalização do OutlookAddIn1.dll usaria a seguinte sintaxe de nome de arquivo.
OutlookAddIn1.dll.manifest