MageUI.exe (Ferramenta de Geração e Edição de Manifestos, Cliente Gráfico)

  • Artigo

MageUI.exe suporta a mesma funcionalidade que a ferramenta de linha de comandos Mage.exe, mas com uma interface de utilizador (IU) baseada no Windows. Com esta ferramenta, pode criar, editar e assinar manifestos de implementação e aplicações. Os novos manifestos criados com MageUI.exe visam o Perfil de Cliente do .NET Framework 4. As versões anteriores do MageUI.exe devem ser utilizadas para visar versões .NET Framework anteriores. Ao adicionar ou remover assemblagens de um manifesto ou voltar a assinar manifestos existentes, MageUI.exe não atualiza o manifesto para o .NET Framework 4 Perfil de Cliente. Para obter mais informações, veja Mage.exe (Geração de Manifestos e Ferramenta de Edição).

Esta ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, utilize a Linha de Comandos do Programador do Visual Studio ou o PowerShell para Programadores do Visual Studio.

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

Nota

MageUI.exe não suporta o elemento compatibleFrameworks ao guardar um manifesto de aplicação que já tenha sido assinado com um certificado com MageUI.exe. Em vez disso, tem de utilizar Mage.exe.

Lista de UIElement

A tabela seguinte lista o menu e os itens da barra de ferramentas que estão disponíveis.

Comando Menu Atalho Description
Manifesto da Aplicação Ficheiro, Novo Cria um novo manifesto de aplicação.
Manifesto de Implementação Ficheiro, Novo Cria um novo manifesto de implementação.
Abrir Ficheiro Ctrl+O Abre um manifesto de implementação existente, um manifesto de aplicação ou uma licença de confiança para edição.
Fechar Ficheiro Ctrl+F4 Fecha um ficheiro aberto.

Se modificar um ficheiro antes de o fechar, MageUI.exe pede-lhe para voltar a assinar o ficheiro com uma chave pública, um par de chaves ou um certificado armazenado.
Guardar Ficheiro CTRL+S Guarda no disco o documento que tem atualmente o foco de entrada do utilizador.
Guardar Como Ficheiro Guarda um ficheiro no disco, permitindo-lhe fornecer um novo nome de ficheiro e/ou localização.
Guardar Tudo Ficheiro Guarda as alterações efetuadas a todos os ficheiros atualmente abertos no MageUI.exe.
Preferências Ficheiro Abre a caixa de diálogo Preferências . Consulte a secção seguinte para obter mais informações.
Sair Ficheiro ALT+F4 Sai MageUI.exe.
Cortar Editar Ctrl+X Remove o texto atualmente selecionado da aplicação e move-o para a Área de Transferência do sistema.
Copiar Editar CTRL + C Copia o texto atualmente selecionado para a Área de Transferência do sistema.
Colar Editar CTRL + V Cola texto da Área de Transferência do sistema no elemento de texto atualmente ativo.
Eliminar Editar Elimina um elemento atualmente selecionado numa lista, como uma licença de fidedignidade no separador Manifesto de Implementação .
Fechar Tudo Janela Fecha todos os ficheiros atualmente abertos no MageUI.exe. Se um ou mais ficheiros precisarem de ser guardados, MageUI.exe pede-lhe que os guarde. MageUI.exe também lhe pede para selecionar uma chave de assinatura para cada ficheiro não assinado ou alterado.
Acerca de Help Apresenta informações sobre a versão e os direitos de autor sobre MageUI.exe.

Caixa de Diálogo Preferências

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

Elemento da IU Description
Iniciar sessão para guardar Pede-lhe para assinar um ficheiro sempre que guardar as modificações.
Utilizar o certificado de assinatura predefinido Utiliza a chave introduzida na caixa de texto Ficheiro de certificado para assinar todos os ficheiros. Esta ação elimina o pedido de assinatura que normalmente aparece quando guarda um ficheiro e a opção Iniciar sessão em Guardar está selecionada. Utilize o botão de reticências (...) junto à caixa de texto Ficheiro de certificado para selecionar um ficheiro de chave.
Algoritmo de resumo Especifica o algoritmo para gerar resumos de dependências com. O valor tem de ser "sha256RSA" ou "sha1RSA". Utiliza SHA1 como predefinição. Utilizado tanto em manifestos de aplicação como de implementação. Se o utilizador fornecer um certificado ao guardar o manifesto, utiliza os algoritmos no certificado para gerar resumos de dependências.

Caixa de Diálogo Opções de Assinatura

