Especificación de los archivos que se van a publicar mediante ClickOnce

  • Artículo

Al publicar una aplicación ClickOnce, todos los archivos que no son de código del proyecto se implementan junto con la aplicación. En algunos casos, es posible que no quiera o necesite publicar determinados archivos, o puede que desee instalar determinados archivos según las condiciones. Visual Studio ofrece funcionalidades para excluir archivos, marcarlos como archivos de datos o requisitos previos y crear grupos de archivos para la instalación condicional.

Los archivos de una aplicación ClickOnce se administran en el cuadro de diálogo Archivos de aplicación, al que se puede acceder desde la página Publicar del Diseñador de proyectos.

Inicialmente, hay un único grupo de archivos denominado (Obligatorio). Puede crear grupos de archivos adicionales y asignarles archivos. No se puede cambiar el grupo de descarga de los archivos necesarios para que se ejecute la aplicación. Por ejemplo, los archivos .exe de la aplicación o los marcados como archivos de datos deben pertenecer al grupo (Obligatorio).

El valor del estado de publicación predeterminado de un archivo se etiqueta con (Automático). Por ejemplo, el archivo .exe de la aplicación tiene un estado de publicación de Incluir (Automático) de forma predeterminada.

Los archivos con la propiedad Acción de compilación establecida en Contenido se designan como archivos de aplicación y se marcarán como incluidos de forma predeterminada. Estos archivos se pueden incluir, excluir o marcar como archivos de datos. Las excepciones son las siguientes:

  • Los archivos de datos como, por ejemplo, los archivos SQL Database (.mdf y .mdb) y los archivos XML se marcarán como archivos de datos de forma predeterminada.

  • Las referencias a ensamblados (archivos .dll) se designan de la siguiente manera cuando agrega la referencia: si Copiar en local es False, se marca de forma predeterminada como un ensamblado de requisitos previos (Requisito previo (Automático)) que debe estar presente en la GAC antes de instalar la aplicación. Si Copiar en local es True, el ensamblado se marca de forma predeterminada como un ensamblado de aplicación (Incluir (Automático)) y se copiará en la carpeta de la aplicación en la instalación. Una referencia COM aparecerá en el cuadro de diálogo Archivos de aplicación (como un archivo .ocx) solo si su propiedad Aislado está establecida en True. De forma predeterminada, se incluirá.

Para agregar archivos al cuadro de diálogo Archivos de aplicación

  1. Seleccione un archivo de datos en el Explorador de soluciones.

  2. En el ventana Propiedades, cambie la propiedad Acción de compilación al valor Contenido.

Para excluir archivos de la publicación de ClickOnce

  1. Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.

  2. Haga clic en la pestaña Publicar.

    Nota

    En ClickOnce para .NET Core 3.1 y .NET 5 o versiones posteriores, las propiedades de implementación se establecen mediante la herramienta Publicar, en lugar del Asistente para publicación y la página Publicar del Diseñador de proyectos. Para más información, consulte Implementación de una aplicación Windows de .NET con ClickOnce y ClickOnce para .NET.

  3. Haga clic en el botón Archivos de aplicación para abrir el cuadro de diálogo Archivos de aplicación.

  4. En el cuadro de diálogo Archivos de aplicación, seleccione el archivo que desea excluir.

  5. En el campo Estado de publicación, seleccione Excluir en la lista desplegable.

Para marcar archivos como archivos de datos

  1. Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.

  2. Haga clic en la pestaña Publicar.

  3. Haga clic en el botón Archivos de aplicación para abrir el cuadro de diálogo Archivos de aplicación.

  4. En el cuadro de diálogo Archivos de aplicación, seleccione el archivo que desea marcar como datos.

  5. En el campo Estado de publicación, seleccione Archivo de datos en la lista desplegable.

Para marcar los archivos como requisitos previos

  1. Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.

  2. Haga clic en la pestaña Publicar.

  3. Haga clic en el botón Archivos de aplicación para abrir el cuadro de diálogo Archivos de aplicación.

  4. En el cuadro de diálogo Archivos de aplicación, seleccione el ensamblado de la aplicación (archivo .dll) que desea marcar como requisito previo. Tenga en cuenta que la aplicación debe tener una referencia al ensamblado de la aplicación para que aparezca en la lista.

  5. En el campo Estado de publicación, seleccione Requisito previo en la lista desplegable.

Para agregar un nuevo grupo de archivos

  1. Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.

  2. Haga clic en la pestaña Publicar.

  3. Haga clic en el botón Archivos de aplicación para abrir el cuadro de diálogo Archivos de aplicación.

  4. En el cuadro de diálogo Archivos de aplicación, seleccione el campo Grupo de un archivo que desee incluir en el nuevo grupo.

    Nota

    Los archivos deben tener la propiedad Acción de compilación establecida en Contenido antes de que los nombres de archivo aparezcan en el cuadro de diálogo Archivos de aplicación.

  5. En el campo Grupo de descarga, seleccione <Nuevo...> en la lista desplegable.

  6. En el cuadro de diálogo Nuevo grupo, escriba un nombre para el grupo y, a continuación, haga clic en Aceptar.

Para agregar un archivo a un grupo

  1. Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.

  2. Haga clic en la pestaña Publicar.

  3. Haga clic en el botón Archivos de aplicación para abrir el cuadro de diálogo Archivos de aplicación.

  4. En el cuadro de diálogo Archivos de aplicación, seleccione el campo Grupo de un archivo que desee incluir en el nuevo grupo.

  5. En el campo Grupo de descarga, seleccione un grupo en la lista desplegable.

    Nota

    No se puede cambiar el grupo de descarga de los archivos necesarios para que se ejecute la aplicación.

Contenido relacionado