Application

Rappresenta un'app che comprende parte o tutte le funzionalità fornite nel pacchetto.

Gerarchia degli elementi

<Package>
   └─ <Applications>
      └─ <Application>

Sintassi

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10">
  ...
  <Application
    Id = 'A required value. <!-- TODO: Add description for t:ST_ApplicationId -->'
    Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
    StartPage = 'An optional value. <!-- TODO: Add description for t:ST_ApplicationStartPage -->'
    ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
    desktop4:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
    iot2:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
    uap10:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
    desktop4:SupportsMultipleInstances = 'An optional boolean value.'
    iot2:SupportsMultipleInstances = 'An optional boolean value.'
    uap10:SupportsMultipleInstances = 'An optional boolean value.'
    uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
    uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    previewsecurity:TrustLevel = 'An optional string that can have one of the following values: "appContainer", "mediumIL", or "appSilo".'
    uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer", or "mediumIL".'
    uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
    uap10:HostId = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
    uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    previewsecurity2:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", "win32App", or "appSilo".'
    uap16:BaseNamedObjectsIsolation = 'An optional string that can have one of the following values: "none", or "package".'
    uap17:BaseNamedObjectsIsolation = 'An optional string that can have one of the following values: "none", or "package".'
    desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".' >

    <!-- Child elements -->
    VisualElementsChoice
    ApplicationContentUriRules?
    Extensions?
    Properties?

  </Application>
</Package>

Chiave

? facoltativo (zero o uno)

Attributi

Attribute Description Tipo di dati Obbligatorio Valore predefinito
Id Identificatore univoco dell'applicazione all'interno del pacchetto. Questo valore viene talvolta definito identificatore dell'app relativo al pacchetto (PRAID). L'ID è univoco all'interno del pacchetto, ma non a livello globale. Nel sistema potrebbe essere presente un altro pacchetto che usa lo stesso ID. Lo stesso ID non può essere usato più volte nello stesso pacchetto. Quando si usa un modello di Visual Studio, il valore predefinito di questo attributo è App. Gli sviluppatori devono modificarlo manualmente nel manifesto. L'identificatore dell'app non deve essere modificato dopo la pubblicazione dell'app nel Microsoft Store. In questo modo, la posizione del riquadro verrà interrotta nella schermata Start. Un valore. Sì
File eseguibile Eseguibile di avvio predefinito. Stringa facoltativa compresa tra 1 e 256 caratteri che deve terminare con ".exe" e non può contenere questi caratteri: <, , >:, ", |, ?o *. No
EntryPoint ID classe attivabile. Stringa facoltativa compresa tra 1 e 256 caratteri che non può iniziare o terminare con un carattere di spazio vuoto. No
StartPage Pagina Web che gestisce il punto di estendibilità. Valore facoltativo. No
ResourceGroup Tag che è possibile usare per raggruppare le attivazioni dell'estensione per scopi di gestione delle risorse, ad esempio CPU e memoria. Stringa alfanumerica facoltativa compresa tra 1 e 255 caratteri. Deve iniziare con un carattere alfabetico. No
desktop4:Subsystem Indica se l'app è un'app UWP standard o un'app console UWP. Stringa facoltativa che può avere uno dei valori seguenti: console, finestre. No
iot2:Subsystem Stringa facoltativa che può avere uno dei valori seguenti: console, finestre. No
uap10:Subsystem Indica se l'app è un'app UWP standard o un'app console UWP. Stringa facoltativa che può avere uno dei valori seguenti: console, finestre. No
desktop4:SupportsMultipleInstances Indica il supporto di più istanze separate di app UWP. Per altre info, vedi la sezione osservazioni. Valore booleano facoltativo. No
iot2:SupportsMultipleInstances Valore booleano facoltativo. No
uap10:SupportsMultipleInstances Indica il supporto di più istanze separate di app UWP. Per altre info, vedi la sezione osservazioni. Valore booleano facoltativo. No
uap11:CurrentDirectoryPath Specifica la directory iniziale all'avvio del processo. Questo attributo supporta le macro. Per altre informazioni, vedere macro nello schema del manifesto del pacchetto. Stringa facoltativa che non può contenere questi caratteri: <, , >|, ?o *. No
uap11:Parameters Contiene i parametri della riga di comando da passare all'estensione. Questo attributo supporta le macro. Per altre informazioni, vedere macro nello schema del manifesto del pacchetto. Stringa facoltativa compresa tra 1 e 32767 caratteri con un carattere non vuoto all'inizio e alla fine. No
previewsecurity:TrustLevel Stringa facoltativa che può avere uno dei valori seguenti: appContainer, mediumIL, appSilo. No
uap10:TrustLevel Specifica il livello di attendibilità dell'estensione. Stringa facoltativa che può avere uno dei valori seguenti: appContainer, mediumIL. No
uap10:RuntimeBehavior Specifica il comportamento di runtime dell'estensione. Stringa facoltativa che può avere uno dei valori seguenti: windowsApp, packagedClassicApp, win32App. No
uap10:HostId Specifica l'ID del runtime host per l'estensione. Stringa alfanumerica facoltativa compresa tra 1 e 255 caratteri. Deve iniziare con un carattere alfabetico. No
uap10:Parameters Contiene i parametri della riga di comando da passare all'estensione. Supportato solo per le app desktop con identità del pacchetto. Stringa facoltativa compresa tra 1 e 32767 caratteri con un carattere non vuoto all'inizio e alla fine. No
previewsecurity2:RuntimeBehavior Stringa facoltativa che può avere uno dei valori seguenti: windowsApp, packagedClassicApp, win32App, appSilo. No
uap16:BaseNamedObjectsIsolation Abilita l'isolamento BaseNameObject (BNO) per l'app. Stringa facoltativa che può avere uno dei valori seguenti: nessuno, pacchetto. No
uap17:BaseNamedObjectsIsolation Abilita l'isolamento BaseNameObject (BNO) per l'app. Stringa facoltativa che può avere uno dei valori seguenti: nessuno, pacchetto. No
desktop11:AppLifecycleBehavior Consente a un'app di eseguire l'override del comportamento del ciclo di vita associato al comportamento di runtime per l'estensione. Le app o le estensioni con runtimeBehavior di "windowsApp" hanno in modo implicito AppLifecycleBehavior di "systemManaged", se non diversamente specificato. Le app o le estensioni con RuntimeBehavior di "packagedClassicApp" o "win32App" in modo implicito hanno AppLifecycleBehavior di "unmanaged" se non diversamente specificato. Stringa facoltativa che può avere uno dei valori seguenti: systemManaged, non gestito. No

