MageUI.exe (Ferramenta de Geração e Edição de Manifesto, cliente gráfico)

 

MageUI.exe dá suporte à mesma funcionalidade que a ferramenta de linha de comando Mage.exe, mas com uma interface do usuário (UI) com base no Windows. Com essa ferramenta é possível criar, editar e assinar manifestos de implantação e aplicativo. Novos manifestos criados com MageUI.exe têm o .NET Framework 4 Client Profile como destino. As versões anteriores de MageUI.exe devem ser usadas para segmentar versões do .NET Framework anteriores. Adicionando ou removendo assemblies de um manifesto ou assinando novamente manifestos existente, MageUI.exe não atualiza o manifesto com o .NET Framework 4 Client Profile como destino. Para obter mais informações, consulte Mage.exe (Ferramenta de Geração e Edição de Manifesto).

Essa ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor (ou o Prompt de Comando do Visual Studio no Windows 7). Para obter mais informações, consulte Prompt de comando do desenvolvedor para o Visual Studio.

Duas versões de Mage.exe e de MageUI.exe estão incluídas como um componente da configuração do Visual Studio 2010. Para consultar informações da versão, execute MageUI.exe, selecione Ajuda e Sobre. Esta documentação descreve a versão 4.0.x.x de Mage.exe e de MageUI.exe.

System_CAPS_noteObservação

MageUI.exe não dá suporte ao elemento compatibleFrameworks durante a gravação de um manifesto de aplicativo já assinado com um certificado usando-se MageUI.exe. Em vez disso, você deve usar Mage.exe.

Lista de UIElement

A tabela a seguir lista os itens de menu e da barra de ferramentas disponíveis.

Comando

Menu

Atalho

Descrição

Manifesto do Aplicativo

Arquivo, Novo

Cria um novo manifesto de aplicativo.

Manifesto de Implantação

Arquivo, Novo

Cria um novo manifesto de implantação.

Abrir

Arquivo

CTRL+O

Abre um manifesto de implantação existente, o manifesto do aplicativo ou a licença de confiança para edição.

Fechar

Arquivo

CTRL+F4

Fecha um arquivo aberto.

Se você modificar um arquivo antes de fechá-lo, MageUI.exe solicitará uma nova assinatura do arquivo com uma chave pública, um par de chaves ou um certificado armazenado.

Salvar

Arquivo

CTRL+S

Salva em disco o documento que atualmente tem o foco de entrada do usuário.

Salvar Como

Arquivo

Salva um arquivo em disco, permitindo para fornecer um novo nome de arquivo e/ou um local.

Salvar Tudo

Arquivo

Salva as alterações feitas em todos os arquivos atualmente abertos no MageUI.exe.

Preferências

Arquivo

Abre a caixa de diálogo Preferências. Consulte a seguinte seção para obter mais informações.

Sair

Arquivo

ALT+F4

Encerra o MageUI.exe.

Recortar

Editar

CTRL+X

Remove o texto selecionado no momento do aplicativo e o move para a Área de Transferência do sistema.

Copiar

Editar

CTRL+C

Copia o texto selecionado no momento para a Área de Transferência do sistema.

Colar

Editar

CTRL+V

Cola o texto da Área de Transferência do sistema para o elemento de texto ativo no momento.

Excluir

Editar

Exclui um elemento selecionado no momento em uma lista, como uma licença de confiança no manifesto de implantação guia.

Fechar Tudo

Janela

Fecha todos os arquivos abertos no momento em MageUI.exe. Se um ou mais arquivos precisar de gravação, MageUI.exe solicitará que você os salve. MageUI.exe também solicita a seleção de uma chave de assinatura para cada arquivo não assinado ou alterado.

Sobre

Ajuda

Exibe informações de versão e direitos autorais sobre MageUI.exe.

A caixa de diálogo Preferências contém os elementos a seguir.

Elemento da Interface do Usuário

Descrição

Assinar ao salvar

Solicita a assinatura de um arquivo sempre que você salva as modificações.

Usar certificado de assinatura padrão

Usa a chave inserida na caixa de texto Arquivo de certificado para assinar todos os arquivos. Isso elimina o prompt de assinatura que normalmente é exibido quando você salva um arquivo e Assinar ao Salvar é selecionado. Use o botão de reticências () próximo à caixa de texto Arquivo de certificado para selecionar um arquivo de chave.

Algoritmo de resumo

Especifica o algoritmo com o qual gerar resumos de dependência. O valor deve ser "sha256RSA" ou "sha1RSA". Usa SHA1 como o padrão. Usado em manifestos de aplicativo e implantação. Se o usuário fornecer um certificado ao salvar o manifesto, ele usará os algoritmos no certificado para produzir resumos de dependência.