A caixa de diálogo Opções de Assinatura é apresentada quando guarda um manifesto ou uma licença de confiança pela primeira vez ou quando altera um manifesto ou uma licença de confiança. Só é apresentada se a opção Iniciar Sessão Guardar na caixa de diálogo Preferências estiver selecionada. Tem de estar ligado à Internet ao assinar um manifesto que especifique um valor na caixa de texto URI TimeStamping .

Esta caixa de diálogo contém os seguintes elementos.

Elemento da IU Description
Assinar com o ficheiro de certificado Assina o manifesto com um certificado digital armazenado no sistema de ficheiros.
Ficheiro Fornece uma área para escrever o caminho para o ficheiro .pfx que representa o certificado.
... Abre uma caixa de diálogo Escolher Ficheiro para selecionar um ficheiro .pfx existente.
Novo Gera um novo .pfx que não é verificável através de uma Autoridade de Certificação (AC). Para obter mais informações sobre os tipos de certificados utilizados para assinar implementações ClickOnce, veja Trusted Application Deployment Overview (Descrição Geral da Implementação de Aplicações Fidedignas).
Palavra-passe Fornece uma área para escrever a palavra-passe utilizada para assinar com este certificado. Se não for aplicável, pode ficar em branco.
Assinar com certificado armazenado Apresenta uma lista selecionável de certificados digitais armazenados no arquivo de certificados do seu computador.
TimeStamping URI Apresenta o Uniform Resource Locator (URI) de um serviço de timestamping digital. O timestamping dos manifestos impede que tenha de voltar a assinar os manifestos se o certificado digital expirar antes de implementar a próxima versão da sua aplicação. Para obter mais informações, veja Membros do programa de certificados de raiz do Windows e ClickOnce e Authenticode.
Não Assinar Permite-lhe guardar o manifesto sem adicionar uma assinatura a partir de um certificado digital.

Descrições do Separador e do Painel

Quando abre um documento com MageUI.exe, este é apresentado na sua própria página de separador. Cada separador contém um conjunto de painéis de propriedades. Os painéis contêm subconjuntas agrupadas dos dados do documento.

Separador Manifesto da Aplicação

O separador Manifesto da Aplicação apresenta o conteúdo de um manifesto de aplicação. O manifesto da aplicação descreve todos os ficheiros incluídos na implementação e as permissões necessárias para que a aplicação seja executada no cliente.

O separador Manifesto da Aplicação contém os seguintes separadores.

Elemento da IU Descrição
Nome Especifica a identificação de informações sobre esta implementação.
Descrição Especifica informações de publicador, produto e suporte.
Opções da Aplicação Especifica se se trata de uma aplicação de browser e se este manifesto é a origem das informações de confiança.
Ficheiros Especifica todos os ficheiros que constituem esta implementação.
Permissões Necessárias Especifica o conjunto de permissões mínimo exigido pela aplicação para ser executado num cliente.

Separador Nome

O separador Nome é apresentado quando cria ou abre um manifesto de aplicação pela primeira vez. Identifica exclusivamente a implementação e, opcionalmente, especifica uma plataforma de destino válida.

Elemento da IU Descrição
Nome Obrigatório. O nome do manifesto da aplicação. Normalmente, é igual ao nome do ficheiro.
Versão Obrigatório. O número da versão da implementação no formulário N.N.N.N. Só é necessário o primeiro número de compilação principal. Por exemplo, para a versão 1.0 de uma aplicação, os valores válidos incluem 1, 1.0, 1.0.0e 1.0.0.0.
Processador Opcional. A arquitetura da máquina na qual esta implementação pode ser executada. A predefinição é msil, ou Idioma Intermédio da Microsoft, que é o formato predefinido de todas as assemblagens geridas. Altere este campo se tiver compilado previamente as assemblagens na sua aplicação para uma arquitetura específica. Para obter mais informações sobre a pré-compilação, veja Ngen.exe (Native Image Generator).
Cultura Opcional. O código de país e região ISO em duas partes no qual esta aplicação é executada. A predefinição é neutral.
Token de chave pública Opcional. A chave pública com a qual este manifesto de aplicação foi assinado. Se este for um manifesto novo ou não assinado, este campo será apresentado como Unsigned.

Separador Descrição

Normalmente, estas informações são fornecidas no manifesto de implementação. Estes campos só podem ser modificados se a caixa de verificação Utilizar Informações de Fidedignidade do Manifesto de Aplicação estiver selecionada no separador Opções da Aplicação .

