Integración de la aplicación de escritorio con Windows mediante extensiones de empaquetado

Si la aplicación de escritorio está empaquetada (tiene identidad de paquete en tiempo de ejecución), puede usar extensiones para integrar la aplicación con Windows mediante extensiones de predefinidas en el manifiesto del paquete. Consulte también las características que requieren identidad de paquete.

Por ejemplo, use una extensión para crear una excepción de firewall; convierta su aplicación en la aplicación predeterminada para un tipo de archivo; o apunte las baldosas de Inicio hacia su aplicación. Para usar una extensión, solo tiene que agregar código XML al archivo de manifiesto del paquete de la aplicación. No se requiere código.

En este tema se describen esas extensiones y las tareas que puede realizar con ellas.

Transicione a los usuarios a su aplicación

Ayude a los usuarios a realizar la transición a la aplicación empaquetada.

• Redirigir la aplicación de escritorio existente a la aplicación empaquetada
• Redirija las baldosas de Inicio existentes y los botones de la barra de tareas a su aplicación empaquetada
• Hacer que la aplicación empaquetada abra archivos en lugar de la aplicación de escritorio
• Asociar la aplicación empaquetada con un conjunto de tipos de archivo
• Agregar opciones a los menús contextuales de los archivos que tienen un tipo de archivo determinado
• Abrir determinados tipos de archivos directamente mediante una dirección URL

Redirigir la aplicación de escritorio existente a la aplicación empaquetada

Cuando los usuarios inician la aplicación de escritorio sin empaquetar existente, puede configurar la aplicación empaquetada para que se abra en su lugar.

Para habilitar este comportamiento:

1. Agregue entradas del Registro para redirigir el ejecutable de la aplicación de escritorio sin empaquetar a la aplicación empaquetada.
2. Registre la aplicación empaquetada para que se inicie cuando se inicie el ejecutable de la aplicación de escritorio sin empaquetar.

Agrega entradas al Registro para redirigir el ejecutable de la aplicación de escritorio sin empaquetar.

1. En el Registro, cree una subclave con el nombre del archivo ejecutable de la aplicación de escritorio en la clave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options.
2. En esta subclave, agregue los valores siguientes:
   • AppExecutionAliasRedirect (DWORD): si se establece en 1, el sistema comprobará si hay una extensión de paquete appExecutionAlias con el mismo nombre que el ejecutable. Si la extensión AppExecutionAlias está habilitada, la aplicación empaquetada se activará con ese valor.
   • AppExecutionAliasRedirectPackages (REG_SZ): el sistema solo le redirigirá a los paquetes enumerados. Los paquetes se muestran por su nombre de familia de paquetes, separados por punto y coma. Si se usa el valor especial * , el sistema le redirigirá a un AppExecutionAlias desde cualquier paquete.

Por ejemplo:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\contosoapp.exe 
    AppExecutionAliasRedirect = 1
    AppExecutionAliasRedirectPackages = "Microsoft.WindowsNotepad_8weky8webbe" 

Registrar la aplicación empaquetada para su lanzamiento

En el manifiesto del paquete, agregue una extensión AppExecutionAlias que registre el nombre del ejecutable de la aplicación de escritorio sin empaquetar. Por ejemplo:

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension Category="windows.appExecutionAlias" EntryPoint="Windows.FullTrustApplication">
          <uap3:AppExecutionAlias>
            <desktop:ExecutionAlias Alias="contosoapp.exe" />
          </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Deshabilitación del redireccionamiento

Los usuarios pueden desactivar el redireccionamiento e iniciar el archivo ejecutable de la aplicación sin empaquetar a través de estas opciones:

• Pueden desinstalar la versión empaquetada de la aplicación.
• El usuario puede deshabilitar la entrada de AppExecutionAlias para tu aplicación empaquetada en la página de Alias de ejecución de aplicaciones en Configuración.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10/3
• http://schemas.microsoft.com/appx/manifest/desktop/windows10

Elementos y atributos de esta extensión

