Integración de una aplicación de escritorio en Windows mediante extensiones de empaquetado

Artículo
05/07/2024

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 en Windows mediante las extensiones predefinidas en el manifiesto de paquete. Consulte Características que requieren la identidad del paquete.

Por ejemplo, puede usar una extensión para crear una excepción de firewall, hacer que la aplicación sea la aplicación predeterminada para un tipo de archivo o incluir iconos de inicio de la aplicación. Para usar una extensión, solo tienes que agregar XML al archivo de manifiesto de paquete de la aplicación. No se requiere ningún tipo de código.

En este tema se describen esas extensiones y las tareas que puedes realizar al usarlas.

Nota:

Las características descritas en este tema requieren que la aplicación esté empaquetada (tenga identidad de paquete en tiempo de ejecución). Esto incluye aplicaciones empaquetadas (consulte Creación de un nuevo proyecto para una aplicación de escritorio de WinUI 3 empaquetada) y aplicaciones empaquetadas con ubicación externa (consulte Concesión de identidad del paquete mediante el empaquetado con ubicación externa). Consulte Características que requieren la identidad del paquete.

Proceso de transición de usuarios a la aplicación

Para ayudar a los usuarios con la transición a tu aplicación empaquetada, puedes realizar los pasos siguientes:

Redirigir la aplicación de escritorio existente a la aplicación empaquetada
Incluir los iconos de inicio y los botones de la barra de tareas existentes en la aplicación empaquetada
Hacer que sea la aplicación empaquetada la que abra archivos en lugar de la aplicación de escritorio
Asociar la aplicación empaquetada con un conjunto de tipos de archivo
Agregar opciones en los menús contextuales de los archivos que tienen un tipo de archivo específico
Abrir determinados tipos de archivos directamente con una dirección URL

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

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

Nota

Esta característica se admite en Windows Insider, compilación preliminar 21313 y versiones posteriores.

Para habilitar este comportamiento:

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

Adición de entradas del Registro para redirigir el ejecutable desde la aplicación de escritorio sin empaquetar

En el Registro, cree una subclave con el nombre del archivo ejecutable de la aplicación de escritorio en la clave de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options.
En esta subclave, agregue los valores siguientes:
- AppExecutionAliasRedirect (DWORD): Si está establecido 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 redirigirá a los paquetes enumerados. Los paquetes se enumeran por su nombre de familia de paquete, separados por punto y coma. Si se usa el valor especial *, el sistema le redirigirá a una AppExecutionAlias de cualquier paquete.

Por ejemplo:

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

Registro de la aplicación empaquetada que se va a iniciar

En el manifiesto de 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 ejecutable de la aplicación sin empaquetar mediante estas opciones:

Pueden desinstalar la versión empaquetada de la aplicación.
El usuario puede deshabilitar la entrada de AppExecutionAlias para la aplicación empaquetada en la página (Alias de ejecución de aplicación) 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>

Nombre	Descripción
Category	Siempre es `windows.appExecutionAlias`.
Executable	Ruta de acceso relativa al archivo ejecutable que se iniciará al invocar el alias.
Alias	Nombre corto de la aplicación. Siempre debe acabar con la extensión ".exe".

Incluir los iconos de inicio y los botones de la barra de tareas existentes en la aplicación empaquetada

Es posible que los usuarios hayan anclado la aplicación de escritorio en la barra de tareas o el menú Inicio. Puedes incluir esos accesos directos en la 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre `windows.desktopAppMigration`.
AumID	Identificador de modelo de usuario de aplicación de la aplicación empaquetada.
ShortcutPath	Ruta de acceso a archivos .ink que inician la versión de escritorio de la aplicación.

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>

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

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

Puedes asegurarte de que los usuarios abren de forma predeterminada la nueva aplicación empaquetada y no la versión de escritorio, cuando abren ciertos tipos de archivos.

Para ello, especifica el identificador de programación (ProgID) de cada aplicación de la cual quieras 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
MigrationProgId	Identificador de programación (ProgID) que describe la aplicación, el componente y la versión de la aplicación de escritorio de la que quieres heredar asociaciones de archivos.

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>

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

Asociar la 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 el Explorador de archivos y selecciona la opción Abrir con, la aplicación aparecerá en la lista de sugerencias. Para obtener más información sobre cómo usar esta extensión, consulte Integración de 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
FileType	Extensión de archivo compatible con la aplicación.

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>

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

