Compartir vía


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 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.

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.

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.

  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.

  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.

  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.

  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.

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

Especificación de una página de publicación para una aplicación ClickOnce

Al publicar una aplicación ClickOnce, se genera y publica una página web predeterminada (publish.htm) junto con esta aplicación. Esta página contiene el nombre de la aplicación, un vínculo para instalar la aplicación o cualquier requisito previo, y un vínculo a un Tema de ayuda que describe ClickOnce. La propiedad Publish Page del proyecto permite especificar un nombre para la página web de la aplicación ClickOnce.

Una vez especificada la página de publicación, la próxima vez que publique, se copiará en la ubicación de publicación en vez de sobrescribirse si vuelve a publicar. Si quiere personalizar el aspecto de la página, puede hacerlo sin preocuparse por perder los cambios. Para obtener más información, vea Personalizar la página web ClickOnce.

La propiedad Publish Page se puede establecer en el cuadro de diálogo Opciones de publicación, accesible desde el panel Publicar del Diseñador de proyectos.

Especificación de una página web personalizada para una aplicación ClickOnce:

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

  2. Seleccione el panel Publicar.

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

  4. Haga clic en Implementación.

  5. En el cuadro de diálogo Opciones de publicación, asegúrese de que la casilla Abrir la página web de implementación después de publicar está activada (debe seleccionarse de manera predeterminada).

  6. En el cuadro Página web de implementación, escriba el nombre de la página web y, después, haga clic en Aceptar.

Prevención de que la página de publicación se inicie cada vez que publique:

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

  2. Seleccione el panel Publicar.

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

  4. Haga clic en Implementación.

  5. En el cuadro de diálogo Opciones de publicación, desactive la casilla Abrir la página web de implementación después de publicar.

Personalización de la página web predeterminada para una aplicación ClickOnce

Al publicar una aplicación ClickOnce en la Web, se genera y publica automáticamente una página web junto con la aplicación. La página predeterminada contiene el nombre de la aplicación y vínculos para instalar la aplicación, instalar los requisitos previos o acceder a la ayuda en MSDN.

Nota:

Los vínculos reales que se ven en la página dependen del equipo en el que se está viendo la página y de los requisitos previos que se incluyen.

El nombre predeterminado de la página web es Publish.htm; puede cambiar el nombre en el Diseñador de proyectos. Para obtener más información, vea Especificación de una página de publicación para una aplicación ClickOnce.

La página web Publish.htm solo se publica si se detecta una versión más reciente.

Nota

Los cambios que realice en la configuración de publicación no afectarán a la página Publish.htm, con una excepción: si agrega o elimina requisitos previos después de la publicación inicial, la lista de requisitos previos dejará de ser exacta. Tendrá que editar el texto del vínculo de requisitos previos para reflejar los cambios.

Para personalizar la página web de publicación:

  1. Publique la aplicación ClickOnce en una ubicación web. Si precisa más información, consulte Publicación de una aplicación ClickOnce sin usar el Asistente para publicación.

  2. En el servidor web, abra el archivo Publish.htm en el Diseñador web visual u otro editor HTML.

  3. Personalice la página según sea necesario y guárdela.

  4. Opcional. Para evitar que Visual Studio sobrescriba la página web de publicación personalizada, desactive Generación automática de la página web de implementación después de cada publicación en el cuadro de diálogo Opciones de publicación.

Al publicar una aplicación ClickOnce, la propiedad Dirección URL de soporte técnico propiedad identifica una página web o un recurso compartido de archivos donde los usuarios pueden ir para obtener información sobre la aplicación. Esta propiedad es opcional; si se proporciona, la dirección URL se mostrará en el cuadro de diálogo Agregar o quitar programas de la aplicación.

La propiedad Dirección URL de soporte técnico se puede establecer en la página Publicar del Diseñador de proyectos.

Especificar una dirección URL de soporte técnico:

  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 Opciones para abrir el cuadro de diálogo Opciones de publicación.

  4. Haga clic en Descripción.

  5. En el campo Dirección URL de soporte técnico, escriba una ruta de acceso completa a un sitio web, una página web o un recurso compartido UNC.

Especificación de una dirección URL de soporte para requisitos previos individuales en una implementación ClickOnce

Una implementación de ClickOnce puede probar varios requisitos previos que deben estar disponibles en el equipo cliente para que se ejecute la aplicación ClickOnce. Estas dependencias incluyen la versión mínima necesaria de .NET Framework, la versión del sistema operativo y los ensamblados que se deben preinstalar en la caché global de ensamblados (GAC). ClickOnce, sin embargo, no puede instalar ninguno de estos requisitos previos por sí mismo; si no se encuentra un requisito previo, simplemente detiene la instalación y muestra un cuadro de diálogo que explica por qué se produjo un error en la instalación.

Hay dos métodos para instalar los requisitos previos. Puede instalarlos mediante una aplicación de programa previo. Como alternativa, puede especificar una dirección URL de soporte técnico para requisitos previos individuales, que se muestra a los usuarios en el cuadro de diálogo si no se encuentra el requisito previo. La página a la que hace referencia esa dirección URL puede contener vínculos a instrucciones para instalar el requisito previo necesario. Si una aplicación no especifica una dirección URL de soporte técnico para un requisito previo individual, ClickOnce muestra la dirección URL de soporte técnico especificada en el manifiesto de implementación para la aplicación en su conjunto, si está definida.