Elementi figli

Elemento figlio Description
uap:ApplicationContentUriRules Specifica quali pagine nel contesto Web hanno accesso ai dispositivi di georilevazione del sistema (se l'app dispone dell'autorizzazione per accedere a questa funzionalità) e l'accesso agli Appunti.
Extensions Definisce uno o più punti di estendibilità per l'app.
uap7:Properties Proprietà di un'applicazione.

Elementi principali

Elemento padre Description
Applications Rappresenta una o più app che costituiscono il pacchetto.

Requisiti

Elemento Value
spazio dei nomi http://schemas.microsoft.com/appx/manifest/foundation/windows10
desktop11 http://schemas.microsoft.com/appx/manifest/desktop/windows10/11
desktop4 http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
iot2 http://schemas.microsoft.com/appx/manifest/iot/windows10/2
previewsecurity http://schemas.microsoft.com/appx/manifest/preview/windows10/security
previewsecurity2 http://schemas.microsoft.com/appx/manifest/preview/windows10/security/2
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11 http://schemas.microsoft.com/appx/manifest/uap/windows10/11
uap16 http://schemas.microsoft.com/appx/manifest/uap/windows10/16
uap17 http://schemas.microsoft.com/appx/manifest/uap/windows10/17
versione minima del sistema operativo

Osservazioni:

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. Application gli attributi vengono usati anche come informazioni di attivazione nell'avvio e nella gestione di un'istanza dell'app (in altre parole, descrivono come avviare un processo e con quale comportamento).

L'attributo StartPage si applica solo alle app JavaScript. Se StartPage non è specificato, è necessario specificare sia gli attributi Eseguibile che EntryPoint (e che si applicano solo alle app C#, C++o VB).

uap10 è stato introdotto in Windows 10 versione 2004 (10.0; Build 19041)

Lo spazio dei nomi uap10 (per uap10:RuntimeBehavior e uap10:TrustLevel) è stato introdotto in Windows 10 versione 2004 (10.0; Build 19041). Se il pacchetto viene installato nei sistemi meno recenti, è necessario fornire una combinazione equivalente di attributi (vedere la sezione seguente), altrimenti le informazioni di attivazione saranno incomplete e l'installazione avrà esito negativo.