Agregar opciones en los menús contextuales de los archivos que tienen un tipo de archivo específico

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 diferentes formas de interactuar con el archivo, por ejemplo, imprimirlo, editarlo u obtener una vista previa de él. Para obtener más información sobre cómo usar esta extensión, consulte Integración de 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
Verb	Nombre que aparece en el menú contextual del Explorador de archivos. Esta cadena se puede localizar mediante `ms-resource`.
Id	Identificador único del verbo. Si la aplicación es una aplicación para UWP, este se pasa a la aplicación como parte de los argumentos del evento de activación para poder controlar la elección del usuario correctamente. Si la aplicación es una aplicación empaquetada de plena confianza, en su lugar recibe parámetros (consulta el siguiente punto).
Parámetros	Lista de valores y parámetros de argumento asociados con el verbo. Si la aplicación es una aplicación empaquetada de plena confianza, estos parámetros se pasan a la aplicación como argumentos de evento cuando esta se activa. Puedes personalizar el comportamiento de la aplicación en función de los distintos verbos de activación. Si una variable puede contener una ruta de acceso de archivo, escribe el valor del parámetro entre comillas. Así evitarás cualquier problema si la ruta de acceso incluye espacios. Si la aplicación es una aplicación para UWP, no se pueden pasar parámetros. En su lugar, la aplicación recibe el identificador (consulta el punto anterior).
Extendido	Especifica que el verbo solo aparece si el usuario mantiene presionada la tecla Mayús para mostrar el menú contextual, antes de hacer clic con el botón derecho en el archivo. Este atributo es opcional y su valor predeterminado es False (por ejemplo, mostrar siempre el verbo) si no se incluye. Este comportamiento se especifica de forma individual para cada verbo (excepto "Abrir", que siempre es False).

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>

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

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

Puedes asegurarte de que los usuarios abren de forma predeterminada la nueva aplicación empaquetada y no la versión de escritorio, cuando abren ciertos tipos 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]" UseUrl="true" Parameters="%1">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
UseUrl	Indica si se deben abrir archivos directamente desde una dirección URL de destino. Si no estableces este valor, cualquier intento que realice la aplicación para abrir un archivo mediante una URL, provocará que el sistema descargue el archivo de forma local.
Parámetros	Parámetros opcionales.
FileType	Extensiones de archivo pertinentes.

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>

Realización de tareas de configuración

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

Crear la excepción de firewall de la aplicación

Si la aplicación debe comunicarse a través de un puerto, puedes agregarla a la lista de excepciones del firewall.

Nota:

Para usar la categoría de extensión "windows.firewallRules" (consulte la información que tiene a continuación), el paquete necesita la capacidad restringida Nivel de permiso de plena confianza. Consulte Lista de funcionalidades restringidas.

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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Categoría	Siempre `windows.firewallRules`.
Ejecutable	Nombre del archivo ejecutable que quieres agregar a la lista de excepciones del firewall.
Dirección	Indica si la regla es entrante o saliente.
IPProtocol	Protocolo de comunicación.
LocalPortMin	Número de puerto más bajo en un intervalo de números de puerto local.
LocalPortMax	Número de puerto más alto de un intervalo de números de puerto local.
RemotePortMax	Número de puerto más bajo en un intervalo de números de puerto remoto.
RemotePortMax	Número de puerto más alto en un intervalo de números de puerto remoto.
Perfil	Tipo de red

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>

Colocación de 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, relacionadas con la ruta de acceso raíz del paquete de la aplicación, que se utilizarán en la ruta de búsqueda del cargador para los procesos de la aplicación.

El orden de búsqueda de DLL para aplicaciones de Windows incluye paquetes en el gráfico de dependencias de paquete si los paquetes tienen derechos de ejecución. De forma predeterminada, incluye los paquetes principales, opcionales y de marco, aunque el elemento uap6:AllowExecution del manifiesto del paquete puede sobrescribirlo.

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

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

Cada paquete puede contener solo una extensión uap6:LoaderSearchPathOverride. Significa que puedes agregar una de estas al paquete principal y, a continuación, agregar una a cada uno de tus paquetes opcionales y conjuntos relacionados.

espacio de nombres XML

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

Elementos y atributos de esta extensión

Declara esta extensión en el nivel de paquete del manifiesto de la aplicación.

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