<uap3:Extension
    Category="windows.appExecutionAlias"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>

Dirigir los mosaicos de inicio existentes y los botones de la barra de tareas a tu aplicación empaquetada.

Es posible que los usuarios hayan anclado la aplicación de escritorio a la barra de tareas o al menú Inicio. Puedes apuntar esos accesos directos a tu nueva aplicación empaquetada.

Espacio de nombres XML

http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Elementos y atributos de esta extensión

<Extension Category="windows.desktopAppMigration">
    <DesktopAppMigration>
        <DesktopApp AumId="[your_app_aumid]" />
        <DesktopApp ShortcutPath="[path]" />
    </DesktopAppMigration>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="rescap3">
  <Applications>
    <Application>
      <Extensions>
        <rescap3:Extension Category="windows.desktopAppMigration">
          <rescap3:DesktopAppMigration>
            <rescap3:DesktopApp AumId="[your_app_aumid]" />
            <rescap3:DesktopApp ShortcutPath="%USERPROFILE%\Desktop\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\[my_app_folder]\[my_app].lnk"/>
         </rescap3:DesktopAppMigration>
        </rescap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Ejemplo relacionado

Visor de imágenes de WPF con transición, migración o desinstalación

Hacer que la aplicación empaquetada abra archivos en lugar de la aplicación de escritorio

Puede asegurarse de que los usuarios abran la nueva aplicación empaquetada de forma predeterminada para determinados tipos de archivos en lugar de abrir la versión de escritorio de la aplicación.

Para ello, especificará el identificador programático (ProgID) de cada aplicación de la cual desea heredar asociaciones de archivos.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10/3
• http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
         <MigrationProgIds>
            <MigrationProgId>"[ProgID]"</MigrationProgId>
        </MigrationProgIds>
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap3, rescap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <rescap3:MigrationProgIds>
              <rescap3:MigrationProgId>Foo.Bar.1</rescap3:MigrationProgId>
              <rescap3:MigrationProgId>Foo.Bar.2</rescap3:MigrationProgId>
            </rescap3:MigrationProgIds>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Ejemplo relacionado

Visor de imágenes de WPF con transición, migración o desinstalación

Asocia tu aplicación empaquetada con un conjunto de tipos de archivo

