Partilhar via


Incluir um arquivo de dados em um aplicativo ClickOnce

Cada aplicativo ClickOnce instalado recebe um diretório de dados no disco local do computador de destino, onde o aplicativo pode gerenciar os próprios dados. Arquivos de dados podem incluir arquivos de qualquer tipo: arquivos de texto, arquivos XML ou até mesmo arquivos de banco de dados do Microsoft Access (.mdb). Os procedimentos a seguir mostram como adicionar um arquivo de dados de qualquer tipo ao aplicativo ClickOnce.

Observação

No ClickOnce para .NET Core 3.1 e .NET 5 ou posterior, use dotnet-mage.exe em vez de Mage.exe. Para obter mais informações, confira ClickOnce para .NET.

Para incluir um arquivo de dados usando Mage.exe

  1. Adicione o arquivo de dados ao diretório do aplicativo com o restante dos arquivos do aplicativo.

    Normalmente, o diretório do aplicativo será um diretório rotulado com a versão atual da implantação, por exemplo, v1.0.0.0.

  2. Atualize o manifesto do aplicativo para listar o arquivo de dados.

    mage -u v1.0.0.0\Application.manifest -FromDirectory v1.0.0.0

    Executar essa tarefa recria a lista de arquivos no manifesto do aplicativo e também gera automaticamente as assinaturas de hash.

  3. Abra o manifesto do aplicativo em seu editor de texto ou de XML preferido e localize o elemento file para o arquivo recém-adicionado.

    Se você adicionou um arquivo XML chamado Data.xml, o arquivo será semelhante ao exemplo de código a seguir.

    <file name="Data.xml" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

  4. Adicione o atributo type a esse elemento e forneça a ele um valor de data.

    <file name="Data.xml" writeableType="applicationData" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

  5. Assine novamente o manifesto do aplicativo usando seu par de chaves ou certificado e assine novamente o manifesto de implantação.

    Você precisa assinar novamente o manifesto de implantação porque o hash do manifesto do aplicativo foi alterado.

    mage -s app manifest -cf cert_file -pwd password

    mage -u deployment manifest -appm app manifest

    mage -s deployment manifest -cf certfile -pwd password

Para incluir um arquivo de dados usando MageUI.exe

  1. Adicione o arquivo de dados ao diretório do aplicativo com o restante dos arquivos do aplicativo.

  2. Normalmente, o diretório do aplicativo será um diretório rotulado com a versão atual da implantação, por exemplo, v1.0.0.0.

  3. No menu Arquivo, clique em Abrir para abrir o manifesto do aplicativo.

  4. Selecione a guia Arquivos.

  5. Na caixa de texto na parte superior da guia, insira o diretório que contém os arquivos do aplicativo e clique em Popular.

    O arquivo de dados será exibido na grade.

  6. Defina o valor Tipo de Arquivo do arquivo de dados como Dados.

  7. Salve o manifesto do aplicativo e assine o arquivo novamente.

    MageUI.exe solicitará que você assine novamente o arquivo.

  8. Assinar novamente o manifesto de implantação

    Você precisa assinar novamente o manifesto de implantação porque o hash do manifesto do aplicativo foi alterado.