A caixa de diálogo Opções de Assinatura é exibida quando você salva um manifesto ou uma licença de confiança pela primeira vez, ou quando você altera um manifesto ou uma licença de confiança. Ela só será exibida se a opção Assinar ao Salvar na caixa de diálogo Preferências for selecionada. Você deve estar conectado à Internet ao assinar um manifesto que especifique um valor na caixa de texto URI de Carimbo de Data/Hora.

Essa caixa de diálogo contém os elementos a seguir.

Elemento da Interface do Usuário

Descrição

Assinar com arquivo de certificado

Assina o manifesto com um certificado digital armazenado no sistema de arquivos.

Arquivo

Fornece uma área para digitar o caminho para o arquivo. pfx que representa o certificado.

...

Abre uma Escolher arquivo caixa de diálogo para selecionar um arquivo. pfx existente.

Novo

Gera um novo .pfx que não é verificável por meio de uma CA (Autoridade de Certificação). Para obter mais informações sobre os tipos de certificados usados na assinatura ClickOnce implantações, consulte Visão geral da implantação de aplicativos confiáveis.

Senha

Fornece uma área para digitar a senha usada na assinatura desse certificado. Se não for aplicável, poderá ser deixado em branco.

Assinar com certificado armazenado

Exibe uma lista selecionável de certificados digitais armazenados no repositório de certificados do computador.

URI de Carimbo de Data/Hora

Exibe a URL (Uniform Resource Identifier) de um serviço de carimbo de data/hora digital. O carimbo de data/hora dos manifestos evita que você precise assinar novamente os manifestos, caso o certificado digital expire antes de implantar a próxima versão do aplicativo. Para obter mais informações, consulte membros do programa de certificado raiz do Windows e ClickOnce e Authenticode.

Não Assinar

Permite salvar o manifesto sem adicionar uma assinatura de um certificado digital.

Quando você abre um documento com MageUI.exe, ele é exibido dentro de sua própria página da guia. Cada guia contém um conjunto de painéis da propriedade. Os painéis contêm subconjuntos de dados do documento agrupados.

O manifesto do aplicativo guia exibe o conteúdo de um manifesto de aplicativo. O manifesto de aplicativo descreve todos os arquivos incluídos com a implantação e as permissões necessárias para o aplicativo seja executado no cliente.

O manifesto do aplicativo guia contém as seguintes guias.

Elemento da Interface do Usuário

Descrição

Nome

Especifica informações de identificação sobre essa implantação.

Descrição

Especifica o publicador, produto e suporte a informações.

Opções de aplicativo

Especifica se este é um aplicativo de navegador e se neste manifesto é a origem das informações de confiança.

Arquivos

Especifica que todos os arquivos que constituem essa implantação.

Permissões obrigatórias

Especifica o conjunto de permissões mínimas exigido pelo aplicativo para ser executado em um cliente.

O nome guia é exibida quando você primeiro cria ou abre um manifesto de aplicativo. Ele identifica exclusivamente a implantação e, opcionalmente, especifica uma plataforma de destino válido.

Elemento da Interface do Usuário

Descrição

Nome

Obrigatório. O nome do manifesto do aplicativo. Geralmente o mesmo que o nome do arquivo.

Versão

Obrigatório. O número da versão da implantação no formulário n.n.n. n. Somente o primeiro número de compilação principal é necessário. Por exemplo, inclui os valores válidos para a versão 1.0 de um aplicativo, 1, 1.0, 1.0.0, e 1.0.0.0.

Processador

Opcional. A arquitetura do computador no qual essa implantação pode ser executado. O padrão é msil, ou Microsoft Intermediate Language, que é o formato padrão de todos os assemblies gerenciados. Altere este campo se você tiver compilado previamente os assemblies em seu aplicativo para uma arquitetura específica. Para obter mais informações sobre pré-compilação, consulte Ngen.exe (Gerador de Imagens Nativas).

Cultura

Opcional. A duas partes país e região código ISO no qual o aplicativo é executado. O padrão é neutro.

Token de chave pública

Opcional. A chave pública com a qual o manifesto do aplicativo foi assinado. Se esse for um manifesto não assinado ou novo, este campo aparecerá como não assinados.

Normalmente, essas informações são fornecidas no manifesto de implantação. Esses campos podem ser modificados apenas se o usar aplicativos de manifesto confiança informações selecionada na caixa de seleção o Opções de aplicativo guia.

Elemento da Interface do Usuário