Puede asociar la aplicación empaquetada con extensiones de tipo de archivo. Si un usuario hace clic con el botón derecho en un archivo en el Explorador de archivos y, a continuación, selecciona la opción Abrir con, tu aplicación aparece en la lista de sugerencias. Para obtener más información sobre el uso de esta extensión, consulte Integrar una aplicación de escritorio empaquetada con el Explorador de archivos.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[file extension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="mediafiles">
            <uap:SupportedFileTypes>
            <uap:FileType>.avi</uap:FileType>
            </uap:SupportedFileTypes>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Ejemplo relacionado

Visor de imágenes de WPF con transición, migración o desinstalación

Agregar opciones a los menús contextuales de los archivos que tienen un tipo de archivo determinado

Esta extensión permite agregar opciones al menú contextual que se muestra cuando los usuarios hacen clic con el botón derecho en un archivo en el Explorador de archivos. Estas opciones ofrecen a los usuarios otras formas de interactuar con el archivo, como imprimir, editar o obtener una vista previa del archivo. Para obtener más información sobre el uso de esta extensión, consulte Integrar una aplicación de escritorio empaquetada con el Explorador de archivos.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/2
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedVerbs>
           <Verb Id="[ID]" Extended="[Extended]" Parameters="[parameters]">"[verb label]"</Verb>
        </SupportedVerbs>
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"

  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" Parameters="/e &quot;%1&quot;">Edit</uap3:Verb>
              <uap3:Verb Id="Print" Extended="true" Parameters="/p &quot;%1&quot;">Print</uap3:Verb>
            </uap2:SupportedVerbs>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Ejemplo relacionado

Visor de imágenes de WPF con transición, migración o desinstalación

Abrir determinados tipos de archivos directamente mediante una dirección URL

Puede asegurarse de que los usuarios abran la nueva aplicación empaquetada de forma predeterminada para determinados tipos de archivos en lugar de abrir la versión de escritorio de la aplicación.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" UseUrl="true" Parameters="%1">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
      <Application>
        <Extensions>
          <uap:Extension Category="windows.fileTypeAssociation">
            <uap3:FileTypeAssociation Name="myfiletypes" UseUrl="true" Parameters="%1">
              <uap:SupportedFileTypes>
                <uap:FileType>.txt</uap:FileType>
                <uap:FileType>.doc</uap:FileType>
              </uap:SupportedFileTypes>
            </uap3:FileTypeAssociation>
          </uap:Extension>
        </Extensions>
      </Application>
    </Applications>
</Package>

Realizar tareas de instalación

• Crear excepción de firewall para la aplicación
• Colocar los archivos DLL en cualquier carpeta del paquete

Creación de una excepción de firewall para la aplicación

Si la aplicación requiere comunicación a través de un puerto, puede agregar la aplicación a la lista de excepciones de firewall.

Espacio de nombres XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Elementos y atributos de esta extensión

<Extension Category="windows.firewallRules">
  <FirewallRules Executable="[executable file name]">
    <Rule
      Direction="[Direction]"
      IPProtocol="[Protocol]"
      LocalPortMin="[LocalPortMin]"
      LocalPortMax="LocalPortMax"
      RemotePortMin="RemotePortMin"
      RemotePortMax="RemotePortMax"
      Profile="[Profile]"/>
  </FirewallRules>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Extensions>
    <desktop2:Extension Category="windows.firewallRules">
      <desktop2:FirewallRules Executable="Contoso.exe">
          <desktop2:Rule Direction="in" IPProtocol="TCP" Profile="all"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="domain"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="public"/>
          <desktop2:Rule Direction="out" IPProtocol="UDP" LocalPortMin="1339" LocalPortMax="1340" RemotePortMin="15"
                         RemotePortMax="19" Profile="domainAndPrivate"/>
          <desktop2:Rule Direction="out" IPProtocol="GRE" Profile="private"/>
      </desktop2:FirewallRules>
  </desktop2:Extension>
</Extensions>
</Package>

Colocar los archivos DLL en cualquier carpeta del paquete

Use la extensión uap6:LoaderSearchPathOverride para declarar hasta cinco rutas de acceso de carpeta en el paquete de la aplicación, en relación con la ruta de acceso raíz del paquete de la aplicación, que se usará en la ruta de búsqueda del cargador para los procesos de la aplicación.

El orden de búsqueda DLL para aplicaciones de Windows incluye paquetes en el grafo de dependencias de paquetes si los paquetes poseen derechos de ejecución. De forma predeterminada, esto incluye los paquetes principal, opcional y de marco, aunque esto se puede sobrescribir mediante el elemento uap6:AllowExecution en el manifiesto del paquete.

Un paquete que se incluye en el orden de búsqueda DLL incluirá su ruta de acceso efectiva de forma predeterminada. Para obtener más información sobre las rutas de acceso eficaces, consulte la propiedad EffectivePath (WinRT) y la enumeración PackagePathType (Win32).

Si un paquete especifica uap6:LoaderSearchPathOverride, esta información se usa en lugar de la ruta de acceso efectiva del paquete.

Cada paquete solo puede contener una extensión uap6:LoaderSearchPathOverride. Esto significa que puede agregar uno de ellos al paquete principal y, a continuación, agregar uno a cada uno de los paquetes opcionales de y los conjuntos relacionados.

Espacio de nombres XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/6

Elementos y atributos de esta extensión

Declare esta extensión al nivel de paquete del manifiesto de la aplicación.

<Extension Category="windows.loaderSearchPathOverride">
  <LoaderSearchPathOverride>
    <LoaderSearchPathEntry FolderPath="[path]"/>
  </LoaderSearchPathOverride>
</Extension>

Ejemplo

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/6"
  IgnorableNamespaces="uap6">
  ...
    <Extensions>
      <uap6:Extension Category="windows.loaderSearchPathOverride">
        <uap6:LoaderSearchPathOverride>
          <uap6:LoaderSearchPathEntry FolderPath=""/>
          <uap6:LoaderSearchPathEntry FolderPath="folder1/subfolder1"/>
          <uap6:LoaderSearchPathEntry FolderPath="folder2/subfolder2"/>
        </uap6:LoaderSearchPathOverride>
      </uap6:Extension>
    </Extensions>
...
</Package>

Integración con el Explorador de archivos

Ayude a los usuarios a organizar los archivos e interactuar con ellos de maneras conocidas.

• Definir cómo se comporta la aplicación cuando los usuarios seleccionan y abren varios archivos al mismo tiempo
• Mostrar contenido de archivo en una imagen en miniatura en el Explorador de archivos
• Mostrar contenido del archivo en un panel vista previa del explorador de archivos
• Habilitar a los usuarios para agrupar archivos mediante la columna Kind en el Explorador de archivos
• Hacer que las propiedades de archivo estén disponibles para buscar, indexar, cuadros de diálogo de propiedades y el panel de detalles
• Especificar un controlador de menú contextual para un tipo de archivo
• Hacer que los archivos del servicio en la nube aparezcan en el Explorador de archivos

Definir cómo se comporta la aplicación cuando los usuarios seleccionan y abren varios archivos al mismo tiempo

Especifique cómo se comporta la aplicación cuando un usuario abre varios archivos simultáneamente.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/2
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" MultiSelectModel="[SelectionModel]">
        <SupportedVerbs>
            <Verb Id="Edit" MultiSelectModel="[SelectionModel]">Edit</Verb>
        </SupportedVerbs>
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
</Extension>

Busque la referencia de esquema completa aquí.

Modelo de Selección Múltiple

las aplicaciones de escritorio empaquetadas tienen las mismas tres opciones que las aplicaciones de escritorio normales.

• Player: la aplicación se activa una vez. Todos los archivos seleccionados se pasan a la aplicación como parámetros de argumento.
• Single: la aplicación se activa una vez para el primer archivo seleccionado. Se omiten otros archivos.
• Document: se activa una nueva instancia independiente de la aplicación para cada archivo seleccionado.

Puede establecer diferentes preferencias para diferentes tipos de archivo y acciones. Por ejemplo, puede que desee abrir Documentos en modo Documento y Imágenes en modo Reproductor.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes" MultiSelectModel="Document">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" MultiSelectModel="Player">Edit</uap3:Verb>
              <uap3:Verb Id="Preview" MultiSelectModel="Document">Preview</uap3:Verb>
            </uap2:SupportedVerbs>
            <uap:SupportedFileTypes>
              <uap:FileType>.txt</uap:FileType>
            </uap:SupportedFileTypes>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Si el usuario abre 15 o menos archivos, la opción predeterminada para el atributo MultiSelectModel es Player. De lo contrario, el valor predeterminado es Document. Las aplicaciones para UWP siempre se inician como Player.

Mostrar el contenido del archivo en una imagen en miniatura en el Explorador de archivos

Permitir que los usuarios vean una imagen en miniatura del contenido del archivo cuando el icono del archivo aparezca en el tamaño mediano, grande o extra grande.

Espacio de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/2
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3
• http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <ThumbnailHandler
            Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:ThumbnailHandler
              Clsid  ="20000000-0000-0000-0000-000000000001"  />
            </uap3:FileTypeAssociation>
         </uap::Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Mostrar el contenido del archivo en el panel Vista previa del Explorador de archivos

Permitir que los usuarios obtengan una vista previa del contenido de un archivo en el panel Vista previa del Explorador de archivos.

Espacio de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/2
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3
• http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <DesktopPreviewHandler Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
                </uap:SupportedFileTypes>
              <desktop2:DesktopPreviewHandler Clsid ="20000000-0000-0000-0000-000000000001" />
           </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Permitir que los usuarios agrupe archivos mediante la columna Kind en el Explorador de archivos

Puede asociar uno o varios valores predefinidos para los tipos de archivo con el campo de Tipo .

En el Explorador de archivos, los usuarios pueden agrupar esos archivos mediante ese campo. Los componentes del sistema también usan este campo con diversos fines, como la indexación.

Para obtener más información sobre el campo de tipo y los valores que puede usar para este campo, consulte Uso de nombres de tipo.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Elementos y atributos de esta extensión

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <KindMap>
            <Kind value="[KindValue]">
        </KindMap>
    </FileTypeAssociation>
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap, rescap">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
           <uap:FileTypeAssociation Name="mediafiles">
             <uap:SupportedFileTypes>
               <uap:FileType>.m4a</uap:FileType>
               <uap:FileType>.mta</uap:FileType>
             </uap:SupportedFileTypes>
             <rescap:KindMap>
               <rescap:Kind value="Item">
               <rescap:Kind value="Communications">
               <rescap:Kind value="Task">
             </rescap:KindMap>
          </uap:FileTypeAssociation>
      </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Hacer que las propiedades de archivo estén disponibles para buscar, indexar, cuadros de diálogo de propiedades y el panel de detalles

Espacio de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10
• http://schemas.microsoft.com/appx/manifest/uap/windows10/3
• http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Elementos y atributos de esta extensión

<uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>.bar</FileType>
        </SupportedFileTypes>
        <DesktopPropertyHandler Clsid ="[Clsid]"/>
    </uap:FileTypeAssociation>
</uap:Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:DesktopPropertyHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Especificar un controlador de menú contextual para un tipo de archivo

Si la aplicación de escritorio define un controlador de menú contextual , use esta extensión para registrar el controlador de menús.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/foundation/windows10
• http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

Elementos y atributos de esta extensión

<Extensions>
    <com:Extension Category="windows.comServer">
        <com:ComServer>
            <com:SurrogateServer AppId="[AppID]" DisplayName="[DisplayName]">
                <com:Class Id="[Clsid]" Path="[Path]" ThreadingModel="[Model]"/>
            </com:SurrogateServer>
        </com:ComServer>
    </com:Extension>
    <desktop4:Extension Category="windows.fileExplorerContextMenus">
        <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type="[Type]">
                <desktop4:Verb Id="[ID]" Clsid="[Clsid]" />
            </desktop4:ItemType>
        </desktop4:FileExplorerContextMenus>
    </desktop4:Extension>
</Extensions>

Busque la referencia de esquema completa aquí: com:ComServer y desktop4:FileExplorerContextMenus.

Instrucciones

Para registrar el controlador de menú contextual, siga estas instrucciones.

1. En la aplicación de escritorio, implemente un controlador de menú contextual mediante la implementación de la interfaz IExplorerCommand o IExplorerCommandState. Para obtener un ejemplo, consulte el ejemplo de código ExplorerCommandVerb. Asegúrese de definir un GUID de clase para cada uno de los objetos de implementación. Por ejemplo, el código siguiente define un identificador de clase para una implementación de IExplorerCommand.

   class __declspec(uuid("00001111-aaaa-2222-bbbb-3333cccc4444")) CExplorerCommandVerb;
   

2. En el manifiesto del paquete, especifique una extensión de aplicación com:ComServer que registra un servidor suplente COM con el identificador de clase de la implementación del controlador de menú contextual.

   <com:Extension Category="windows.comServer">
       <com:ComServer>
           <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
               <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
           </com:SurrogateServer>
       </com:ComServer>
   </com:Extension>
   

3. En el manifiesto del paquete, especifique una extensión de la aplicación desktop4:FileExplorerContextMenus que registre la implementación del manejador de menú contextual.

   <desktop4:Extension Category="windows.fileExplorerContextMenus">
       <desktop4:FileExplorerContextMenus>
           <desktop4:ItemType Type=".rar">
               <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
           </desktop4:ItemType>
       </desktop4:FileExplorerContextMenus>
   </desktop4:Extension>
   

Ejemplo

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
  xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
  IgnorableNamespaces="desktop4">
  <Applications>
    <Application>
      <Extensions>
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
              <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
            </com:SurrogateServer>
          </com:ComServer>
        </com:Extension>
        <desktop4:Extension Category="windows.fileExplorerContextMenus">
          <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type=".contoso">
              <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
            </desktop4:ItemType>
          </desktop4:FileExplorerContextMenus>
        </desktop4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Hacer que los archivos del servicio en la nube aparezcan en el Explorador de archivos

Registre los controladores que implemente en la aplicación. También puede agregar opciones de menú contextual que aparecen cuando los usuarios hacen clic con el botón derecho en los archivos basados en la nube en el Explorador de archivos.

Espacio de nombres XML

• http://schemas.microsoft.com/appx/manifest/desktop/windows10

Elementos y atributos de esta extensión

<Extension Category="windows.cloudfiles" >
    <CloudFiles IconResource="[Icon]">
        <CustomStateHandler Clsid ="[Clsid]"/>
        <ThumbnailProviderHandler Clsid ="[Clsid]"/>
        <ExtendedPropertyhandler Clsid ="[Clsid]"/>
        <CloudFilesContextMenus>
            <Verb Id ="Command3" Clsid= "[GUID]">[Verb Label]</Verb>
        </CloudFilesContextMenus>
    </CloudFiles>
</Extension>

Ejemplo

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
    IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <Extension Category="windows.cloudfiles" >
            <CloudFiles IconResource="images\Wide310x150Logo.png">
                <CustomStateHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ThumbnailProviderHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ExtendedPropertyhandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <desktop:CloudFilesContextMenus>
                    <desktop:Verb Id ="keep" Clsid=
                       "20000000-0000-0000-0000-000000000001">
                       Always keep on this device</desktop:Verb>
                </desktop:CloudFilesContextMenus>
            </CloudFiles>
          </Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Iniciar la aplicación de maneras diferentes

• Iniciar la aplicación mediante un protocolo
• Iniciar la aplicación usando un alias
• Iniciar un archivo ejecutable cuando los usuarios inician sesión en Windows
• Permitir que los usuarios inicien la aplicación cuando conectan un dispositivo a su equipo
• Reiniciar automáticamente después de obtener una actualización de Microsoft Store

Iniciar la aplicación mediante un protocolo

Las asociaciones de protocolo pueden permitir que otros programas y componentes del sistema interoperan con la aplicación empaquetada. Cuando la aplicación empaquetada se inicia mediante un protocolo, puede especificar parámetros específicos para pasar a sus argumentos de evento de activación para que pueda comportarse en consecuencia. Los parámetros solo se admiten para aplicaciones empaquetadas de plena confianza. Las aplicaciones para UWP no pueden usar parámetros.

Espacio de nombres XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Elementos y atributos de esta extensión

<Extension
    Category="windows.protocol">
  <Protocol
      Name="[Protocol name]"
      Parameters="[Parameters]" />
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="uap3, desktop">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension
          Category="windows.protocol">
          <uap3:Protocol
            Name="myapp-cmd"
            Parameters="/p &quot;%1&quot;" />
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Inicio de la aplicación mediante un alias

Los usuarios y otros procesos pueden usar un alias para iniciar la aplicación sin tener que especificar la ruta de acceso completa a la aplicación. Puede especificar ese nombre de alias.

Espacios de nombres XML

• http://schemas.microsoft.com/appx/manifest/uap/windows10/3
• http://schemas.microsoft.com/appx/manifest/desktop/windows10

Elementos y atributos de esta extensión

<uap3:Extension
    Category="windows.appExecutionAlias"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>

Ejemplo

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
         <uap3:Extension
                Category="windows.appExecutionAlias"
                Executable="exes\launcher.exe"
                EntryPoint="Windows.FullTrustApplication">
            <uap3:AppExecutionAlias>
                <desktop:ExecutionAlias Alias="Contoso.exe" />
            </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Busque la referencia de esquema completa aquí.

Iniciar un archivo ejecutable cuando los usuarios inician sesión en Windows

Las tareas de inicio permiten a la aplicación ejecutar un archivo ejecutable automáticamente cada vez que un usuario inicia sesión.

La aplicación puede declarar varias tareas de inicio. Cada tarea se inicia de forma independiente. Todas las tareas de inicio aparecerán en el Administrador de tareas en la pestaña Inicio con el nombre que especifiques en el manifiesto de la aplicación y en el icono de la aplicación. El Administrador de tareas analizará automáticamente el impacto de inicio de las tareas.

Los usuarios pueden deshabilitar manualmente la tarea de inicio de la aplicación mediante el Administrador de tareas. Si un usuario deshabilita una tarea, no puede volver a habilitarla mediante programación.

Espacio de nombres XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Elementos y atributos de esta extensión

<Extension
    Category="windows.startupTask"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
  <StartupTask
      TaskId="[TaskID]"
      Enabled="true"
      DisplayName="[DisplayName]" />
</Extension>

Ejemplo

<Package
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <desktop:Extension
          Category="windows.startupTask"
          Executable="bin\MyStartupTask.exe"
          EntryPoint="Windows.FullTrustApplication">
        <desktop:StartupTask
          TaskId="MyStartupTask"
          Enabled="true"
          DisplayName="My App Service" />
        </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
 </Package>

Permitir que los usuarios inicien la aplicación cuando conecten un dispositivo a su EQUIPO

La reproducción automática puede presentar la aplicación como una opción cuando un usuario conecta un dispositivo a su PC.

Espacio de nombres XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10/3

Elementos y atributos de esta extensión

<Extension Category="windows.autoPlayHandler">
  <AutoPlayHandler>
    <InvokeAction ActionDisplayName="[action string]" ProviderDisplayName="[name of your app/service]">
      <Content ContentEvent="[Content event]" Verb="[any string]" DropTargetHandler="[Clsid]" />
      <Content ContentEvent="[Content event]" Verb="[any string]" Parameters="[Initialization parameter]"/>
      <Device DeviceEvent="[Device event]" HWEventHandler="[Clsid]" InitCmdLine="[Initialization parameter]"/>
    </InvokeAction>
  </AutoPlayHandler>

Ejemplo

<Package
  xmlns:desktop3="http://schemas.microsoft.com/appx/manifest/desktop/windows10/3"
  IgnorableNamespaces="desktop3">
  <Applications>
    <Application>
      <Extensions>
        <desktop3:Extension Category="windows.autoPlayHandler">
          <desktop3:AutoPlayHandler>
            <desktop3:InvokeAction ActionDisplayName="Import my files" ProviderDisplayName="ms-resource:AutoPlayDisplayName">
              <desktop3:Content ContentEvent="ShowPicturesOnArrival" Verb="show" DropTargetHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8"/>
              <desktop3:Content ContentEvent="PlayVideoFilesOnArrival" Verb="play" Parameters="%1" />
              <desktop3:Device DeviceEvent="WPD\ImageSource" HWEventHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8" InitCmdLine="/autoplay"/>
            </desktop3:InvokeAction>
          </desktop3:AutoPlayHandler>
      </Extensions>
    </Application>
  </Applications>
</Package>

Reiniciar automáticamente después de recibir una actualización de Microsoft Store

Si la aplicación está abierta cuando los usuarios instalan una actualización, la aplicación se cierra.

Si desea que esa aplicación se reinicie una vez completada la actualización, llame a la función RegisterApplicationRestart en cada proceso que desee reiniciar.

Cada ventana activa de la aplicación recibe un mensaje WM_QUERYENDSESSION. En este momento, la aplicación puede llamar a la función RegisterApplicationRestart para actualizar la línea de comandos si es necesario.

Cuando cada ventana activa de la aplicación recibe el mensaje WM_ENDSESSION, la aplicación debe guardar los datos y apagarse.

En este momento, la aplicación tiene 30 segundos para cerrar sus propios procesos o la plataforma los finaliza de forma forzada.

Una vez completada la actualización, la aplicación se reinicia.

Trabajar con otras aplicaciones

Integrar con otras aplicaciones, iniciar otros procesos o compartir información.

• Hacer que la aplicación aparezca como destino de impresión en las aplicaciones que admiten la impresión
• Compartir fuentes con otras aplicaciones de Windows
• Iniciar un proceso de Win32 desde una aplicación para la Plataforma universal de Windows (UWP)

Hacer que la aplicación aparezca como destino de impresión en las aplicaciones que admiten la impresión

Cuando los usuarios quieren imprimir datos desde otra aplicación, como el Bloc de notas, puede hacer que la aplicación aparezca como un destino de impresión en la lista de destinos de impresión disponibles de la aplicación.

Tendrá que modificar la aplicación para que reciba datos de impresión en formato XML Paper Specification (XPS).

Espacios de nombres XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Elementos y atributos de esta extensión

<Extension Category="windows.appPrinter">
    <AppPrinter
        DisplayName="[DisplayName]"
        Parameters="[Parameters]" />
</Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Applications>
  <Application>
    <Extensions>
      <desktop2:Extension Category="windows.appPrinter">
        <desktop2:AppPrinter
          DisplayName="Send to Contoso"
          Parameters="/insertdoc %1" />
      </desktop2:Extension>
    </Extensions>
  </Application>
</Applications>
</Package>

Busque un ejemplo que use esta extensión Aquí

Uso compartido de fuentes con otras aplicaciones de Windows

Comparta sus fuentes personalizadas con otras aplicaciones de Windows.

Espacios de nombres XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/4

Elementos y atributos de esta extensión

<Extension Category="windows.sharedFonts">
    <SharedFonts>
      <Font File="[FontFile]" />
    </SharedFonts>
  </Extension>

Busque la referencia de esquema completa aquí.

Ejemplo

<Package
  xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
  IgnorableNamespaces="uap4">
  <Applications>
    <Application>
      <Extensions>
        <uap4:Extension Category="windows.sharedFonts">
          <uap4:SharedFonts>
            <uap4:Font File="Fonts\JustRealize.ttf" />
            <uap4:Font File="Fonts\JustRealizeBold.ttf" />
          </uap4:SharedFonts>
        </uap4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Iniciar un proceso de Win32 desde una aplicación para la Plataforma universal de Windows (UWP)

Inicie un proceso de Win32 que se ejecute en plena confianza.

Espacios de nombres XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Elementos y atributos de esta extensión

<Extension Category="windows.fullTrustProcess" Executable="[executable file]">
  <FullTrustProcess>
    <ParameterGroup GroupId="[GroupID]" Parameters="[Parameters]"/>
  </FullTrustProcess>
</Extension>

Ejemplo

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
         xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
  ...
  <Capabilities>
      <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application>
      <Extensions>
          <desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
              <desktop:FullTrustProcess>
                  <desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
                  <desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
              </desktop:FullTrustProcess>
           </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Esta extensión puede ser útil si desea crear una interfaz de usuario de la Plataforma universal de Windows que se ejecute en todos los dispositivos, pero quiere que los componentes de la aplicación Win32 sigan ejecutándose con plena confianza.

Solo tiene que crear un paquete de aplicación de Windows para la aplicación Win32. A continuación, agregue esta extensión al archivo de paquete de la aplicación para UWP. Esta extensión indica que quiere iniciar un archivo ejecutable en el paquete de aplicación de Windows. Si quieres comunicarte entre tu aplicación para UWP y tu aplicación Win32, puedes configurar uno o varios servicios de aplicaciones para hacerlo. Puede obtener más información sobre este escenario aquí.

Pasos siguientes

¿Tiene preguntas? Pregúntanos en Stack Overflow. Nuestro equipo supervisa estas etiquetas . También puede preguntarnos aquí .