Elemento da IU Description
Publisher O nome da pessoa ou organização responsável pela aplicação. Este valor é utilizado como o nome da pasta do menu Iniciar.
Produto O nome completo do produto. Se tiver selecionado Instalar Localmente para o elemento Tipo de Aplicação no separador Opções de Implementação do manifesto de implementação, este nome será o que aparece na ligação do menu Iniciar e em Adicionar ou Remover Programas para esta aplicação.
Localização do Suporte O URL a partir do qual os clientes podem obter ajuda e suporte para a aplicação.

Separador Opções da Aplicação

Elemento da IU Description
Aplicação Windows Presentation Foundation Browser Especifica se se trata de uma aplicação WPF que é executada no browser como uma aplicação de browser XAML (XBAP).
Utilizar Informações de Fidedignidade do Manifesto de Aplicação Especifica se este manifesto contém informações de confiança.

Separador Ficheiros

Elemento da IU Description
Diretório de aplicações O diretório no qual residem os ficheiros da aplicação. Utilize o botão de reticências (...) para selecionar o diretório.
Preencher Adiciona todos os ficheiros no diretório e subdiretórios da aplicação ao manifesto da aplicação. Se MageUI.exe encontrar um único ficheiro executável no diretório, marca-o automaticamente como o Ponto de Entrada, que é o ficheiro executado pela primeira vez quando a aplicação ClickOnce é iniciada no cliente.
Ficheiros da Aplicação Lista todos os ficheiros na aplicação. Cada ficheiro tem três atributos editáveis, abordados abaixo.
Tipo de Ficheiro O Tipo de Ficheiro pode ser um dos quatro valores:

- Nenhuma.
- Ponto de Entrada. O executável principal da aplicação. Apenas um ficheiro executável pode ser marcado como o ponto de entrada.
- Ficheiro de Dados. Um ficheiro, como um ficheiro XML, que fornece dados à aplicação.
- Ficheiro de Ícone. Um ícone de aplicação, como aparece no ambiente de trabalho ou no canto da janela de uma aplicação.
Opcional Os ficheiros marcados como opcionais não são transferidos na instalação ou atualização inicial, mas podem ser transferidos no tempo de execução com a API System.Deployment On-Demand. Para obter mais informações, veja Instruções: Transferir Assemblagens a Pedido com a API de Implementação ClickOnce Utilizando o Estruturador.
Grupo Uma etiqueta para um conjunto de ficheiros opcionais. Pode aplicar uma etiqueta de Grupo a um conjunto de ficheiros e utilizar a API a Pedido para transferir um lote de ficheiros com uma única chamada à API.

Separador Permissões Necessárias

Utilize o separador Permissões Obrigatório se precisar de conceder à sua aplicação mais acesso ao computador local do que o concedido por predefinição. Para obter mais informações, veja Proteger Aplicações ClickOnce.

Elemento de IU Description
Tipo de conjunto de permissões O conjunto de permissões mínimo exigido por esta aplicação para ser executado no cliente. Para obter uma descrição destes conjuntos de permissões e que permissões exigem ou não, consulte Conjuntos de Permissões Nomeados.
Detalhes O XML criado para o manifesto da aplicação para representar o conjunto de permissões. A menos que tenha uma boa compreensão do formato XML do manifesto da aplicação, não deve editar este XML manualmente. Para obter mais informações, veja ClickOnce Application Manifest (Manifesto da Aplicação ClickOnce).

Separador Manifesto de Implementação

O separador Manifesto de Implementação contém os seguintes separadores.

Elemento de IU Descrição
Nome Especifica a identificação de informações sobre esta implementação.
Descrição Especifica informações de editor, produto e suporte.
Opções de Implementação Especifica informações adicionais sobre a implementação, como o tipo de aplicação e a localização de início.
Opções de Atualização Especifica a frequência com que o ClickOnce deve verificar a existência de atualizações de aplicações.
Referência da Aplicação Especifica o manifesto da aplicação para esta implementação.

Separador Nome

O separador Nome é apresentado quando cria ou abre um manifesto de implementação pela primeira vez. Identifica exclusivamente a implementação e, opcionalmente, especifica uma plataforma de destino válida.

Elemento de IU Descrição
Nome Obrigatório. O nome do manifesto de implementação. Normalmente, é o mesmo que o nome do ficheiro.
Versão Obrigatório. O número da versão da implementação no formulário N.N.N.N. Só é necessário o primeiro número de compilação principal. Por exemplo, para a versão 1.0 de uma aplicação, os valores válidos incluem 1, 1.0, 1.0.0e 1.0.0.0.
Processador Opcional. A arquitetura do computador na qual esta implementação pode ser executada. A predefinição é msil, ou Microsoft Intermediate Language, o formato predefinido de todas as assemblagens geridas. Altere este campo se tiver compilado as assemblagens na sua aplicação para uma arquitetura específica.
Cultura Opcional. O código de país/região ISO em duas partes no qual esta aplicação é executada. A predefinição é neutral.
Token de chave pública Opcional. A chave pública com a qual este manifesto de implementação foi assinado. Se este for um manifesto novo ou não assinado, este campo será apresentado como Unsigned.

