Compartir a través de

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 posterior, establezca las propiedades de implementación 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 Publish Location propiedad especifica la ubicación donde se colocan los archivos de aplicación y el manifiesto. Puede ser una ruta de acceso de unidad (C:\deploy\myapplication), un recurso compartido (\\server\myapplication) o un servidor FTP (ftp://ftp.microsoft.com/myapplication). Tenga en cuenta que el texto debe estar presente en el cuadro Ubicación de publicación para que el botón Examinar (...) funcione.

Puede especificar la Publish Location propiedad en la página Publicar del Diseñador de Proyectos o mediante el Asistente para Publicar. Para obtener más información, vea How to: Publish a ClickOnce Application using the Publish Wizard.

Nota:

Al instalar más de una versión de una aplicación mediante ClickOnce, la instalación mueve las versiones anteriores de la aplicación a una carpeta denominada Archive, en la ubicación de publicación que especifique. El archivado de versiones anteriores de esta manera mantiene el directorio de instalación claro de las carpetas de la versión anterior.

  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 una carpeta compartida o una ruta de disco, escriba la ruta mediante una ruta UNC (\\Server\ApplicationName) o una ruta de archivo (C:\Deploy\ApplicationName).

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

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

Especificar la ubicación desde la que se 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 en la que 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 Installation URL propiedad 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 Installation URL propiedad se puede establecer en la página Publicar del Diseñador de proyectos.

Nota:

La Installation URL propiedad también se puede establecer mediante PublishWizard. Para obtener más información, vea Cómo: Publicar una aplicación ClickOnce mediante el Asistente para publicación.

Especificar una dirección 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/ApplicationNameo una ruta de acceso UNC con el formato \Server\ApplicationName.

Especificar el modo de instalación sin conexión o en línea de ClickOnce

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

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

Nota:

El Install Mode también se puede establecer usando el Asistente para Publicación. Para obtener más información, vea Cómo: Publicar una aplicación ClickOnce mediante 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 de instalación y configuración , haga clic en el botón de 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 de instalación y configuración, haga clic en el botón de opción La aplicació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.

Establecer la versión de publicación de ClickOnce

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

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

Cuando se cambia el número de versión, la aplicación se publica como una actualización. Cada parte de la versión de publicación (principal, secundaria, compilación, revisión) puede tener un valor máximo de 65535 (MaxValue), el máximo permitido por Version.

Al instalar más de una versión de una aplicación mediante ClickOnce, la instalación mueve las versiones anteriores de la aplicación a una carpeta denominada Archive, en la ubicación de publicación que especifique. El archivado de versiones anteriores de esta manera mantiene el directorio de instalación claro de las carpetas de la versión anterior.

Nota:

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

Cambiar la versión de publicación

  1. Con un proyecto seleccionado en el Explorador de soluciones, 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 debería disminuir un número de versión; si lo hace, podría provocar un comportamiento de actualización imprevisible.

Incrementar automáticamente la versión de publicación de ClickOnce

Al publicar una aplicación ClickOnce, cambiar la Publish Version propiedad hace que la aplicación se publique como una actualización. De forma predeterminada, Visual Studio incrementa automáticamente el número del Revision de 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 los comandos de menú que vea pueden diferir de los descritos en Ayuda en función de la configuración activa o edición. Para cambiar la configuración, elija Importar y Exportar Configuración en el 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 .

Especificar 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 la 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; no se sobrescribirá si vuelve a publicar. Si desea personalizar la apariencia de la página, puede hacerlo sin preocuparse por perder los cambios. Para obtener más información, vea Personalizar la página web predeterminada de ClickOnce.

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

Para especificar una página web personalizada para una aplicación ClickOnce:

  1. Con un proyecto seleccionado en el Explorador de soluciones, 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 página web de implementación después de publicar está activada (debe seleccionarse de forma predeterminada).

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

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

  1. Con un proyecto seleccionado en el Explorador de soluciones, 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 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 ve en la página dependen del equipo en el que se está viendo la página y de los requisitos previos que incluya.

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, consulte Especificar una página de publicación para una aplicación ClickOnce.

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

Nota:

Los cambios realizados en la configuración de publicación no afectarán a la página dePublish.htm , con una excepción: si agrega o quita requisitos previos después de publicar inicialmente, la lista de requisitos previos ya no será precisa. Deberá 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. Para obtener más información, vea Cómo: Publicar una aplicación ClickOnce mediante 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 Generar automáticamente 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 URL de soporte identifica una página web o un recurso compartido de archivos donde los usuarios pueden 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 URL de soporte se puede establecer en la página Publicar del Diseñador de Proyectos.

Para 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, escriba una ruta de acceso completa a un sitio web, página web o recurso compartido UNC.

Especificar una 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; 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 bootstrapper. 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 se define.

Aunque Visual Studio, Mage.exey 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 y el manifiesto de implementación para incluir estas direcciones URL de soporte.

Nota:

En ClickOnce para .NET Core 3.1 y .NET 5 o posterior, establezca las propiedades de implementación 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 dirección URL de soporte técnico para un requisito previo individual

  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 supportUrl atributo al dependentOS elemento :

     <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 supportUrl atributo a la dependentAssembly entrada 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 un requisito previo de un ensamblado que debe preinstalarse en la caché global de ensamblados, establezca supportUrl para el elemento dependentAssembly que especifica el ensamblado requerido.

      <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 supportUrl atributo al compatibleFrameworks elemento :

    <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 deMage.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 manifiestos, vea Cómo: Volver a firmar manifiestos de implementación y aplicación.

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

Nota:

En ClickOnce para .NET Core y .NET 5 o posterior, no se admite la confianza parcial, que requiere seguridad de acceso al código. En .NET Framework, el uso de seguridad de acceso a código no es un procedimiento recomendado y no se recomienda.

Cambiar el 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 está determinado por la propiedad Publish language de tu proyecto.

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

Nota:

Los cuadros de diálogo y los comandos de menú que vea pueden diferir de los descritos en Ayuda en función de la configuración activa o edición. Para cambiar la configuración, elija Importar y Exportar Configuración en el 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 posterior, establezca las propiedades de implementación 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 el uso en línea y sin conexión, se agrega una entrada al menú Inicio y a la lista 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.

El nombre del producto se mostrará en la página depublish.htm ; para 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.

El nombre del publicador aparecerá en la página depublish.htm encima del nombre del producto y, para 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 de la aplicación se crea en %appdata%\Microsoft\Windows\Menú Inicio\Programas\<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, disponible en la página Publicar del Diseñador de proyectos.

Para especificar un nombre de 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 va a mostrar en Nombre del producto.

  6. Opcionalmente, puede escribir un nombre de publicador en Nombre del publicador.

Habilitación de AutoStart para instalaciones de 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 medio.

AutoStart se puede habilitar en la página Publicar del Diseñador de proyectos.

Para habilitar AutoStart:

  1. Con un proyecto seleccionado en el Explorador de soluciones, 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 For CD installations, inicie automáticamente el programa de instalación al insertar el CD.

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

Contenido relacionado