Información general sobre las aplicaciones de explorador XAML de WPF

Artículo
05/04/2023

Las aplicaciones de explorador XAML (XBAP) combinan características tanto de las aplicaciones web como de las aplicaciones cliente enriquecidas. Al igual que las aplicaciones web, las aplicaciones XBAP se pueden implementar en un servidor web e iniciar desde Internet Explorer o Firefox en Windows. Al igual que las aplicaciones cliente enriquecidas, las aplicaciones XBAP pueden aprovechar las funcionalidades de WPF. El desarrollo de aplicaciones XBAP también se parece al desarrollo de clientes enriquecidos. En este tema se proporciona una sencilla introducción de alto nivel al desarrollo de aplicaciones XBAP y se describe en qué se diferencia este del desarrollo estándar de clientes enriquecidos.

Advertencia

Las aplicaciones XBAP requieren exploradores heredados, como Internet Explorer y Firefox. Estas versiones anteriores del explorador suelen no ser compatibles con Windows 10 y Windows 11. Los exploradores modernos ya no admiten la tecnología necesaria para las aplicaciones XBAP debido a riesgos de seguridad. Los complementos que habilitan XBAPs ya no se admiten.

Este tema contiene las siguientes secciones:

Creación de una aplicación de explorador XAML (XBAP)
Implementación de una aplicación XBAP
Comunicación con la página web host
Consideraciones de seguridad para XBAP
Consideraciones sobre el rendimiento de tiempo de inicio de XBAP

Creación de una aplicación de explorador XAML (XBAP)

La manera más sencilla de crear un proyecto de XBAP es con Visual Studio. Al crear un proyecto, seleccione Aplicación de explorador WPF en la lista de plantillas. Para obtener más información, vea Cómo: Crear un nuevo proyecto de aplicación de explorador de WPF.

Cuando se ejecuta el proyecto de XBAP, se abre en una ventana del explorador en lugar de en una independiente. Cuando se depura la aplicación XBAP desde Visual Studio, la aplicación se ejecuta con permisos de zona de Internet y, por tanto, genera excepciones de seguridad si se superan esos permisos. Para más información, consulte Seguridad y Seguridad de confianza parcial de WPF.

Nota:

Si no va a usar Visual Studio para el desarrollo o quiere aprender más sobre los archivos de proyecto, consulte Compilar una aplicación WPF.

Implementación de una aplicación XBAP

Cuando se compila una aplicación XBAP, en la salida se incluyen los tres archivos siguientes:

Archivo	Descripción
Ejecutable (.exe)	Contiene el código compilado y tiene la extensión .exe.
Manifiesto de aplicación (.manifest)	Contiene metadatos asociados con la aplicación y tiene la extensión .manifest.
Manifiesto de implementación (.xbap)	Este archivo contiene la información que ClickOnce utiliza para implementar la aplicación y tiene la extensión .xbap.

Puede implementar las aplicaciones XBAP en un servidor web, por ejemplo, Microsoft Internet Information Services (IIS) 5.0 o versiones posteriores. No es necesario instalar .NET Framework en el servidor web, pero sí debe registrar los tipos de extensiones de correo multipropósito de Internet (MIME) de WPF y las extensiones de nombre de archivo. Para más información, consulte Cómo: Configurar IIS 5.0 e IIS 6.0 para implementar aplicaciones WPF.

Para preparar la aplicación XBAP para la implementación, copie el archivo .exe y los manifiestos asociados al servidor web. Cree una página HTML que contenga un hipervínculo para abrir el manifiesto de implementación, que es el archivo con la extensión .xbap. Cuando el usuario hace clic en el vínculo al archivo .xbap, ClickOnce controla automáticamente el mecanismo de descarga e inicio de la aplicación. En el ejemplo de código siguiente, se muestra una página HTML que contiene un hipervínculo que apunta a una aplicación XBAP.

<html>
    <head></head>
    <body>
        <a href="XbapEx.xbap">Click this link to launch the application</a>
    </body>
</html>

También puede hospedar una aplicación XBAP en el marco de una página web. Cree una página web con uno o varios marcos. Establezca la propiedad de origen de un marco en el archivo de manifiesto de implementación. Si desea usar el mecanismo integrado para la comunicación entre la página web que hospeda y la aplicación XBAP, debe hospedar la aplicación en un marco. En el ejemplo de código siguiente, se muestra una página HTML con dos marcos, donde el origen del segundo marco está establecido en una aplicación XBAP.

<html>
    <head>
        <title>A page with frames</title>
    </head>
    <frameset cols="50%,50%">
        <frame src="introduction.htm">
        <frame src="XbapEx.xbap">
    </frameset>
