Compartir a través de


Administración de actualizaciones de aplicaciones ClickOnce

Las aplicaciones ClickOnce pueden buscar actualizaciones automáticamente o mediante programación. Como desarrollador, tiene mucha flexibilidad para especificar cuándo y cómo se realizan las comprobaciones de actualización, si las actualizaciones son obligatorias y dónde debe buscar actualizaciones la aplicación.

Puede configurar la aplicación para comprobar si hay actualizaciones automáticamente antes de que se inicie la aplicación, o a intervalos establecidos después de que se inicie la aplicación. Además, puede especificar una versión mínima requerida; es decir, se instala una actualización si la versión del usuario es inferior a la versión necesaria.

Puede configurar la aplicación para buscar actualizaciones mediante programación en función de un evento, como una solicitud de usuario. El procedimiento "Para buscar actualizaciones mediante programación" en este tema muestra cómo escribiría código que usa la clase ApplicationDeployment para comprobar si hay actualizaciones basadas en un evento.

Nota

La clase ApplicationDeployment y las API del espacio de nombres System.Deployment.Application no se admiten en .NET Core y .NET 5 y versiones posteriores. En .NET 7 se admite un nuevo método de acceso a las propiedades de implementación de aplicaciones. Para obtener más información, consulte Acceso a las propiedades de implementación de ClickOnce en .NET. .NET 7 no admite el equivalente de los métodos ApplicationDeployment.

También puede implementar la aplicación desde una ubicación y actualizarla desde otra. Consulte el procedimiento "Para especificar una ubicación de actualización diferente".

Para más información, consulte Elegir una estrategia de actualización de ClickOnce.

El comportamiento de actualización se administra en el cuadro de diálogo Actualizaciones de la aplicación, disponible en la página Publicar del Diseñador de proyectos.

Para comprobar si hay actualizaciones antes de que se inicie la aplicació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 de Windows de .NET con ClickOnce y ClickOnce para .NET.

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

  4. En el cuadro de diálogo Actualizaciones de la aplicación, asegúrese de que la casilla de verificación La aplicación debe buscar actualizaciones esté seleccionada.

  5. En la sección Elegir cuándo debe buscar actualizaciones la aplicación, seleccione Antes de que se inicie la aplicación. Esto garantiza que los usuarios conectados a la red siempre ejecuten la aplicación con las actualizaciones más recientes.

Buscar actualizaciones en segundo plano después de iniciar la aplicació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. Haga clic en el botón Actualizaciones para abrir el cuadro de diálogo Actualizaciones de la aplicación.

  4. En el cuadro de diálogo Actualizaciones de la aplicación, asegúrese de que la casilla de verificación La aplicación debe buscar actualizaciones esté seleccionada.

  5. En la sección Elegir cuándo debe buscar actualizaciones la aplicación, seleccione Antes de que se inicie la aplicación. La aplicación se iniciará más rápidamente de esta manera y, a continuación, comprobará si hay actualizaciones en segundo plano y solo notificará al usuario cuando haya una actualización disponible. Una vez instalada, las actualizaciones no surtirán efecto hasta que se reinicie la aplicación.

  6. En la sección Especificar la frecuencia con la que la aplicación debe buscar actualizaciones , seleccione Comprobar cada vez que se ejecute la aplicación (valor predeterminado) o Comprobar cada y escriba un número y un intervalo de tiempo.

Nota

Esta tarea no es compatible en ClickOnce con .NET Core y .NET 5 o posterior. Para obtener más información, consulte ClickOnce para .NET.

Para especificar la versión mínima requerida para esta aplicació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. Haga clic en el botón Actualizaciones para abrir el cuadro de diálogo Actualizaciones de la aplicación.

  4. En el cuadro de diálogo Actualizaciones de la aplicación, asegúrese de que la casilla de verificación La aplicación debe buscar actualizaciones esté seleccionada.

  5. Seleccione la casilla de verificación Especificar una versión mínima necesaria para esta aplicación y, a continuación, escriba Números principales, secundarios, de compilación y de revisión para la aplicación.

Para especificar una ubicación de actualización diferente

  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 Actualizaciones para abrir el cuadro de diálogo Actualizaciones de la aplicación.

  4. En el cuadro de diálogo Actualizaciones de la aplicación, asegúrese de que la casilla de verificación La aplicación debe buscar actualizaciones esté seleccionada.

  5. En el campo Actualizar ubicación, escriba la ubicación de actualización con una dirección URL completa, con el formato http://Hostname/ApplicationName, o una ruta de acceso UNC con el formato \\Servidor\NombreAplicación, o haga clic en el botón Examinar para buscar la ubicación de actualización.

Para buscar actualizaciones mediante programació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. Haga clic en el botón Actualizaciones para abrir el cuadro de diálogo Actualizaciones de la aplicación.

  4. En el cuadro de diálogo Actualizaciones de la aplicación, asegúrese de que la casilla de verificación La aplicación debe buscar actualizaciones esté desactivada. (Opcionalmente, puede activar esta casilla de verificación para buscar actualizaciones mediante programación y también permitir que el tiempo de ejecución de ClickOnce compruebe automáticamente las actualizaciones).

  5. En el campo Actualizar ubicación, escriba la ubicación de actualización con una dirección URL completa, con el formato http://Hostname/ApplicationName, o una ruta de acceso UNC con el formato \\Servidor\NombreAplicación, o haga clic en el botón Examinar para buscar la ubicación de actualización. La ubicación de actualización es donde la aplicación buscará una versión actualizada de sí misma.

  6. Cree un botón, un elemento de menú u otro elemento de interfaz de usuario en un formulario de Windows Forms que los usuarios seleccionarán para buscar actualizaciones. Desde el controlador de eventos de ese elemento, active un método para buscar e instalar actualizaciones. Puede encontrar un ejemplo de código de Visual Basic y Visual C# para este método en Procedimientos para buscar actualizaciones de aplicaciones mediante programación a través de la API de implementación ClickOnce.

  7. Compilación de la aplicación.