Descrição

Publisher

O nome da pessoa ou organização responsável pelo aplicativo. Esse valor é usado como o nome da pasta menu Iniciar.

Produto

O nome completo do produto. Se você selecionou instalar localmente para o tipo de aplicativo elemento o Opções de implantação guia do manifesto da implantação, esse nome será o que aparece no Iniciar link do menu e, em Adicionar ou remover programas para este aplicativo.

Suporte local

A URL da qual os clientes podem obter ajuda e suporte para o aplicativo.

Elemento da Interface do Usuário

Descrição

Aplicativo de navegador do Windows Presentation Foundation

Especifica se este é um aplicativo WPF que é executado no navegador como um aplicativo de navegador XAML (XBAP).

Use as informações de relação de confiança de manifesto do aplicativo

Especifica se esse manifesto contém informações de confiança.

Elemento da Interface do Usuário

Descrição

Diretório de aplicativo

O diretório no qual residem os arquivos do aplicativo. Use as reticências (...) para selecionar o diretório.

Preencher

Adiciona todos os arquivos no diretório de aplicativo e subdiretórios ao manifesto do aplicativo. Se MageUI.exe localiza um único arquivo executável no diretório, ele marcará automaticamente isso como o ponto de entrada, que é o arquivo executado pela primeira vez quando o aplicativo ClickOnce é iniciado no cliente.

Arquivos de aplicativo

Lista todos os arquivos do aplicativo. Cada arquivo tem três atributos editáveis, discutidos a seguir.

Tipo de arquivo

Tipo de arquivo pode ser um dos quatro valores:

  • Nenhum.

  • Ponto de entrada. Executável principal do aplicativo. Apenas um arquivo executável pode ser marcado como ponto de entrada.

  • Arquivo de dados. Um arquivo, como um arquivo XML, que fornece dados para o aplicativo.

  • Arquivo de ícone. Um ícone de aplicativo, como aparece na área de trabalho ou no canto superior da janela de um aplicativo.

Opcional

Arquivos marcados como opcionais não são baixados na instalação inicial ou atualização, mas podem ser baixados em tempo de execução usando a API do deployment sob demanda. Para obter mais informações, consulte Instruções passo a passo: baixando assemblies por demanda com a API de implantação do ClickOnce usando o designer.

Group

Um rótulo para um conjunto de arquivos opcionais. Você pode aplicar um rótulo de grupo a um conjunto de arquivos e usar a API sob demanda para fazer o download de um lote de arquivos com uma única chamada de API.

Use o permissões necessárias guia se você precisar conceder mais acesso ao computador local que é concedido por padrão ao seu aplicativo. Para obter mais informações, consulte Protegendo aplicativos ClickOnce.

Elemento da Interface do Usuário

Descrição

Tipo de conjunto de permissões

O conjunto de permissões mínimos necessário para este aplicativo seja executado no cliente. Para obter uma descrição desses conjuntos de permissão e quais permissões que eles ou não exigem, consulte NIB: Named Permission Sets.

Detalhes

O XML criado para o manifesto do aplicativo para representar a permissão definida. A menos que tenha um bom entendimento do formato XML de manifesto do aplicativo, você não deve editar esse XML manualmente. Para obter mais informações, consulte Manifesto de aplicativo ClickOnce.

O manifesto de implantação guia contém as seguintes guias.

Elemento da Interface do Usuário

Descrição

Nome

Especifica informações de identificação sobre essa implantação.

Descrição

Especifica o publicador, produto e suporte a informações.

Opções de implantação

Especifica informações adicionais sobre a implantação, como o tipo de aplicativo e o local de início.

Opções de atualização

Especifica com que freqüência ClickOnce deve verificar por atualizações de aplicativo.

Referência do aplicativo

Especifica o manifesto do aplicativo para essa implantação.

O nome guia é exibida quando você primeiro cria ou abre um manifesto de implantação. Ele identifica exclusivamente a implantação e, opcionalmente, especifica uma plataforma de destino válido.

Elemento da Interface do Usuário

Descrição

Nome

Obrigatório. O nome do manifesto de implantação. Geralmente o mesmo que o nome do arquivo.

Versão

Obrigatório. O número da versão da implantação no formulário n.n.n. n. Somente o primeiro número de compilação principal é necessário. Por exemplo, inclui os valores válidos para a versão 1.0 de um aplicativo, 1, 1.0, 1.0.0, e 1.0.0.0.

Processador

