Especificar propiedades de publicación de ClickOnce

Puede configurar las propiedades Publicar de ClickOnce en la página Publicar del Diseñador de proyectos o mediante el Asistente para publicación. En este artículo, aprenderá a especificar propiedades básicas, como la ubicación de publicación, la dirección URL de instalación, el modo de instalación en línea o sin conexión y la versión de publicación.

Especificar una ubicación de publicación

Al publicar una aplicación mediante ClickOnce, la propiedad Publish Location especifica la ubicación donde se colocan los archivos de la aplicación y el manifiesto. La ubicación puede ser una ruta de acceso de archivo o la ruta de acceso a un servidor FTP.

La Publish Location propiedad se puede especificar en la página Publicar del Diseñador de proyectos o mediante el Asistente para publicación. Si precisa más información, consulte Procedimiento: Publicación de una aplicación ClickOnce sin usar el Asistente para publicación.

Nota

Cuando se instala más de una versión de una aplicación con ClickOnce, la instalación mueve las versiones anteriores de la aplicación a una carpeta llamada Archivo, en la ubicación de publicación que especifiques. Al archivar las versiones anteriores de esta manera, el directorio de instalación se mantiene limpio de carpetas de versiones anteriores.

  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 obtener más información, consulte Implementación de una aplicación Windows de .NET con ClickOnce y ClickOnce para .NET.

  3. En el campo Ubicación de publicación, escriba la ubicación de publicación mediante uno de los siguientes formatos:

    • Para publicar en un recurso compartido de archivos o en una ruta de acceso de disco, escriba la ruta mediante una ruta de acceso UNC (\\Server\NombreAplicación) o una ruta de acceso de archivo (C:\Deploy\NombreAplicación).

    • Para publicar en un servidor FTP, escriba la ruta de acceso con el formato ftp://ftp.microsoft.com/<NombreAplicación>.

      Tenga en cuenta que debe haber texto en el cuadro Ubicación de publicación para que el botón Examinar (...) funcione.

Especificación de la ubicación desde la que instalarán los usuarios finales

Al publicar una aplicación ClickOnce, la ubicación donde los usuarios van a descargar e instalar la aplicación no es necesariamente la ubicación donde se publica inicialmente la aplicación. Por ejemplo, en algunas organizaciones, un desarrollador podría publicar una aplicación en un servidor provisional y, a continuación, un administrador movería la aplicación a un servidor web.

En este caso, puede usar la propiedad Installation URL para especificar el servidor web donde los usuarios van a descargar la aplicación. Esto es necesario para que el manifiesto de aplicación sepa dónde buscar actualizaciones.

La propiedad Installation URL se puede establecer en la página Publicar del Diseñador de proyectos.

Nota

La propiedad Installation URL también se puede establecer mediante PublishWizard. Si precisa más información, consulte Cómo: Publicación de una aplicación ClickOnce sin usar el Asistente para publicación.

Especificar una URL de instalación

  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 obtener más información, consulte Implementación de una aplicación Windows de .NET con ClickOnce y ClickOnce para .NET.

  3. En el campo Dirección URL de instalación, escriba la ubicación de instalación mediante una dirección URL completa con el formato https://www.contoso.com/ApplicationName o una ruta de acceso UNC con el formato \Server\ApplicationName.

Especificación del modo de instalación en línea y sin conexión de ClickOnce

El modo Install Mode de una aplicación ClickOnce determina si la aplicación estará disponible sin conexión o en línea. Si elige La aplicación solo está disponible en línea, el usuario debe tener acceso a la ubicación de publicación de ClickOnce (ya sea una página web o un recurso compartido de archivos) para ejecutar la aplicación. Si elige La aplicación también está disponible sin conexión, la aplicación agregará entradas al menú Inicio y al cuadro de diálogo Agregar o quitar programas y el usuario podrá ejecutar la aplicación sin conexión.

Install Mode se puede establecer en la página Publicar del Diseñador de proyectos.

Nota:

Install Mode también se puede establecer mediante el Asistente para publicación. Si precisa más información, consulte Procedimiento: Publicación de una aplicación ClickOnce sin usar el Asistente para publicación.

Hacer que una aplicación ClickOnce solo esté disponible en línea

  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. En el área Modo y configuración de instalación, haga clic en el botón de la opción La aplicación solo está disponible en línea.

Hacer que una aplicación ClickOnce esté disponible en línea o sin conexión

  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. En el área Modo y configuración de instalación, haga clic en el botón de la opción La aplicación también está disponible sin conexión.

    Cuando se instala, la aplicación agrega entradas al menú Inicio y a Agregar o quitar programas en el Panel de control.

Establecimiento de la versión de publicación de ClickOnce

La propiedad Publish Version de ClickOnce determina si la aplicación que se está publicando se tratará o no como una actualización. Cada vez que se incrementa la versión, la aplicación se publica como una actualización.

La propiedad Publish Version se puede establecer en la página Publicar del Diseñador de proyectos.

Nota

Hay una opción de proyecto que incrementará automáticamente la propiedad Publish Version cada vez que se publica la aplicación; esta opción está habilitada de forma predeterminada. Para más información, consulte Incrementar automáticamente la versión de publicación de ClickOnce.

Cambiar la versión de publicación

  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. En el campo Publicar versión, incremente los números de versión principal, secundaria, compilación o revisión .

    Nota

    Nunca debe disminuir un número de versión; si lo hace, podría provocar un comportamiento de actualización imprevisible.

Incremento automático de la versión de publicación de ClickOnce

Al publicar una aplicación ClickOnce, cambiar la propiedad Publish Version hace que la aplicación se publique como una actualización. De forma predeterminada, Visual Studio incrementa automáticamente el Revisionnúmero del Publish Version cada vez que publica la aplicación.

Puede deshabilitar este comportamiento en la página Publicar del Diseñador de proyectos.

Nota

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas . Para obtener más información, vea Restablecer la configuración.

Deshabilitar el incremento automático de la versión de publicación

  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 obtener más información, consulte Implementación de una aplicación Windows de .NET con ClickOnce y ClickOnce para .NET.

  3. En la sección Publicar versión, desactive la casilla Incrementar automáticamente la revisión con cada versión.