Visão geral dos aplicativos de navegador XAML do WPF

Artigo
06/02/2023

Os aplicativos de navegador XAML (XBAPs) combinam recursos de aplicativos Web e aplicativos rich client. Como aplicativos Web, XBAPs podem ser implantados em um servidor Web e iniciados a partir do Internet Explorer ou Firefox no Windows. Como aplicativos rich client, os XBAPs podem aproveitar os recursos do WPF. O desenvolvimento de XBAPs também é semelhante ao desenvolvimento de cliente avançado. Este tópico fornece uma introdução simples e de alto nível ao desenvolvimento de XBAP e descreve em que o desenvolvimento XBAP difere do desenvolvimento padrão de cliente avançado.

Aviso

XBAPs exigem navegadores herdados para operar, como Internet Explorer e Firefox. Essas versões mais antigas do navegador geralmente não são suportadas no Windows 10 e no Windows 11. Os navegadores modernos não suportam mais a tecnologia necessária para aplicativos XBAP devido a riscos de segurança. Plugins que habilitam XBAPs não são mais suportados.

Este tópico contém as seguintes seções:

Criando um novo aplicativo de navegador XAML (XBAP)
Implantando um XBAP
Comunicando-se com a página da Web de host
Considerações sobre segurança de XBAP
Considerações sobre desempenho de tempo de início de XBAP

Criando um novo aplicativo de navegador XAML (XBAP)

A maneira mais simples de criar um novo projeto XBAP é com o Visual Studio. Ao criar um novo projeto, selecione Aplicativo de Navegador do WPF na lista de modelos. Para obter mais informações, consulte Como criar um novo projeto de aplicativo de navegador do WPF.

Quando você executa o projeto XBAP, ele é aberto em uma janela do navegador, em vez de uma janela autônoma. Quando você depura o XBAP do Visual Studio, o aplicativo é executado com permissão de zona da Internet e, portanto, lançará exceções de segurança se essas permissões forem excedidas. Para obter mais informações, consulte Segurança e Segurança de confiança parcial do WPF.

Observação

Se você não estiver desenvolvendo com o Visual Studio ou quiser saber mais sobre os arquivos de projeto, consulte Criando um aplicativo WPF.

Implantando um XBAP

Quando você compila um XBAP, a saída inclui os três arquivos a seguir:

Arquivo	Descrição
Executável (.exe)	Este arquivo contém o código compilado e tem uma extensão .exe.
Manifesto do aplicativo (.manifest)	Este arquivo contém os metadados associados ao aplicativo e tem uma extensão .manifest.
Manifesto de implantação (.xbap)	Esse arquivo contém as informações que o ClickOnce usa para implantar o aplicativo e tem a extensão .xbap.

Implantar XBAPs em um servidor Web, por exemplo, Microsoft Internet Information Services (IIS) 5.0 ou versões posteriores. Não é necessário instalar o .NET Framework no servidor Web, mas você precisa registrar os tipos de WPF Multipurpose Internet Mail Extensions (MIME) e extensões de nome de arquivo. Para obter mais informações, consulte Configurar o IIS 5.0 e o IIS 6.0 para implantar aplicativos WPF.

Para preparar seu XBAP para implantação, copie o .exe e os manifestos associados para o servidor Web. Crie uma página HTML que contenha um hiperlink para abrir o manifesto de implantação, que é o arquivo que tem a extensão .xbap. Quando o usuário clica no link para o arquivo .xbap, o ClickOnce lida automaticamente com a mecânica de baixar e iniciar o aplicativo. O exemplo de código a seguir mostra uma página HTML que contém um hiperlink que aponta para um XBAP.

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

Você também pode hospedar um XBAP no quadro de uma página da Web. Crie uma página da Web com um ou mais quadros. Defina a propriedade de origem de um quadro como o arquivo de manifesto de implantação. Se você quiser usar o mecanismo interno para se comunicar entre a página da Web de hospedagem e o XBAP, deverá hospedar o aplicativo em um quadro. O exemplo de código a seguir mostra uma página HTML com dois quadros; a fonte para o segundo quadro está definida como um XBAP.

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

