Aplicaciones de Windows
Contraer la tabla de contenido
Expandir la tabla de contenido

Cómo administrar la activación de archivos (aplicaciones de la Tienda Windows con JavaScript y HTML)

Windows permite registrar una aplicación para que se convierta en controlador predeterminado de un tipo de archivo específico. Tanto las aplicaciones de escritorio como las aplicaciones de la Tienda Windows pueden registrarse para que sean un controlador de archivos predeterminado. Si el usuario elige tu aplicación como el controlador predeterminado de un tipo de archivo específico, esta se activará cada vez que ese tipo de archivo se inicie.

Solo debes registrar tu aplicación para un tipo de archivo si tienes previsto administrar todos los inicios de archivos de ese tipo. Si tu aplicación solo necesita usar el tipo de archivo internamente, no tienes que registrarla para que sea el controlador predeterminado. Si, en efecto, eliges registrarla para un tipo de archivo, es importante que proporciones al usuario final todas las funciones que se esperan cuando tu aplicación se active para ese tipo de archivo. Por ejemplo, puede registrarse un visor de imágenes para que muestre un archivo .jpg. Para obtener más información sobre las asociaciones de archivos, consulta Directrices y lista de comprobación de tipos de archivo y URI.

Los siguientes pasos te mostrarán cómo realizar el registro para un tipo de archivo personalizado, .alsdk, y cómo se puede activar una aplicación cuando el usuario inicia un archivo .alsdk.

Instrucciones

Paso 1: Especificar el punto de extensión en el manifiesto del paquete

La aplicación recibe eventos de activación solo para las extensiones de archivo listadas en el manifiesto del paquete. Así es como debes indicar que la aplicación administra archivos con la extensión .alsdk.

  1. Haz doble clic para abrir package.appxmanifest en el Explorador de soluciones.

    Consulta Identificadores de programación para obtener más información sobre los identificadores que usan las asociaciones de archivos. Esta es una breve descripción de cada uno de los campos que debes rellenar en el manifiesto del paquete:

    CampoDescripción

    Tipo de contenido

    Especifica el tipo de contenido MIME, como image/jpeg, para un tipo de archivo determinado.

    Nota importante sobre los tipos de contenido permitidos:  Esta es una lista alfabética de los tipos de contenido MIME que no se pueden especificar en el manifiesto del paquete porque están reservados o prohibidos: application/force-download, application/octet-stream, application/unknown, application/x-msdownload.

    Nombre

    Elige un nombre para un grupo de tipos de archivos que comparten el mismo nombre para mostrar, logotipo, información y marcas de edición. Elige un nombre de grupo que pueda continuar siendo el mismo a lo largo de las actualizaciones de la aplicación.

    Nota  El nombre debe estar completamente en minúsculas.

    Información

    Especifica la información relativa a un grupo de tipos de archivo. Este texto de información sobre herramientas aparece cuando el usuario se desplaza sobre el icono de un archivo de este tipo.

    Marcas de edición

    Especifica las marcas de edición para un grupo de tipos de archivo. Las marcas de edición controlan cómo se accederá a un archivo cuando proviene de un origen que no es de confianza. La marca OpenIsSafe indica que el verbo Open para el tipo de archivo se puede invocar de forma segura para cualquier archivo descargado. La marca AlwaysUnsafe indica que la opción para invocar automáticamente el verbo Open está deshabilitada. El usuario puede invalidar este atributo mediante el cuadro de diálogo Tipo de archivo. El uso de esta marca significa que OpenIsSafe se omite. Impide que la casilla No volver a mostrar este mensaje esté habilitada en el diálogo de seguridad al abrir archivos que no son de confianza de este tipo.

    Nombre para mostrar

    Especifica el nombre para mostrar de un grupo de tipos de archivo. El nombre para mostrar se usa para identificar el tipo de archivo en Establecer programas predeterminados en el Panel de control.

    Logotipo

    Especifica el logotipo que se usa para identificar el tipo de archivo en el escritorio y en Establecer programas predeterminados en el Panel de control. Si no se especifica ningún logotipo, se usa el logotipo pequeño de la aplicación.

    Tipo de archivo

    Especifica el tipo de archivo para el que se va a registrar, precedido de un punto (por ejemplo, “.jpeg”.)

     

  2. Selecciona la pestaña Declaraciones.
  3. En la lista desplegable, selecciona Asociaciones de tipo de archivo y haz clic en Agregar.
  4. Escribe alsdk como Nombre.
  5. Escribe .alsdk como Tipo de archivo.
    Nota importante:  Esta es una lista alfabética de los nombres de tipo de archivo que no se pueden especificar en el manifiesto del paquete porque están reservados o prohibidos: Accountpicture-ms, Appx, application, Appref-ms, Bat, Cer, Chm, Cmd, Com, Cpl, crt, dll, drv, Exe, fon, gadget, Hlp, Hta, Inf ,Ins, jse, lnk, Msi, Msp, ocx, pif, Ps1, Reg, Scf, Scr, Shb, Shs, Sys, ttf, url, Vbe, Vbs, Ws, Wsc, Wsf, Wsh.
  6. Introduce “images\Icon.png” como logotipo.
  7. Presiona Ctrl+S para guardar el cambio realizado en package.appxmanifest.

