Inicio rápido: integrar con contratos del selector de archivos (aplicaciones de Windows en tiempo de ejecución)

Artículo
12/12/2015

[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows en tiempo de ejecución. Si estás desarrollando para Windows 10, consulta la documentación más reciente

Puedes ofrecer acceso al contenido de la aplicación, a una ubicación para guardar o a actualizaciones de archivos a través del selector de archivos si integras tu aplicación con el contrato del Selector de archivos para abrir, el contrato del Selector de guardar archivo o el contrato de Actualizador de archivos en caché.

Requisitos previos

JavaScript: Cómo activar una aplicación
C#/C++/VB: Cómo activar una aplicación
Recomendado: Contratos de aplicación de Windows

Decide qué servicios proporcionará la aplicación desde ventanas del selector de archivos

Al integrar tu aplicación en el contrato entre aplicaciones asociado, podrá ofrecer los siguientes servicios a otras aplicaciones. Para participar en un contrato, debes declarar el contrato en el manifiesto de la aplicación, responder al evento activado correspondiente y crear una vista especializada de la aplicación.

Proporciona acceso a archivos

Haz que se pueda obtener acceso a los archivos desde un selector de archivos si tu aplicación tiene una vista única o valiosa de esos archivos o si los usuarios no pueden acceder fácilmente a los archivos de otra manera.

Contrato entre aplicaciones: contrato del Selector de archivos para abrir

Información de evento activada: fileOpenPickerActivatedEventArgs

Proporciona una ubicación para guardar

Proporciona una ubicación segura a través del selector de archivos si esperas que los usuarios desearán guardar archivos para abrirlos y trabajar con ellos en tu aplicación más adelante.

Contrato entre aplicaciones: contrato del Selector de guardar archivo

Información de evento activada: fileSavePickerActivatedEventArgs

Proporciona actualizaciones de archivos en tiempo real

Realiza un seguimiento de los archivos y actualízalos a través del selector de archivos si esperas que los usuarios usarán tu aplicación como repositorio central de archivos al cual tu aplicación proporcione acceso, o que se guarden con tu aplicación como ubicación de guardado.

Contrato entre aplicaciones: contrato de Actualizador de archivos en caché

Información de evento activada: cachedFileUpdaterActivatedEventArgs

Obtén más información acerca de los servicios que puede ofrecer la aplicación a través de un selector de archivos en Acceso a archivos mediante selectores de archivos.

Declara el contrato en el manifiesto de la aplicación

Con el proyecto abierto en Microsoft Visual Studio, sigue estos pasos para agregar al manifiesto un contrato entre aplicaciones:

Para agregar un contrato entre aplicaciones, genera la ventana Agregar un nuevo elemento para el proyecto, selecciona el contrato del panel central y haz clic en el botón Agregar.

En Visual Studio, la ventana Agregar un nuevo elemento se puede generar de varias maneras:
- Al seleccionar la opción de menú Proyecto > Agregar un nuevo elemento...
- Al seleccionar la opción de menú Agregar > Nuevo elemento... del menú contextual del proyecto.
- Al usar el método abreviado de teclado Crtl+Mayús+A.
Sugerencia Cuando agregas estos contratos, Visual Studio actualiza automáticamente el archivo del manifiesto "package.appmanifest" y agrega archivos al proyecto que usarás para definir el diseño y el comportamiento de la vista que se hospedará en la ventana del selector de archivos cuando se llame al servicio de la aplicación.
Si la configuración predeterminada no es adecuada para tu aplicación, puedes personalizar la configuración del contrato en Visual Studio.
1. Abre "package.appmanifest".
2. Abre la pestaña Declaraciones.
3. Selecciona el nombre del contrato en la lista Declaraciones admitidas.
4. Agrega compatibilidad con tipos de archivo específicos.
  
  En el cuadro Tipos de archivo admitidos, desactiva la casilla Compatible con todos los tipos de archivo.
  
  Agrega un nuevo campo Tipo de archivo para cada tipo de archivo que quieras admitir con estos pasos:
  1. Haz clic en el botón Agregar nuevo.
  2. Especifica la extensión de un tipo de archivo que quieras admitir en el campo Tipo de archivo de esta manera: *.ext
  Sugerencia Agrega solo los tipos de archivo que sean directamente relevantes para la aplicación, los usuarios y el contrato. Limitar los tipos de archivo de esta manera puede ayudar a mantener la vista del selector de archivos despejada y fácil de usar.
También puedes quitar la compatibilidad con un tipo de archivo si sigues los pasos anteriores y haces clic en el botón Quitar del tipo que quieres quitar. El botón Quitar está justo encima del campo Tipo de archivo.

El archivo del manifiesto se actualiza con marcado del contrato que has agregado. En el marcado XML del manifiesto se inserta un elemento que representa el contrato que has agregado como elemento secundario del elemento Extensions. Por ejemplo, el marcado de un contrato del Selector de archivos para abrir que admite todos los tipos de archivo tiene el siguiente aspecto:


  <Extension Category="windows.filePicker" StartPage="filePicker.html">
    <FileOpenPicker>
      <SupportedFileTypes SupportsAnyFileType="true" />
    </FileOpenPicker>
  </Extension>

Responde cuando tu aplicación esté activada desde un selector de archivos

Agrega código al controlador de eventos asociado que pruebe que el objeto pasado en el controlador de eventos está asociado con el contrato que declaraste en el manifiesto y que después se muestre en la vista del selector de archivos de la aplicación.

Cada contrato está asociado con un objeto que proporciona información acerca de un evento que se activa cuando se llama a uno de los servicios que proporciona la aplicación desde un selector de archivos.

Contrato del Selector de archivos para abrir: fileOpenPickerActivatedEventArgs

Contrato del Selector de guardar archivo: fileSavePickerActivatedEventArgs

Contrato de Actualizador de archivos en caché: cachedFileUpdaterActivatedEventArgs

Crea una vista especializada de la aplicación que se hospedará en el selector de archivos

La directriz en Directrices y lista de comprobación de selectores de archivos te ayudará a diseñar la vista de la aplicación que se hospedará en el selector de archivos.

Al final, la vista debe consistir en:

Código que personaliza el formato letterbox del selector de archivos correctamente.
Marcado y estilos que definen el diseño del área enmarcada del selector de archivos (donde se muestran los archivos)
Código que vincula el origen de datos al marcado para que los archivos se muestren en el área enmarcada

Prueba los servicios proporcionados por la aplicación desde un selector de archivos llamado por otra aplicación

Para probar los servicios que ofrece la aplicación desde un selector de archivos, debes desencadenar el evento activado que corresponde al servicio que ofrece tu aplicación. No puedes desencadenar este evento ejecutando la aplicación directamente.

En lugar de eso, debes usar estos pasos para desencadenar el evento activado correspondiente para cada contrato.

Para probar la participación de la aplicación en el contrato del Selector de archivos para abrir:

Inicia una aplicación que no sea la tuya.
Usa la interfaz de usuario de esta otra aplicación para llamar a una ventana del selector de archivos para acceder a archivos.
Selecciona tu aplicación de la lista de ubicaciones en el selector de archivos para ver tu aplicación hospedada en el selector de archivos.

Para probar la participación de la aplicación en el contrato del Selector de guardar archivo:

Inicia una aplicación que no sea la tuya.
Usa la interfaz de usuario de esta otra aplicación para llamar a una ventana del selector de archivos para guardar un archivo.
Selecciona tu aplicación de la lista de ubicaciones en el selector de archivos para ver tu aplicación hospedada en el selector de archivos.

Para probar la participación de la aplicación en el contrato de Actualizador de archivos en caché:

Inicia una aplicación que no sea la tuya.
Usa la interfaz de usuario de esta otra aplicación para llamar a una ventana del selector de archivos o guarda un archivo que hayas marcado para actualizar.

Resumen

Tu aplicación puede ofrecer servicios a otras aplicaciones al participar en un contrato entre aplicaciones. Para participar en un contrato, debes declarar el contrato en el manifiesto de la aplicación, responder al evento activado correspondiente y crear una vista especializada de la aplicación.