Aunque Visual Studio, Mage.exe y MageUI.exe se pueden usar para generar implementaciones de ClickOnce, ninguna de estas herramientas admite directamente la especificación de una dirección URL de soporte técnico para requisitos previos individuales. En este documento se describe cómo modificar el manifiesto de aplicación de la implementación y el manifiesto de implementación para incluir estas direcciones URL de soporte técnico.

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.

Especificación de una dirección URL de soporte técnico para requisitos previos individuales

  1. Abra el manifiesto de aplicación (el archivo .manifest) para la aplicación ClickOnce en un editor de texto.

  2. Para un requisito previo del sistema operativo, agregue el atributo supportUrl al elemento dependentOS:

     <dependency>
        <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
          <osVersionInfo>
            <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
          </osVersionInfo>
        </dependentOS>
      </dependency>
    
  3. Para obtener un requisito previo para una determinada versión de Common Language Runtime, agregue el atributo supportUrl a la entrada dependentAssembly que especifica la dependencia de Common Language Runtime:

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
          <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
        </dependentAssembly>
      </dependency>
    
  4. Para obtener un requisito previo para un ensamblado que se debe preinstalar en la caché global de ensamblados, establezca supportUrl para el elemento dependentAssembly que especifica el ensamblado necesario:

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
          <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
        </dependentAssembly>
      </dependency>
    
  5. Opcional. Para las aplicaciones que tienen como destino .NET Framework¹4, abra el manifiesto de implementación (el archivo .application) para la aplicación ClickOnce en un editor de texto.

  6. Para un requisito previo de .NET Framework 4, agregue el atributo supportUrl al elemento compatibleFrameworks:

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
      <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
      <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
    </compatibleFrameworks>
    
  7. Una vez que haya modificado manualmente el manifiesto de aplicación, debe volver a firmar el manifiesto de aplicación mediante el certificado digital y, a continuación, actualizar y volver a firmar el manifiesto de implementación. Use las herramientas del SDK de Mage.exe o MageUI.exe para realizar esta tarea, ya que la regeneración de estos archivos mediante Visual Studio borra los cambios manuales. Para obtener más información sobre el uso de Mage.exe para volver a firmar los manifiestos, consulte Cómo: Volver a firmar manifiestos de aplicación e implementación.

seguridad en .NET Framework

La dirección URL de soporte técnico no se muestra en el cuadro de diálogo si la aplicación está marcada para ejecutarse en confianza parcial.

Cambio del idioma de publicación de una aplicación ClickOnce

Al publicar una aplicación ClickOnce, la interfaz de usuario que se muestra durante la instalación tiene como valor predeterminado el idioma y la referencia cultural del equipo de desarrollo. Si va a publicar una aplicación localizada, deberá especificar un idioma y una referencia cultural para que coincidan con la versión localizada. Esto viene determinado por la propiedad Publish language del proyecto.

La propiedad Publish language se puede establecer en el cuadro de diálogo Opciones de publicación, accesible desde el panel 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.

Para cambiar el idioma 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. Haga clic en el botón Opciones para abrir el cuadro de diálogo Opciones de publicación.

  4. Haga clic en Descripción.

  5. En el cuadro de diálogo Opciones de publicación, seleccione un idioma y una referencia cultural en la lista desplegable Publicar idioma y, a continuación, haga clic en Aceptar.

Especificar un nombre de menú Inicio para una aplicación ClickOnce

Cuando se instala una aplicación ClickOnce para usarse en línea y sin conexión, se agrega una entrada al menú Inicio y a la lista de Agregar o quitar programas. De forma predeterminada, el nombre para mostrar es el mismo que el nombre del ensamblado de la aplicación, pero puede cambiar el nombre para mostrar estableciendo Nombre de producto en el cuadro de diálogo Opciones de publicación.

Nombre del producto se mostrará en la página publish.htm; en el caso de una aplicación sin conexión instalada, será el nombre de la entrada en el menú Inicio, y también será el nombre que se muestra en Agregar o quitar programas.

Nombre del publicador aparecerá en la página publish.htm, encima de Nombre del producto y, en el caso de una aplicación sin conexión instalada, también será el nombre de la carpeta que contiene el icono de la aplicación en el menú Inicio.

La referencia del menú Inicio o la aplicación se crea en %appdata%\Microsoft\Windows\Start Menu\Programs\<nombre del publicador>. La referencia de aplicación o acceso directo tiene el mismo nombre que el nombre del producto.

Puede establecer las propiedades Nombre del producto y Nombre del publicador en el cuadro de diálogo Opciones de publicación, que está disponible en la página Publicar del Diseñador de proyectos.

Para especificar un nombre en el menú Inicio:

  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 Opciones para abrir el cuadro de diálogo Opciones de publicación.

  4. Haga clic en Descripción.

  5. En el cuadro de diálogo Opciones de publicación, escriba el nombre que se mostrará en Nombre del producto.

  6. También puede escribir un nombre de publicador en Nombre del publicador.

Habilitar AutoStart para instalaciones con CD

Al implementar una aplicación ClickOnce mediante medios extraíbles como CD-ROM o DVD-ROM, puede habilitar AutoStart para que la aplicación ClickOnce se inicie automáticamente cuando se inserte el soporte físico.

AutoStart se puede activar en la página Publicar del Diseñador de Proyectos.

Para habilitar AutoStart:

  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 Opciones .

    Aparece el cuadro de diálogo Opciones de publicación.

  4. Haga clic en Implementación.

  5. Seleccione la casilla Para instalaciones en CD, iniciar automáticamente la instalación cuando se inserte el CD.

    Se copiará un archivo Autorun.inf en la ubicación de publicación cuando se publique la aplicación.