Esto agrega un elemento Extension como este al manifiesto del paquete. La categoría windows.fileTypeAssociation indica que la aplicación administra archivos con la extensión .alsdk.


<Package xmlns="http://schemas.microsoft.com/appx/2010/manifest">
   <Applications>
      <Application Id="AutoLaunch.App">
         <Extensions>
            <Extension Category="windows.fileTypeAssociation">
                <FileTypeAssociation Name="alsdk">
                  <DisplayName>SDK Sample File Type</DisplayName>
                  <Logo>images\logo.png</Logo>
                  <InfoTip>SDK Sample tip </InfoTip>
                  <EditFlags OpenIsSafe="true" />
                  <SupportedFileTypes>
                     <FileType ContentType="image/jpeg">.alsdk</FileType>
                  </SupportedFileTypes>
               </FileTypeAssociation>
            </Extension>
         </Extensions>
      </Application>
   </Applications>
</Package>

Paso 2: Agrega los iconos adecuados

Las aplicaciones que se convierten en predeterminadas para un tipo de archivo muestran sus iconos en varios lugares del sistema. Por ejemplo, estos iconos se muestran en:

  • Vista Elementos del Explorador de Windows, menús contextuales y la Cinta
  • Panel de control de programas predeterminados
  • Selector de elementos
  • Resultados de búsqueda en la pantalla Inicio
Es importante que incluyas los iconos adecuados con tu proyecto para que el logotipo tenga un aspecto genial en todos los sitios. En tu carpeta de imágenes deberías incluir versiones de 16/32/48/256 px para el logotipo pequeño y el icono. Estos iconos deberían coincidir con el aspecto del logotipo del icono de la aplicación con la plantilla de colores incorporada. Deberás probar los iconos en fondos de color blanco. Consulta la Muestra de inicio por asociación para ver iconos de ejemplo.

El Explorador de soluciones con una vista de los archivos en la carpeta de imágenes. Hay versiones de 16, 32, 48 y 256 píxeles de ‘Icon.targetsize’ y ‘smallTile-sdk’

Paso 3: Registrar la aplicación para el evento activado

Registra la aplicación para el evento activated a fin de administrar la activación de archivos.


WinJS.Application.addEventListener("activated", onActivatedHandler, false);

Paso 4: Administrar el evento activado

El controlador de eventos activated registrado en el paso 1 recibe todos los eventos de activación. La propiedad kind indica el tipo de evento de activación. Este ejemplo está configurado para administrar eventos de activación de file.


function onActivatedHandler(eventArgs) {
   if (eventArgs.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.file) 
   {
       // TODO: Handle file activation.

       // The number of files received is eventArgs.detail.files.size
       // The first file is eventArgs.detail.files[0].name
   }
}

Observaciones

Los archivos que recibes pueden provenir de un origen que no es de confianza. Debes validar el contenido de un archivo antes de realizar una acción en él. Para obtener más información sobre la validación de entradas, consulta el tema sobre cómo escribir código seguro.

Ejemplo completo

Consulta Ejemplo de inicio por asociación.

Temas relacionados

Conceptos
Programas predeterminados
Modelo de asociación de tipos de archivo y protocolos
Tareas
Cómo iniciar la aplicación predeterminada de un archivo
Cómo administrar la activación de protocolos
Directrices
Directrices y lista de comprobación de protocolos y tipos de archivo
Referencia
Windows.Storage.StorageFile
Windows.UI.WebUI.WebUIFileActivatedEventArgs
WinJS.Application.onactivated

 

 

Mostrar:
© 2018 Microsoft