Compartir vía


Inclusión de un archivo de datos en una aplicación ClickOnce

A cada aplicación ClickOnce que instala se le asigna un directorio de datos en el disco local del equipo de destino en el que la aplicación puede administrar sus propios datos. Los archivos de datos pueden incluir archivos de cualquier tipo: archivos de texto, archivos XML o incluso archivos de base de datos de Microsoft Access (.mdb). Los procedimientos siguientes muestran cómo agregar un archivo de datos de cualquier tipo a la aplicación ClickOnce.

Nota:

En ClickOnce para .NET Core 3.1 y .NET 5, o posterior, use dotnet-mage.exe en lugar de Mage.exe. Para más información, consulte ClickOnce para .NET.

Para incluir un archivo de datos mediante Mage.exe

  1. Agregue el archivo de datos al directorio de la aplicación con el resto de los archivos de la aplicación.

    Normalmente, el directorio de la aplicación será un directorio etiquetado con la versión actual de la implementación, por ejemplo, v1.0.0.0.

  2. Actualice el manifiesto de aplicación para que muestre el archivo de datos.

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

    Al volver a crear esta tarea, se vuelve a crear la lista de archivos en el manifiesto de aplicación y también se generan automáticamente las signaturas hash.

  3. Abra el manifiesto de aplicación en el editor de texto o XML que prefiera y busque el elemento file del archivo que acaba de agregar.

    Si agregó un archivo XML denominado Data.xml, el archivo tendrá un aspecto similar al del ejemplo de código siguiente.

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

  4. Agregue el atributo type a este elemento y proporciónele un valor de data.

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

  5. Vuelva a firmar el manifiesto de aplicación mediante el par de claves o el certificado y, a continuación, vuelva a firmar el manifiesto de implementación.

    Debe volver a firmar el manifiesto de implementación porque su hash del manifiesto de aplicación ha cambiado.

    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 un archivo de datos mediante MageUI.exe

  1. Agregue el archivo de datos al directorio de la aplicación con el resto de los archivos de la aplicación.

  2. Normalmente, el directorio de la aplicación será un directorio etiquetado con la versión actual de la implementación, por ejemplo, v1.0.0.0.

  3. En el menú Archivo, haga clic en Abrir para abrir el manifiesto de aplicación.

  4. Seleccione la pestaña Archivos.

  5. En el cuadro de texto de la parte superior de la pestaña, escriba el directorio que contiene los archivos de la aplicación y, a continuación, haga clic en Rellenar.

    El archivo de datos aparecerá en la cuadrícula.

  6. Establezca el valor Tipo de archivo del archivo de datos en Datos.

  7. Guarde el manifiesto de aplicación y vuelva a firmar el archivo.

    MageUI.exe le pedirá que vuelva a firmar el archivo.

  8. Nueva firma del manifiesto de implementación

    Debe volver a firmar el manifiesto de implementación porque su hash del manifiesto de aplicación ha cambiado.