UpdateManifestForBrowserApplication (Tarea)

Artículo
10/07/2008

Actualización: noviembre 2007

La tarea UpdateManifestForBrowserApplication se ejecuta para agregar el elemento <hostInBrowser /> al manifiesto de aplicación (nombreDeProyecto.exe.manifest) cuando se genera un proyecto de Aplicación del explorador XAML (XBAP).

Parámetros de la tarea

Parameter	Description
ApplicationManifest	Parámetro obligatorio de tipo ITaskItem[]. Especifica la ruta de acceso y el nombre del archivo de manifiesto de aplicación al que se desea agregar el elemento <hostInBrowser />.
HostInBrowser	Parámetro de tipo Boolean obligatorio. Especifica si se modifica el manifiesto de aplicación para incluir el elemento <hostInBrowser />. Si el valor es true, se incluye un nuevo elemento <hostInBrowser /> en el elemento <entryPoint />. Observe que la inclusión del elemento es acumulativa: si ya existe un elemento <hostInBrowser />, no se quita ni se sobrescribe. En su lugar, se crea un elemento <hostInBrowser /> adicional. Si su valor es false, no se modifica el manifiesto de aplicación.

ApplicationManifest

Parámetro obligatorio de tipo ITaskItem[].

Especifica la ruta de acceso y el nombre del archivo de manifiesto de aplicación al que se desea agregar el elemento <hostInBrowser />.

HostInBrowser

Parámetro de tipo Boolean obligatorio.

Especifica si se modifica el manifiesto de aplicación para incluir el elemento <hostInBrowser />. Si el valor es true, se incluye un nuevo elemento <hostInBrowser /> en el elemento <entryPoint />. Observe que la inclusión del elemento es acumulativa: si ya existe un elemento <hostInBrowser />, no se quita ni se sobrescribe. En su lugar, se crea un elemento <hostInBrowser /> adicional. Si su valor es false, no se modifica el manifiesto de aplicación.

Comentarios

Las aplicaciones XBAPs se ejecutan mediante la implementación ClickOnce y, por tanto, deben publicarse con manifiestos de implementación y de aplicación admitidos. Microsoft build engine (MSBuild) utiliza la tarea GenerateApplicationManifest para generar un manifiesto de aplicación.

A continuación, para configurar una aplicación que se va a hospedar en un explorador, se debe agregar un elemento adicional, <hostInBrowser />, al manifiesto de aplicación, como se muestra en el siguiente ejemplo:

<!--MyXBAPApplication.exe.manifest-->
<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly ... >
    <asmv1:assemblyIdentity ... />
    <application />
    <entryPoint>
      ...
      <hostInBrowser xmlns="urn:schemas-microsoft-com:asm.v3" />
    </entryPoint>
  ...
/>

La tarea UpdateManifestForBrowserApplication se ejecuta cuando se genera un proyecto de XBAP para agregar el elemento <hostInBrowser />.

Ejemplo

En el ejemplo siguiente se muestra cómo asegurarse de incluir el elemento <hostInBrowser /> en un archivo de manifiesto de aplicación.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask 
    TaskName="Microsoft.Build.Tasks.Windows.UpdateManifestForBrowserApplication"
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="UpdateManifestForBrowserApplicationTask">
    <UpdateManifestForBrowserApplication
      ApplicationManifest="MyXBAPApplication.exe.manifest"
      HostInBrowser="true" />
  </Target>
</Project>