Applicazione (schema del pacchetto per Windows 8)

Articolo
07/20/2023

Rappresenta un'app che include parte o tutte le funzionalità recapitate nel pacchetto.

Gerarchia degli elementi

<Applicazioni>: <Applicazione>

Sintassi

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

Chiave

? facoltativo (zero o uno)

& connettore interleave (può verificarsi in qualsiasi ordine)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria
EntryPoint	ID di classe attivabile, ad esempio ""Office. Winword.Class". Per le app desktop, questo valore deve essere il punto di ingresso effettivo del file eseguibile, ad esempio "main", "WinMain" o "wWinMain". Se si specifica questo attributo, è necessario specificare anche l'attributo Eseguibile . Se si specifica questo attributo, non è necessario specificare l'attributo StartPage .	Stringa di lunghezza compresa tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione. Si tratta in genere il nome completo dello spazio dei nomi di tipo Windows Runtime. Se EntryPoint non viene specificato, viene usato l'oggetto EntryPoint definito per l'app.	No
File eseguibile	Eseguibile di avvio predefinito per l'app. Questo file deve essere presente nel pacchetto. Se si specifica questo attributo, è necessario specificare l'attributo EntryPoint . Se si specifica questo attributo, non è necessario specificare l'attributo StartPage .	Stringa di lunghezza compresa tra 1 e 256 caratteri che deve terminare con ".exe" e non può contenere questi caratteri: <, >, :, %, ", \|, ?o *. Specifica l'eseguibile predefinito per l'estensione. Se non viene specificato, viene usato l'eseguibile definito per l'app. Se specificato, viene usata anche la proprietà EntryPoint. Se tale proprietà EntryPoint non viene specificata, viene usato il entrypoint definito per l'app.	No
Id	Identificatore univoco dell'applicazione all'interno del pacchetto. È detto anche identificatore applicazione relativo al pacchetto. L'ID è univoco all'interno del pacchetto, ma non a livello globale. Nel sistema può essere presente un altro pacchetto che usa lo stesso ID. Lo stesso ID non può essere usato più di una volta nello stesso pacchetto. Questa stringa contiene campi alfanumerici separati da punti. Ogni campo deve iniziare con un carattere alfabetico ASCII. Non è possibile usarli come valori di campo: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" e "LPT9". Quando si usa un Visual Studio, il valore predefinito di questo attributo è "App". Gli sviluppatori devono modificare manualmente questa impostazione nel manifesto. L'identificatore dell'app non deve essere modificato dopo che l'app è stata pubblicata nel Microsoft Store. Questa operazione interromperà la posizione del riquadro nel schermata Start.	Stringa ASCII di lunghezza compresa tra 1 e 64 caratteri.	Sì
StartPage	Pagina HTML di avvio predefinita per l'app. Questo file deve essere presente nel pacchetto. Se si specifica questo attributo, non è possibile specificare l'attributo EntryPoint o l'attributo Executable .	Stringa di lunghezza compresa tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, %, ", \|, ?o *.	No

Elementi figlio

Elemento figlio	Descrizione
ApplicationContentUriRules	Specifica le pagine nel contesto Web che hanno accesso ai dispositivi di georilevazione del sistema (se l'app ha l'autorizzazione per accedere a questa funzionalità) e l'accesso agli Appunti.
Estensioni (tipo: CT_ApplicationExtensions)	Definisce uno o più punti di estendibilità per l'app.
VisualElements	Descrive gli aspetti visivi dell'app UWP: riquadro predefinito, immagini del logo, colori di testo e sfondo, orientamento iniziale dello schermo, schermata iniziale e aspetto del riquadro della schermata di blocco.

Elementi padre

Elemento padre	Descrizione
Applicazioni	Rappresenta una o più app che costituiscono il pacchetto.

Commenti

L'elemento Application contiene attributi comuni ai punti di estendibilità relativi all'app. Queste informazioni vengono usate da altri punti di estendibilità per ottenere informazioni sull'app. Inoltre, gli attributi dell'applicazione vengono usati nell'avvio e nella gestione di un'istanza dell'app.

Se viene specificato l'attributo StartPage, si tratta di un'app Windows usando JavaScript. Se StartPage non viene specificato, è necessario specificare entrambi gli attributi Executable e EntryPoint ed è un'app UWP che usa C# o VB e XAML.

Esempio

L'esempio seguente è tratto dal manifesto del pacchetto di uno degli esempi 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>

Requisiti

	Valore
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`