Limpando XBAPs em cache

Em algumas situações, depois de recompilar e iniciar o XBAP, você pode achar que uma versão anterior do XBAP está aberta. Por exemplo, esse comportamento pode ocorrer quando o número de versão do assembly do XBAP é estático e você inicia o XBAP através da linha de comando. Nesse caso, como o número de versão entre a versão em cache (a versão que foi anteriormente iniciada) e a nova versão permanece o mesmo, a nova versão do XBAP não é baixada. Em vez disso, é carregada a versão em cache.

Nessas situações, você pode remover a versão armazenada em cache usando o comando Mage (instalado com o Visual Studio ou o SDK do Windows) no prompt de comando. O comando a seguir limpa o cache do aplicativo.

Mage.exe -cc

Esse comando garante que a versão mais recente do seu XBAP será iniciada. Quando você depurar seu aplicativo no Visual Studio, a versão mais recente do XBAP deve ser iniciada. Em geral, você deve atualizar o número de versão de implantação a cada build. Para obter mais informações sobre a Mage, consulte Mage.exe (Manifest Generation and Editing Tool).

Comunicando-se com a página da Web de host

Quando o aplicativo é hospedado em um quadro HTML, você pode se comunicar com a página da Web que contém o XBAP. Você faz isso recuperando a HostScript propriedade de BrowserInteropHelper. Essa propriedade retorna um objeto de script que representa a janela do HTML. Assim, você poderá acessar as propriedades, os métodos e os eventos no objeto de janela, usando a sintaxe de ponto regular. Você também pode acessar os métodos de script e as variáveis globais. O exemplo a seguir mostra como recuperar o objeto de script e fechar o navegador.

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

Depurando XBAPs que usam HostScript

Se o XBAP usa o HostScript objeto para se comunicar com a janela HTML, há duas configurações que você deve especificar para executar e depurar o aplicativo no Visual Studio. O aplicativo deve ter acesso ao seu site de origem e você deve iniciar o aplicativo com a página HTML que contém o XBAP. As etapas a seguir descrevem como verificar essas duas configurações:

No Visual Studio, abra as propriedades do projeto.
Na guia Segurança, clique em Avançado.

A caixa de diálogo Configurações de Segurança Avançada é exibida.
Verifique se a caixa de seleção Conceder ao aplicativo acesso ao site de origem está marcada e, em seguida, clique em OK.
Na guia Depurar, selecione a opção Iniciar Navegador com URL e especifique a URL da página HTML que contém o XBAP.
No Internet Explorer, clique no botão Ferramentas e, em seguida, selecione Opções da Internet.

A caixa de diálogo Opções da Internet é exibida.
Clique na guia Avançado.
Na lista Configurações em Segurança, marque a caixa de seleção Permitir que o conteúdo ativo seja executado em arquivos no Meu Computador.
Clique em OK.

As alterações entrarão em vigor depois que você reiniciar o Internet Explorer.

Cuidado

Habilitar conteúdo ativo no Internet Explorer pode colocar seu computador em risco. Se você não deseja alterar suas configurações de segurança do Internet Explorer, você pode iniciar a página HTML de um servidor e anexar o depurador do Visual Studio ao processo.

Considerações sobre segurança de XBAP

Os XBAPs normalmente são executados em uma área restrita de segurança de confiança parcial, que é restrita ao conjunto de permissões da zona da Internet. Consequentemente, sua implementação deve oferecer suporte ao subconjunto de elementos WPF que são suportados na zona da Internet ou você deve elevar as permissões do seu aplicativo. Para saber mais, consulte Segurança.

Quando você usa um WebBrowser controle em seu aplicativo, o WPF instancia internamente o controle ActiveX WebBrowser nativo. Quando seu aplicativo é um XBAP de confiança parcial em execução no Internet Explorer, o controle ActiveX é executado em um thread dedicado do processo do Internet Explorer. Portanto, as seguintes limitações se aplicam:

O WebBrowser controle deve fornecer comportamento semelhante ao navegador host, incluindo restrições de segurança. Algumas dessas restrições de segurança podem ser controladas por meio das configurações de segurança do Internet Explorer. Para saber mais, consulte Segurança.
Uma exceção é lançada quando um XBAP é carregado entre domínios em uma página HTML.
A entrada está em um thread separado do WPF WebBrowser, portanto, a entrada do teclado não pode ser interceptada e o estado do IME não é compartilhado.
O tempo ou a ordem de navegação pode ser diferente devido ao controle ActiveX em execução em outro thread. Por exemplo, a navegação até uma página nem sempre é cancelada ao iniciar outra solicitação de navegação.
Um controle ActiveX personalizado pode ter problemas com a comunicação, pois o aplicativo do WPF está em execução em um thread separado.
MessageHook não é gerado porque HwndHost não é possível subclassificar uma janela em execução em outro thread ou processo.

Criando um XBAP de confiança total

Se seu XBAP requer confiança total, você pode alterar seu projeto para habilitar essa permissão. As etapas a seguir descrevem como habilitar a confiança total:

No Visual Studio, abra as propriedades do projeto.
Na guia Segurança, selecione a opção Este é um aplicativo de confiança total.

Essa configuração faz as seguintes alterações:

No arquivo de projeto, o valor do elemento <TargetZone> é alterado para Custom.

No manifesto do aplicativo (app.manifest), um Unrestricted="true" atributo é adicionado ao elemento 'PermissionSet .

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

Implantando um XBAP de confiança total

Quando você implanta um XBAP de confiança total que não segue o modelo de implantação confiável do ClickOnce, o comportamento quando o usuário executar o aplicativo dependerá da zona de segurança. Em alguns casos, o usuário receberá um aviso ao tentar instalá-lo. O usuário pode optar por continuar ou cancelar a instalação. A tabela a seguir descreve o comportamento do aplicativo para cada zona de segurança e o que você precisa fazer para que o aplicativo receba confiança total.

Zona de segurança	Comportamento	Obtendo confiança total
Computador local	Confiança total automática	Nenhuma ação é necessária.
Intranet e sites confiáveis	Aviso para confiança total	Assinar o XBAP com um certificado para que o usuário veja o código-fonte no aviso.
Internet	Falha com "Confiança não concedida"	Assine XBAP com um certificado.

Observação

O comportamento descrito na tabela anterior é para XBAPs de confiança total que não seguem o modelo de implantação confiável do ClickOnce.

É recomendável que você use o modelo de implantação confiável do ClickOnce para implantar um XBAP de confiança total. Esse modelo permite que seu XBAP receba a confiança total automaticamente, independentemente da zona de segurança, de forma que o usuário não receba um aviso. Como parte desse modelo, você deve assinar o aplicativo com um certificado de um fornecedor confiável. Para obter mais informações, consulte Visão geral da implantação de aplicativos confiáveis e Introdução à assinatura de código.

Considerações sobre desempenho de tempo de início de XBAP

Um aspecto importante do desempenho do XBAP é seu tempo de início. Se um XBAP for o primeiro aplicativo do WPF a ser carregado, o tempo de inicialização a frio poderá ser de dez segundos ou mais. Isso ocorre porque a página de progresso é renderizada pelo WPF e tanto o CLR quanto o WPF devem ser iniciados a frio para exibir o aplicativo.

A partir do .NET Framework 3.5 SP1, o tempo de início a frio do XBAP é atenuado exibindo uma página de progresso não gerenciado no início do ciclo de implantação. A página de progresso é exibida quase que imediatamente após o aplicativo ser iniciado, porque ela é exibida pelo código de hospedagem nativo e é renderizada em HTML.

Além disso, a simultaneidade aprimorada da sequência de download do ClickOnce melhora a hora de início em até dez por cento. Depois que o ClickOnce baixa e valida manifestos, o download do aplicativo é iniciado e a barra de progresso começa a ser atualizada.