Opcional. A arquitetura do computador no qual essa implantação pode ser executado. O padrão é msil, ou Microsoft Intermediate Language, o formato padrão de todos os assemblies gerenciados. Altere este campo se você compilou os assemblies em seu aplicativo para uma arquitetura específica.

Cultura

Opcional. O código de país/região ISO duas partes em que esse aplicativo é executado. O padrão é neutro.

Token de chave pública

Opcional. A chave pública com a qual esse manifesto de implantação foi assinado. Se esse for um manifesto não assinado ou novo, este campo aparecerá como não assinados.

Elemento da Interface do Usuário

Descrição

Publisher

Obrigatório. O nome da pessoa ou organização responsável pelo aplicativo. Esse valor é usado como o nome da pasta menu Iniciar.

Produto

Obrigatório. O nome completo do produto. Se você selecionou instalar localmente para o tipo de aplicativo elemento o Opções de implantação guia, esse nome será o que aparece no Iniciar link do menu e, em Adicionar ou remover programas para este aplicativo.

Suporte local

Opcional. A URL da qual os clientes podem obter ajuda e suporte para o aplicativo.

Elemento da Interface do Usuário

Descrição

Tipo de Aplicativo

Opcional. Especifica se este aplicativo se instala no computador cliente (instalar localmente), é executada online (somente Online), ou é um aplicativo do WPF que executa no navegador (aplicativo de navegador WPF). O padrão é instalar localmente.

Local de origem

Opcional. A URL da qual o aplicativo realmente deve ser iniciado. Útil ao implantar um aplicativo a partir de um CD que deve atualizar o próprio da Web.

Incluir o local inicial (ProviderURL) no manifesto

Opcional. Especifica a URL que ClickOnce irá examinar as atualizações de aplicativos.

Aplicativos executados automaticamente após a instalação

Obrigatório. Especifica que o ClickOnce aplicativo deve ser executado imediatamente após a instalação inicial de uma URL. O padrão é que a caixa de seleção está selecionada.

Permitir que os parâmetros de URL a ser passado para o aplicativo

Obrigatório. Permite a transferência de dados do parâmetro para a ClickOnce aplicativo por meio de uma cadeia de caracteres de consulta acrescentada à URL do manifesto de implantação. O padrão é que a caixa de seleção está desmarcada.

Use a extensão de arquivo. Deploy

Obrigatório. Quando selecionada, todos os arquivos no manifesto do aplicativo devem ter a extensão. Deploy. O padrão é que a caixa de seleção está desmarcada.

O Opções de atualização guia contém apenas as opções mencionadas aqui quando o tipo de aplicativo caixa de seleção no nome for definido como instalar localmente.

Elemento da Interface do Usuário

Descrição

Esse aplicativo deve verificar por atualizações

Especifica se ClickOnce deve verificar por atualizações de aplicativo. Se essa caixa de seleção não estiver selecionada, o aplicativo não irá verificar atualizações, a menos que você atualizá-lo programaticamente usando as APIs no System.Deployment.Application namespace.

Escolha quando o aplicativo deve verificar por atualizações

Fornece duas opções para verificações de atualização:

  • Antes do início do aplicativo. A verificação de atualização é executada antes da execução do aplicativo.

  • Depois que o aplicativo é iniciado. A verificação de atualização começa quando o formulário principal do aplicativo foi inicializado e será executado na próxima vez que o aplicativo é iniciado.

Frequência de verificação de atualização

Determina com que freqüência ClickOnce deve verificar por atualizações:

  • Verifique sempre que o aplicativo é executado. ClickOnce executará uma verificação de atualização sempre que o usuário abre o aplicativo.

  • Verificar cada: selecionar um intervalo de tempo e uma unidade (horas, dias ou semanas) que deve decorrer antes de verificar se há atualizações.

Especificar uma versão mínima necessária para este aplicativo

Opcional. Especifica que uma versão específica do aplicativo é uma instalação necessária, impedindo que os usuários trabalhando com uma versão anterior.

Versão

Necessário se especificar uma versão mínima necessária para este aplicativo caixa de seleção está selecionada. O número de versão fornecido deve estar no formato n.n.n. n. Somente o primeiro número de compilação principal é necessário. Por exemplo, inclui os valores válidos para a versão 1.0 de um aplicativo, 1, 1.0, 1.0.0, e 1.0.0.0.

O referência Application guia contém os mesmos campos que o nome guia descrito anteriormente neste tópico. A única exceção é o campo a seguir.

Elemento da Interface do Usuário

Descrição

Selecione o manifesto

Permite que você escolha o manifesto do aplicativo. Todos os outros campos nessa página preencherá quando você escolhe um manifesto de aplicativo.

Mostrar: