Aplicación (esquema de paquete para Windows 8)

  • Artículo

Representa una aplicación que consta de parte o de toda la funcionalidad que se entrega en el paquete.

Jerarquía de elemento

<Paquete>
<APLICACIONES>
<Application>

Sintaxis

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the task  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Clave

? opcional (cero o uno)

& conector de intercalación (puede producirse en cualquier orden)

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
EntryPoint

Identificador de clase activable, como ""Office. Winword.Class".

Para las aplicaciones de escritorio, este valor debe ser el punto de entrada real del ejecutable, como "main", "WinMain" o "wWinMain".

Si especifica este atributo, también debe especificar el atributo Executable . Si especifica este atributo, no debe especificar el atributo StartPage .

 Cadena de entre 1 y 256 caracteres que representa la tarea que administra la extensión. Suele ser el nombre completo en el espacio de nombres de un tipo de Windows en tiempo de ejecución. Si no se especifica EntryPoint, se usa en su lugar el EntryPoint definido para la aplicación. No
Executable

Ejecutable de inicio predeterminado para la aplicación. Este archivo debe estar presente en el paquete.

Si especifica este atributo, debe especificar el atributo EntryPoint . Si especifica este atributo, no debe especificar el atributo StartPage .

 Cadena de entre 1 y 256 caracteres que debe terminar con ".exe" y no puede contener estos caracteres: <, >, :, %, ", |, ?o *. Especifica el ejecutable predeterminado para la extensión. Si no se especifica, se usa el ejecutable definido para la aplicación. Si se especifica, también se usa la propiedad EntryPoint. Si no se especifica esa propiedad EntryPoint, se usa el EntryPoint definido para la aplicación. No
Id

Identificador único de la aplicación dentro del paquete. Este valor se conoce a veces como el identificador de aplicación relativa del paquete (PRAID).

El identificador es único dentro del paquete, pero no globalmente. Puede haber otro paquete en el sistema que utilice el mismo identificador. El mismo identificador no se puede usar más de una vez en el mismo paquete.

Esta cadena contiene campos alfanuméricos separados por puntos. Cada campo debe empezar por un carácter alfabético ASCII. No se pueden usar como valores de campo: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" y "LPT9".

Cuando se usa Visual Studio plantilla, el valor predeterminado de este atributo es "App". Los desarrolladores deben cambiarlo manualmente en el manifiesto.

El identificador de la aplicación no debe cambiarse después de que la aplicación se haya publicado en el Microsoft Store; al hacerlo, se interrumpirá la posición del icono en el pantalla Inicio.

 Cadena ASCII de entre 1 y 64 caracteres. Sí
StartPage

Página HTML de inicio predeterminada para la aplicación. Este archivo debe estar presente en el paquete.

Si especifica este atributo, no puede especificar el atributo EntryPoint ni el atributo Executable .

 Cadena de entre 1 y 256 caracteres que no puede contener estos caracteres: <, >, :, %, ", |, ?o *. No

 

Elementos secundarios

Elemento secundario Descripción
ApplicationContentUriRules

Especifica qué páginas del contexto web tienen acceso a los dispositivos de geolocalización del sistema (si la aplicación tiene permiso para acceder a esta funcionalidad) y al Portapapeles.
Extensiones (tipo: CT_ApplicationExtensions)

Define uno o varios puntos de extensibilidad para la aplicación.
VisualElements

Describe los aspectos visuales de la aplicación para UWP: su icono predeterminado, imágenes de logotipo, colores de texto y fondo, orientación inicial de la pantalla, pantalla de presentación y apariencia de icono de pantalla de bloqueo.

 

Elementos primarios

Elemento primario Descripción
Aplicaciones

Representa una o varias aplicaciones que componen el paquete.

 

Comentarios

El elemento Application contiene atributos que son comunes a los puntos de extensibilidad que pertenecen a la aplicación. Otros puntos de extensibilidad usan esta información para obtener información sobre la aplicación. Además, los atributos de aplicación se usan en el inicio y la administración de una instancia de la aplicación.

Si se especifica el atributo StartPage, es una aplicación Windows con JavaScript. Si no se especifica StartPage, se deben especificar los atributos Executable y EntryPoint, y es una aplicación para UWP que usa C# o VB y XAML.

Ejemplos

El ejemplo siguiente se toma del manifiesto del paquete de uno de los ejemplos del SDK.

                    
<Applications>
  <Application Id="App" StartPage="default.html">

    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>

    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>

      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Requisitos

Value
Espacio de nombres http://schemas.microsoft.com/appx/2010/manifest