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.
Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.
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.
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
Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.
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.
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
Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.
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.
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
Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.
Haga clic en la pestaña Publicar.
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
Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.
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.
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 Revision
nú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
Seleccione un proyecto en el Explorador de solucionesy, en el menú Proyecto , haga clic en Propiedades.
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.
En la sección Publicar versión, desactive la casilla Incrementar automáticamente la revisión con cada versión.
Contenido relacionado
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de