Separador Descrição

Elemento de IU Description
Publisher Obrigatório. O nome da pessoa ou organização responsável pela aplicação. Este valor é utilizado como o nome da pasta do menu Iniciar.
Produto Obrigatório. O nome completo do produto. Se selecionou Instalar Localmente para o elemento Tipo de Aplicação no separador Opções de Implementação , este nome será o que aparece na ligação do menu Iniciar e em Adicionar ou Remover Programas para esta aplicação.
Localização do Suporte Opcional. O URL a partir do qual os clientes podem obter ajuda e suporte para a aplicação.

Separador Opções de Implementação

Elemento de IU Description
Tipo de Aplicação Opcional. Especifica se esta aplicação se instala no computador cliente (Instalar Localmente), é executada online (Apenas Online) ou se é uma aplicação WPF que é executada no browser (Aplicação do Browser WPF). A predefinição é Instalar Localmente.
Iniciar Localização Opcional. O URL a partir do qual a aplicação deve ser realmente iniciada. Útil ao implementar uma aplicação a partir de um CD que deve atualizar-se a partir da Web.
Incluir Localização inicial (ProviderURL) no manifesto Opcional. Especifica o URL que ClickOnce irá examinar para obter atualizações de aplicações.
Executar automaticamente a aplicação após a instalação Obrigatório. Especifica que a aplicação ClickOnce deve ser executada imediatamente após a instalação inicial a partir de um URL. A predefinição é a caixa de verificação selecionada.
Permitir que os parâmetros de URL sejam transmitidos para a aplicação Obrigatório. Permite a transferência de dados de parâmetros para a aplicação ClickOnce através de uma cadeia de consulta anexada ao URL do manifesto de implementação. A predefinição é a caixa de verificação estar desmarcada.
Utilizar a extensão de ficheiro .deploy Obrigatório. Quando selecionada, todos os ficheiros no manifesto da aplicação têm de ter a extensão .deploy. A predefinição é a caixa de verificação estar desmarcada.

Separador Opções de Atualização

O separador Opções de Atualização contém apenas opções mencionadas aqui quando a caixa de seleção Tipo de Aplicação no separador Nome está definida como Instalar Localmente.

Elemento da IU Description
Esta aplicação deve procurar atualizações Especifica se ClickOnce deve verificar a existência de atualizações de aplicações. Se esta caixa de verificação não estiver selecionada, a aplicação não procurará atualizações, a menos que a atualize programaticamente com as APIs no System.Deployment.Application espaço de nomes.
Escolher quando a aplicação deve procurar atualizações Fornece duas opções para verificações de atualização:

- Antes de a aplicação ser iniciada. A verificação de atualização é efetuada antes da execução da aplicação.
- Após o início da aplicação. A verificação de atualização começa assim que o formulário principal da aplicação for inicializado e será executada da próxima vez que a aplicação for iniciada.
Frequência de verificação de atualização Determina a frequência com que o ClickOnce deve procurar atualizações:

- Verifique sempre que a aplicação é executada. ClickOnce efetuará uma verificação de atualização sempre que o utilizador abrir a aplicação.
- Verificar a cada: selecione um intervalo de tempo e uma unidade (horas, dias ou semanas) que tem de decorrer antes de procurar atualizações.
Especificar uma versão mínima necessária para esta aplicação Opcional. Especifica que uma versão específica da sua aplicação é uma instalação necessária, impedindo os seus utilizadores de trabalharem com uma versão anterior.
Versão Necessário se a caixa de verificação Especificar uma versão mínima necessária para esta aplicação estiver selecionada. O número da versão fornecido tem de ser do formulário N.N.N.N. Só é necessário o primeiro número de compilação principal. Por exemplo, para a versão 1.0 de uma aplicação, os valores válidos incluem 1, 1.0, 1.0.0e 1.0.0.0.

Separador Referência da Aplicação

O separador Referência da Aplicação contém os mesmos campos que o separador Nome descrito anteriormente neste tópico. A única exceção é o seguinte campo.

Elemento da IU Description
Selecionar Manifesto Permite-lhe escolher o manifesto da aplicação. Todos os outros campos nesta página serão preenchidos quando escolher um manifesto de aplicação.

Ver também