Tuttavia, se il pacchetto ha <TargetDeviceFamily MinVersion="10.0.19041.0">o versione successiva, viene installato solo nei sistemi che supportano lo spazio dei uap10 nomi . In tal caso, è consigliabile usare gli uap10:RuntimeBehavior attributi e uap10:TrustLevel in preferenza per le combinazioni equivalenti precedenti (vedere la sezione seguente).

Combinazioni di attributi delle informazioni di attivazione

È possibile specificare gli attributi delle informazioni di attivazione nell'elemento Application e facoltativamente specificarli in un elemento Estensione con ambito app. Se non sono specificati in Estensione, questi vengono ereditati dall'elemento padre Application. Questi attributi vengono specificati in combinazioni, ad esempio EntryPoint, RuntimeBehavior e TrustLevel hanno un significato sovrapposto e vengono specificati (e/o ereditati) in combinazioni. Ecco alcune combinazioni valide degli attributi delle informazioni di attivazione.

  1. Eseguibile, uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel=["mediumIL" o "appContainer" (impostazione predefinita se omessa)]
  2. Eseguibile, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL" (per altri requisiti, vedere la descrizione precedente in questo argomento per uap10:RuntimeBehavior).
  3. Eseguibile, EntryPoint="windows.fullTrustApplication" (equivalente a uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL")
  4. Eseguibile, EntryPoint="windows.partialTrustApplication" (equivalente a uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer")
  5. Eseguibile, EntryPoint="<anything else>"

Come si può notare, se il sistema di destinazione non supporta lo uap10 spazio dei nomi, è possibile specificare invece l'attributo EntryPoint . Analogamente, l'equivalente di uap10:TrustLevel="appContainer"' nei sistemi meno recenti è EntryPoint="windows.partialTrustApplication".

Ma è ridondante specificare sia uap10:RuntimeBehavior/uap10:TrustLevel che EntryPoint contemporaneamente. Ma se lo fai, allora è un errore se contraddicono.

le attivazioni di app Piattaforma UWP (Universal Windows Platform) richiedono EntryPoint. Pertanto, se si specifica Eseguibile e uap10:RuntimeBehavior="windowsApp" (senza EntryPoint), si tratta di un errore. In questo stesso caso , EntryPoint specifica qualcosa di diverso da "windows.fullTrustApplication" e "windows.partialTrustApplication"; e valori diversi da quelli due dicono già la stessa cosa di uap10:RuntimeBehavior="windowsApp". Quindi uap10:RuntimeBehavior sarebbe ridondante in questo caso e si specificare Eseguibile e EntryPoint.

L'impostazione di uap10:RuntimeBehavior="win32App" e uap10:TrustLevel="appContainer" non è supportata.

L'impostazione di uap10:TrustLevel="mediumIL" mentre uap10:RuntimeBehavior="windowsApp" richiede la funzionalità personalizzata Microsoft.coreAppActivation_8wekyb3d8bbwe.

Questo vale anche se uap10:TrustLevel="mediumIL" e EntryPoint è qualsiasi valore diverso da "windows.fullTrustApplication" o "windows.partialTrustApplication".

Per altre informazioni su questa funzionalità personalizzata, vedere Funzionalità personalizzate.

Note importanti sulle app a più istanze

  • Se un'app dichiara SupportsMultipleInstances all'interno dell'elemento Application , anche tutte le estensioni in primo piano saranno multiistanza.
  • Se l'app dichiara SupportsMultipleInstances all'interno dell'elemento Application , non deve essere dichiarata a Extensions livello (ad esempio, in un elemento BackgroundTasks o AppService ).
  • L'app deve dichiarare solo SupportsMultipleInstances nelle attività in background, nell'audio in background o nei servizi app.
  • Le app console saranno sempre multiistanza e devono dichiarare in modo esplicito SupportsMultipleInstances.
  • Le app possono usare la dichiarazione ResourceGroup nel manifesto per raggruppare più attività in background nello stesso host. Questo è in conflitto con il multi-instancing, in cui ogni attivazione viene inserita in un host separato. Pertanto, un'app non può dichiarare sia SupportsMultipleInstances che ResourceGroup nel manifesto.

Per altre info sull'uso dell'attributo SupportsMultipleInstances per supportare più istanze separate delle app UWP, vedi Creare un app di Windows< universale a istanze multiple/c1>.

Examples

  • Last updated on