</html>

Borrado de las aplicaciones XBAP en caché

En algunas situaciones, después de volver a compilar e iniciar la aplicación XBAP, es posible que se abra una versión anterior de ella. Por ejemplo, este comportamiento puede producirse cuando el número de versión del ensamblado XBAP es estático y se inicia la aplicación XBAP desde la línea de comandos. En este caso, como no ha cambiado el número de versión entre la versión almacenada en caché (la que se inició previamente) y la nueva versión, no se descarga la nueva versión de la aplicación XBAP. En su lugar, se carga la versión almacenada en caché.

En estas situaciones, puede quitar la versión almacenada en caché mediante el comando Mage (instalado con Visual Studio o Windows SDK) en el símbolo del sistema. Con el siguiente comando se borra la memoria caché de la aplicación.

Mage.exe -cc

Este comando garantiza que se inicie la versión más reciente de la aplicación XBAP. Al depurar la aplicación en Visual Studio, se debería iniciar la versión más reciente de la aplicación XBAP. Por lo general, debería actualizar el número de versión de implementación con cada compilación. Para más información sobre Mage, consulte Mage.exe (Herramienta de generación y edición de manifiestos).

Comunicación con la página web host

Cuando la aplicación se hospeda en un marco HTML, se puede comunicar con la página web que contiene la aplicación XBAP. Para hacerlo, recupere la propiedad HostScript de BrowserInteropHelper. Esta propiedad devuelve un objeto de script que representa la ventana HTML. Después, puede acceder a las propiedades, los métodos y los eventos en el objeto window mediante la sintaxis con punto normal. También puede acceder a los métodos de script y a las variables globales. En el ejemplo siguiente se muestra cómo recuperar el objeto de script y cerrar el explorador.

private void Button_Click(object sender, RoutedEventArgs e)
{
    // Retrieve the script object. The XBAP must be hosted in a frame or
    // the HostScript object will be null.
    var scriptObject = BrowserInteropHelper.HostScript;

    // Call close to close the browser window.
    scriptObject.Close();
}

Private Sub Button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Retrieve the script object  The XBAP must be hosted in a frame or
    ' the HostScript object will be null.
    Dim scriptObject = BrowserInteropHelper.HostScript

    ' Call close to close the browser window.
    scriptObject.Close()
End Sub

Depuración de aplicaciones XBAP que usan HostScript

Si la aplicación XBAP usa el objeto HostScript para comunicarse con la ventana HTML, hay dos configuraciones que debe especificar para ejecutar y depurar la aplicación en Visual Studio. La aplicación debe tener acceso a su sitio de origen y se debe iniciar la aplicación con la página HTML que contiene la aplicación XBAP. En los pasos siguientes se describe cómo comprobar estas dos configuraciones:

En Visual Studio, abra las propiedades del proyecto.
En la pestaña Seguridad, haga clic en Opciones avanzadas.

Se abrirá el cuadro de diálogo Configuración de seguridad avanzada.
Asegúrese de que la casilla Conceder a la aplicación acceso al sitio de origen esté activada y haga clic en Aceptar.
En la pestaña Depurar, seleccione la opción Iniciar explorador con la dirección URL y especifique la dirección URL de la página HTML que contiene la aplicación XBAP.
En Internet Explorer, haga clic en el botón Herramientas y seleccione Opciones de Internet.

Aparecerá el cuadro de diálogo Opciones de Internet.
Haga clic en la pestaña Opciones avanzadas.
En la lista Configuración, bajo Seguridad, active la casilla Permitir que el contenido activo se ejecute en los archivos de mi equipo.
Haga clic en OK.

Los cambios surtirán efecto una vez que reinicie Internet Explorer.

Precaución

La habilitación del contenido activo en Internet Explorer puede poner en peligro su equipo. Si no desea cambiar la configuración de seguridad de Internet Explorer, puede iniciar la página HTML desde un servidor y conectar el depurador de Visual Studio al proceso.

Consideraciones de seguridad para XBAP

Las aplicaciones XBAP suelen ejecutarse en un espacio aislado con seguridad de confianza parcial que se restringe al conjunto de permisos de zona de Internet. Por consiguiente, la implementación debe ser compatible con el subconjunto de elementos WPF que se admiten en la zona de Internet o debe elevar los permisos de la aplicación. Para obtener más información, consulte Seguridad.