Nombre Descripción

Category Siempre es windows.loaderSearchPathOverride.

FolderPath Ruta de acceso de la carpeta que contiene sus archivos DLL. Especifica una ruta de acceso relativa a la carpeta raíz del paquete. En una extensión puedes especificar hasta cinco rutas de acceso. Si quieres que el sistema busque archivos en la carpeta raíz del paquete, usa una cadena vacía para una de estas rutas de acceso. No incluya rutas de acceso duplicadas y asegúrese de que las rutas de acceso no contengan barras diagonales iniciales o finales ni barras diagonales inversas.

El sistema no buscará en subcarpetas; por tanto, asegúrate de indicar explícitamente cada carpeta que contenga archivos DLL y que quieras que cargue el sistema.

Nombre	Descripción
Category	Siempre es `windows.loaderSearchPathOverride`.
FolderPath	Ruta de acceso de la carpeta que contiene sus archivos DLL. Especifica una ruta de acceso relativa a la carpeta raíz del paquete. En una extensión puedes especificar hasta cinco rutas de acceso. Si quieres que el sistema busque archivos en la carpeta raíz del paquete, usa una cadena vacía para una de estas rutas de acceso. No incluya rutas de acceso duplicadas y asegúrese de que las rutas de acceso no contengan barras diagonales iniciales o finales ni barras diagonales inversas. El sistema no buscará en subcarpetas; por tanto, asegúrate de indicar explícitamente cada carpeta que contenga archivos DLL y que quieras que cargue el sistema.

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

Ayuda a los usuarios a organizar tus archivos y a interactuar con estos de la forma habitual.

Definir el comportamiento de la aplicación cuando los usuarios seleccionan y abren varios archivos al mismo tiempo
Mostrar el contenido del archivo en una imagen en miniatura en el Explorador de archivos
Mostrar el contenido del archivo en un panel de vista previa del Explorador de archivos
Permitir que los usuarios agrupen los archivos mediante la columna Tipo del Explorador de archivos
Hacer que las propiedades de archivo tengan disponibles las opciones de búsqueda, índice, diálogos de propiedad y 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 el comportamiento de la aplicación cuando los usuarios seleccionan y abren varios archivos al mismo tiempo

Especifica cómo se debe comportar la aplicación cuando el usuario abra varios archivos al mismo tiempo.

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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
MultiSelectModel	Consulte a continuación
FileType	Extensiones de archivo pertinentes.

MultiSelectModel

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. Otros archivos se omiten.
Document: se activa una nueva instancia independiente de la aplicación para cada archivo seleccionado.

Puedes establecer preferencias diferentes para distintos tipos de archivo y acciones. Por ejemplo, si deseas abrir documentos en el modo Document y las imágenes en el modo Player.

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 archivos o menos, la opción predeterminada del 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

Permite que los usuarios vean una imagen en miniatura del contenido del archivo cuando aparece el icono del archivo con un tamaño medio, 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
FileType	Extensiones de archivo pertinentes.
Clsid	Identificador de clase de la aplicación.

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 de vista previa del Explorador de archivos

Permite que los usuarios obtengan una vista previa del contenido de un archivo en el panel de 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
FileType	Extensiones de archivo pertinentes.
Clsid	Identificador de clase de la aplicación.

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 agrupen los archivos mediante la columna Tipo del Explorador de archivos

Puedes asociar uno o más valores predefinidos de los tipos de archivo mediante el campo Kind.

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

Para obtener más información sobre el campo Kind y los valores que puedes usar en este campo, consulta Usar nombres del campo Kind.

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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
FileType	Extensiones de archivo pertinentes.
value	Valor de Kind válido.

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 tengan disponibles las opciones de búsqueda, índice, diálogos de propiedad y 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.fileTypeAssociation`.
Nombre	Nombre de la asociación de tipo de archivo. Puedes usar este nombre para organizar y agrupar tipos de archivo. El nombre debe contener todos los caracteres en minúsculas y sin espacios.
FileType	Extensiones de archivo pertinentes.
Clsid	Identificador de clase de la aplicación.

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>

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

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>

Busca la referencia de esquema completa aquí: com:COMServer y desktop4:FileExplorerContextMenus.

Instructions

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

En la aplicación de escritorio, implementa un controlador de menú contextual mediante la implementación de la interfaz IExplorerCommand o IExplorerCommandState. Para obtener un ejemplo, consulta el ejemplo de código ExplorerCommandVerb. Asegúrate 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;
```

En el manifiesto del paquete, especifica una extensión de aplicación com:ComServer que registre un servidor suplente COM con el identificador de clase de la implementación del controlador del 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>

En el manifiesto del paquete, especifica una extensión de aplicación desktop4:FileExplorerContextMenus que registre la implementación del controlador del 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

Registra los controladores que implementas en la aplicación. También puedes agregar opciones de menú contextual que aparezcan cuando los usuarios hagan clic con el botón derecho en los archivos 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>

Nombre	Descripción
Category	Siempre es `windows.cloudfiles`.
iconResource	El icono que representa tu servicio de proveedor de archivos en la nube. Este icono aparece en el panel Navegación del Explorador de archivos. Los usuarios eligen este icono para mostrar archivos desde tu servicio en la nube.
Clsid CustomStateHandler	Identificador de clase de la aplicación que implementa el objeto CustomStateHandler. El sistema usa este identificador de clase para solicitar estados personalizados y columnas para archivos de la nube.
Clsid ThumbnailProviderHandler	Identificador de clase de la aplicación que implementa el objeto ThumbnailProviderHandler. El sistema usa este identificador de clase para solicitar imágenes en miniatura para archivos de la nube.
Clsid ExtendedPropertyHandler	Identificador de clase de la aplicación que implementa el objeto ExtendedPropertyHandler. El sistema usa este identificador de clase para solicitar propiedades ampliadas para un archivo de la nube.
Verbo	Nombre que aparece en el menú contextual del Explorador de archivos para los archivos que proporciona el servicio en la nube.
Identificador	Identificador único del verbo.

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 formas diferentes

Iniciar la aplicación mediante un protocolo
Iniciar la aplicación mediante un protocolo
Iniciar un archivo ejecutable cuando los usuarios inicien sesión en Windows
Permitir que los usuarios inicien la aplicación cuando conecten un dispositivo a su PC
Reiniciar automáticamente después de recibir una actualización de Microsoft Store

Iniciar la aplicación mediante un protocolo