Cuando se usa un control WebBrowser en la aplicación, WPF crea internamente instancias del control ActiveX nativo WebBrowser. Cuando se trata de una aplicación XBAP de confianza parcial que se ejecuta en Internet Explorer, el control ActiveX se ejecuta en un subproceso dedicado del proceso de Internet Explorer. Por tanto, se aplican las siguientes limitaciones:

El control WebBrowser debe proporcionar un comportamiento similar al del explorador host, incluidas las restricciones de seguridad. Algunas de estas restricciones de seguridad se pueden controlar mediante la configuración de seguridad de Internet Explorer. Para obtener más información, consulte Seguridad.
Se genera una excepción cuando se carga una aplicación XBAP entre dominios en una página HTML.
La entrada se encuentra en un subproceso independiente del control WPF WebBrowser, por lo que no se puede interceptar la entrada de teclado y no se comparte el estado del IME.
La sincronización o el orden de navegación pueden variar como consecuencia del control ActiveX que se ejecuta en otro subproceso. Por ejemplo, no siempre se cancela la navegación a una página cuando se inicia otra solicitud de navegación.
Es posible que un control ActiveX personalizado experimente problemas de comunicación porque la aplicación WPF se esté ejecutando en un subproceso independiente.
No se genera MessageHook porque HwndHost no puede crear subclases de una ventana que se ejecuta en otro subproceso o proceso.

Creación de una aplicación XBAP de plena confianza

Si la aplicación XBAP necesita plena confianza, puede cambiar el proyecto para habilitar este permiso. En los pasos siguientes se describe cómo habilitar la plena confianza:

En Visual Studio, abra las propiedades del proyecto.
En la pestaña Seguridad, seleccione la opción Aplicación de plena confianza.

Esta configuración realiza los cambios siguientes:

En el archivo de proyecto, el valor del elemento <TargetZone> se cambia a Custom.

En el manifiesto de aplicación (app.manifest), se agrega un atributo Unrestricted="true" al elemento PermissionSet.

<PermissionSet class="System.Security.PermissionSet"
               version="1"
               ID="Custom"
               SameSite="site"
               Unrestricted="true" />

Implementación de una aplicación XBAP de plena confianza

Al implementar una aplicación XBAP de plena confianza que no sigue el modelo de implementación de confianza de ClickOnce, el comportamiento cuando el usuario ejecute la aplicación dependerá de la zona de seguridad. En algunos casos, el usuario recibirá una advertencia al intentar instalarlo. El usuario puede elegir continuar con la instalación o cancelarla. En la tabla siguiente se describe el comportamiento de la aplicación para cada zona de seguridad y qué se debe hacer para que la aplicación reciba plena confianza.

Zona de seguridad	Comportamiento	Obtener plena confianza
Equipo local	Plena confianza automática	No se requiere ninguna acción.
Intranet y sitios de confianza	Pedir plena confianza	Firme la aplicación XBAP con un certificado para que el usuario vea el origen en la petición.
Internet	Error: "Confianza no concedida"	Firme la aplicación XBAP con un certificado.

Nota:

El comportamiento descrito en la tabla anterior es para las aplicaciones XBAP de plena confianza que no sigan el modelo de implementación de confianza de ClickOnce.

Se recomienda que utilice el modelo de implementación de confianza de ClickOnce para implementar una aplicación XBAP de plena confianza. Este modelo permite que se conceda a la aplicación XBAP plena confianza automáticamente, independientemente de la zona de seguridad, por lo que no hay que pedirla al usuario. Como parte de este modelo, debe firmar la aplicación con un certificado de un editor de confianza. Para más información, consulte Información general sobre la implementación de aplicaciones de confianza y Seguridad.

Consideraciones sobre el rendimiento de tiempo de inicio de XBAP

Un aspecto importante del rendimiento de la aplicación XBAP es el tiempo de inicio. Si una aplicación XBAP es la primera aplicación WPF en cargarse, el tiempo de inicio en frío puede ser de diez segundos o más. Esto se debe a que WPF representa la página de progreso, y tanto CLR como WPF se deben iniciar en frío para mostrar la aplicación.

A partir de .NET Framework 3.5 SP1, se reduce el tiempo de inicio en frío de XBAP al mostrar una página de progreso no administrada en una fase temprana del ciclo de implementación. La página de progreso aparece casi inmediatamente después de iniciarse la aplicación, porque se muestra con código hospedado de forma nativa y se representa en HTML.

Además, la mejora en la simultaneidad de la secuencia de descarga de ClickOnce reduce el tiempo de inicio en un 10 %. Una vez que ClickOnce se descarga y valida los manifiestos, comienza la descarga de la aplicación y la barra de progreso se empieza a actualizar.