Las asociaciones de protocolos permiten que otros programas y componentes del sistema interactúen con la aplicación empaquetada. Si la aplicación empaquetada se inicia mediante un protocolo, puedes especificar parámetros específicos para pasarlos a sus argumentos de evento de activación, de forma que se comporte en consecuencia. Los parámetros solo son compatibles con 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.protocol`.
Nombre	El nombre del protocolo
Parámetros	Lista de parámetros y valores para pasar a la aplicación como argumentos del evento cuando esta se activa. Si una variable puede contener una ruta de acceso de archivo, escribe el valor del parámetro entre comillas. Así evitarás cualquier problema si la ruta de acceso incluye espacios.

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>

Iniciar la aplicación mediante un alias

Tanto los usuarios como otros procesos pueden usar un alias para iniciar la aplicación sin tener que especificar su ruta de acceso completa. Puedes especificar el nombre de ese 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>

Nombre	Descripción
Category	Siempre es `windows.appExecutionAlias`.
Executable	Ruta de acceso relativa al archivo ejecutable que se iniciará al invocar el alias.
Alias	Nombre corto de la aplicación. Siempre debe acabar con la extensión ".exe". Solo puedes especificar un único alias de ejecución de la aplicación para cada aplicación del paquete. Si varias aplicaciones se registran para el mismo alias, el sistema llamará a la última que se haya registrado, así que asegúrate de elegir un alias exclusivo que sea bastante improbable que otras aplicaciones sustituyan.

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>

Puedes encontrar la referencia de esquema completa aquí.

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

Las tareas de inicio permiten que tu aplicación ejecute un archivo ejecutable de forma automática cuando un usuario inicia sesión.

Nota

El usuario tiene que iniciar la aplicación al menos una vez para registrar esta tarea de inicio.

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 bajo la pestaña Inicio con el nombre especificado en el manifiesto de la aplicación y el icono de la aplicación. El Administrador de tareas analizará automáticamente el impacto en el 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 podrá 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>

Nombre	Descripción
Category	Siempre es `windows.startupTask`.
Executable	Ruta de acceso relativa del archivo ejecutable que se va a iniciar.
TaskId	Identificador único de la tarea. Con este identificador, la aplicación puede llamar a las API de la clase Windows.ApplicationModel.StartupTask para habilitar o deshabilitar una tarea de inicio mediante programación.
Habilitado	Indica si la tarea se inicia habilitada o deshabilitada. Las tareas habilitadas se ejecutarán la próxima vez que el usuario inicie sesión (a menos que el usuario las deshabilite).
DisplayName	Nombre de la tarea que aparece en el Administrador de tareas. Puedes localizar esta cadena mediante `ms-resource`.

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 PC

Reproducción automática puede presentar tu aplicación como una opción cuando un usuario conecte 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>

Nombre	Descripción
Category	Siempre es `windows.autoPlayHandler`.
ActionDisplayName	Cadena que representa la acción que los usuarios pueden realizar con un dispositivo que conectan a un equipo (por ejemplo: "Importar archivos" o "Reproducir vídeo").
ProviderDisplayName	Cadena que representa tu aplicación o servicio (por ejemplo: "Reproductor de vídeo Contoso").
ContentEvent	Nombre de un evento de contenido que hace que a los usuarios les aparezca tu `ActionDisplayName` y `ProviderDisplayName`. Se genera un evento de contenido cuando se inserta en el equipo un dispositivo con volumen, como una tarjeta de memoria de cámara, una unidad USB o un DVD. Puedes encontrar la lista completa de esos eventos aquí.
Verbo	La opción de configuración Verbo identifica un valor que se pasa a la aplicación para la opción seleccionada. Puedes especificar varias acciones de inicio para un evento de Reproducción automática y usar la configuración Verbo para determinar qué opción seleccionó un usuario para tu aplicación. Para saber qué opción seleccionó el usuario, compruebe la propiedad verb de los argumentos del evento de inicio que se pasaron a la aplicación. Puedes usar cualquier valor para la configuración Verbo a excepción de open, que está reservado.
DropTargetHandler	Identificador de clase de la aplicación que implementa la interfaz IDropTarget. Los archivos del medio extraíble se pasan al método Colocar de tu implementación IDropTarget.
Parámetros	No tienes que implementar la interfaz IDropTarget para todos los eventos de contenido. Para cualquiera de los eventos de contenido, podrías proporcionar los parámetros de línea de comandos en lugar de implementar la interfaz IDropTarget. Para esos eventos, Reproducción automática iniciará tu aplicación utilizando los parámetros de línea de comandos. Puedes analizar esos parámetros en el código de inicialización de la aplicación para determinar si se inició mediante Reproducción automática y, a continuación, proporcionar tu implementación personalizada.
DeviceEvent	Nombre de un evento de dispositivo que hace que a los usuarios les aparezca tu `ActionDisplayName` y `ProviderDisplayName`. Se genera un evento de dispositivo cuando se conecta un dispositivo al equipo. Los eventos de dispositivo comienzan con la cadena `WPD` y puedes encontrarlos en una lista aquí.
HWEventHandler	Identificador de clase de la aplicación que implementa la interfaz IHWEventHandler.
InitCmdLine	Parámetro de cadena que quieres pasar al método Inicializar de la interfaz IHWEventHandler.

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 de esta, se cerrará.

Si quiere que esa aplicación se reinicie una vez que se complete la actualización, llame a la función RegisterApplicationRestart en cada proceso que quiera reiniciar.

Cada ventana activa de la aplicación recibe un mensaje WM_QUERYENDSESSION. En este punto, la aplicación puede llamar a la función RegisterApplicationRestart de nuevo 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.

Nota

Las ventanas activas también reciben el mensaje WM_CLOSE en caso de que la aplicación no controle el mensaje WM_ENDSESSION.

En este punto, la aplicación tiene 30 segundos para cerrar sus procesos o la plataforma los cierra a la fuerza.

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

Trabajar con otras aplicaciones

Realiza procesos de integración con otras aplicaciones, inicia otros procesos o comparte información.

Hacer que la aplicación aparezca como destino de impresión en aplicaciones que admiten funciones de 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 aplicaciones que admiten funciones de impresión

Cuando los usuarios quieran imprimir datos desde otra aplicación como, por ejemplo, el Bloc de notas de Windows, puedes hacer que la aplicación aparezca como destino de impresión en la lista de destinos de impresión disponibles correspondiente.

Tendrás 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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.appPrinter`.
DisplayName	Nombre que quieres que aparezca en la lista de destinos de impresión de una aplicación.
Parámetros	Cualquier parámetro que la aplicación necesite para controlar correctamente la solicitud.

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>

Puedes encontrar un ejemplo que usa esta extensión aquí.

Comparte tus fuentes personalizadas con otras aplicaciones de Windows.

Nota

Para poder enviar una aplicación que use esta extensión a Store, primero debe obtener la aprobación del equipo de Store. Para obtenerla, vaya a https://aka.ms/storesupport, haga clic en Contactar con nosotros y elija las opciones relacionadas con el envío de aplicaciones al panel. Este proceso de aprobación ayuda a garantizar que no haya conflictos entre las fuentes instaladas por la aplicación y las fuentes que se instalan con el sistema operativo. Si no obtiene la aprobación, recibirá un error similar al siguiente al enviar la aplicación: "Error al validar la aceptación del paquete: No se puede usar la extensión windows.sharedFonts con esta cuenta. Póngase en contacto con nuestro equipo de soporte técnico si quiere solicitar permisos para usar esta extensión".

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>

Puedes encontrar la referencia de esquema completa aquí.

Nombre	Descripción
Category	Siempre es `windows.sharedFonts`.
Archivo	Archivo que contiene las fuentes que quieres compartir.

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)

Inicia 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>

Nombre	Descripción
Category	Siempre es `windows.fullTrustProcess`.
GroupID	Cadena que identifica un conjunto de parámetros que quieres pasar al archivo ejecutable.
Parámetros	Parámetros que quieres pasar al archivo ejecutable.

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 resultar útil si quieres crear una interfaz de usuario de la Plataforma universal de Windows que se ejecute en todos los dispositivos y, a su vez, que los componentes de la aplicación de Win32 sigan realizando una ejecución de plena confianza.

Solo tienes que crear un paquete de aplicación de Windows para la aplicación de Win32. A continuación, agrega esta extensión al archivo de paquete de la aplicación para UWP. Estas extensiones indican que quieres iniciar un archivo ejecutable en el paquete de la aplicación de Windows. Si quieres establecer la comunicación entre la aplicación para UWP y la aplicación de Win32, puedes configurar uno o más servicios de la aplicación para poder hacerlo. Puedes obtener más información acerca de este escenario aquí.

Pasos siguientes

¿Tienes alguna pregunta? Pregúntanos en Stack Overflow. Nuestro equipo supervisa estas etiquetas. También puedes preguntarnos aquí.

Compartir a través de

Integración de una aplicación de escritorio en Windows mediante extensiones de empaquetado

Proceso de transición de usuarios a la aplicación

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

Adición de entradas del Registro para redirigir el ejecutable desde la aplicación de escritorio sin empaquetar

Registro de la aplicación empaquetada que se va a iniciar

Deshabilitación del redireccionamiento

espacios de nombres XML

Elementos y atributos de esta extensión

Incluir los iconos de inicio y los botones de la barra de tareas existentes en la aplicación empaquetada

Espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Muestra relacionada

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

Espacios de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Muestra relacionada

Asociar la aplicación empaquetada con un conjunto de tipos de archivo

espacios de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Muestra relacionada

Agregar opciones en los menús contextuales de los archivos que tienen un tipo de archivo específico

espacios de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Muestra relacionada

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

Espacios de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Realización de tareas de configuración

Crear la excepción de firewall de la aplicación

Espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Colocación de archivos DLL en cualquier carpeta del paquete

espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Integración con el Explorador de archivos

Definir el comportamiento de la aplicación cuando los usuarios seleccionan y abren varios archivos al mismo tiempo

espacios de nombres XML

Elementos y atributos de esta extensión

Ejemplo

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

espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

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

espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Permitir que los usuarios agrupen los archivos mediante la columna Tipo del Explorador de archivos

espacios de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Hacer que las propiedades de archivo tengan disponibles las opciones de búsqueda, índice, diálogos de propiedad y panel de detalles

espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

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

espacios de nombres XML

Elementos y atributos de esta extensión

Instructions

Ejemplo

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

espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Iniciar la aplicación de formas diferentes

Iniciar la aplicación mediante un protocolo

espacio de nombres XML

Elementos y atributos de esta extensión

Ejemplo

Iniciar la aplicación mediante un alias

espacios de nombres XML

Elementos y atributos de esta extensión