Applicazione (Windows 10)

Articolo
03/14/2024

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

Gerarchia degli elementi

<Applicazione>

Sintassi

<Application
  EntryPoint? = 'See the Attributes table for more info.'
  Executable?
  uap10:HostId?
  Id
  uap10:Parameters?
  ResourceGroup?
  uap10:RuntimeBehavior?
  StartPage?
  desktop4:Subsystem?
  uap10:Subsystem?
  desktop4:SupportsMultipleInstances?
  uap10:SupportsMultipleInstances?
  uap10:TrustLevel?
  uap16:BaseNamedObjectsIsolation?
  uap17:BaseNamedObjectsIsolation?
  desktop11:AppLifecycleBehavior?

  <!-- Child elements -->
  uap:ApplicationContentUriRules?
  Extensions?
  uap7:Properties
  uap:VisualElements

</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 classe activatable ,ad esempio "Office.Winword.Class") o "windows.fullTrustApplication" o "windows.partialTrustApplication". Se si specifica EntryPoint, è necessario specificare anche l'attributo Eseguibile . Se si specifica EntryPoint, non è necessario specificare l'attributo StartPage .	Stringa compresa tra 1 e 256 caratteri in lunghezza, che rappresenta l'attività che gestisce l'estensione. Questo è normalmente il nome completo dello spazio dei nomi di un tipo Windows Runtime, ma può essere uno dei valori speciali "windows.fullTrustApplication" o "windows.partialTrustApplication". Se EntryPoint non viene specificato, viene invece usato EntryPoint definito per l'app.	No
File eseguibile	Eseguibile di avvio predefinito per l'app. Il file specificato deve essere presente nel pacchetto. Nei sistemi meno recenti (vedere la sezione osservazioni per i dettagli), se si specifica Eseguibile, è necessario specificare anche l'attributo EntryPoint . Se si specifica Eseguibile, non è necessario specificare l'attributo StartPage .	Stringa compresa tra 1 e 256 caratteri in lunghezza che deve terminare con `.exe` e non può contenere questi caratteri: `<`, `":\|>?`o .`*`	No
uap10:HostId	ID app dell'app host per l'app corrente. Questo attributo viene usato per le app ospitate.	Stringa alfanumerica compresa tra 1 e 255 caratteri di lunghezza. Deve iniziare con una lettera.	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. Quando si usa un modello di Visual Studio, il valore predefinito di questo attributo è App. Gli sviluppatori devono modificare manualmente questo oggetto nel manifesto. L'identificatore dell'app non deve essere modificato dopo la pubblicazione dell'app in Microsoft Store; in questo modo verrà interrotta la posizione del riquadro nella schermata Start.	Stringa ASCII compresa tra 1 e 64 caratteri di lunghezza. Questa stringa contiene campi alfanumerici separati da punti. Ogni campo deve iniziare con un carattere alfabetico ASCII. Non è possibile usare questi valori 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.	Sì
uap10:Parameters	Contiene i parametri della riga di comando da passare all'app. Supportato solo per le app desktop con identità del pacchetto (vedere Panoramica della distribuzione).	Stringa compresa tra 1 e 32767 caratteri in lunghezza con un carattere non di spazi vuoti all'inizio e alla fine.	No
ResourceGroup	Tag usato per raggruppare le attivazioni dell'estensione per scopi di gestione delle risorse,ad esempio CPU e memoria. Vedere la sezione Osservazioni in Application@ResourceGroup.	Stringa alfanumerica compresa tra 1 e 255 caratteri di lunghezza. Deve iniziare con una lettera.	No
uap10:RuntimeBehavior	Specifica il comportamento di runtime dell'app. "packagedClassicApp": un'app WinUI 3 o un'app Desktop Bridge (Centennial). Per un'app WinUI 3, in genere passa con un TrustLevel di "mediumIL" (ma "appContainer" è anche un'opzione). "win32App": qualsiasi altro tipo di app Win32, inclusa un'app in pacchetto con posizione esterna. In genere va con un TrustLevel di "mediumIL" (ma "appContainer" è anche un'opzione). "windowsApp": un'app piattaforma UWP (Universal Windows Platform) (UWP). Sempre va con un TrustLevel di "appContainer". Tutte le proprietà comuni (alcune dichiarate in `appxmanifest.xml`) ed eseguite come processo con identità del pacchetto e identità dell'applicazione. È possibile pensarle come essere in due gruppi. Un gruppo è app UWP ("windowsApp"); l'altro è Windows `.exe`s con main o WinMain ("packagedClassicApp" o "win32App"). Questo secondo gruppo è noto anche come app desktop.	Stringa con uno dei valori seguenti: "packagedClassicApp", "win32App" o "windowsApp".	No
StartPage	Pagina Web che gestisce il punto di estendibilità.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza che non possono contenere questi caratteri: `<":\|>?`, o .`*` Qualsiasi URI o IRI valido (versione non ASCII di un URI).	No
desktop4:Sottosistema	Indica se l'app è un'app UWP standard o un'app console UWP.	Stringa che può essere uno dei valori seguenti: console o finestre.	No
uap10:Sottosistema	Indica se l'app è un'app UWP standard o un'app console UWP.	Stringa che può essere uno dei valori seguenti: console o finestre.	No
desktop4:SupportsMultipleInstances	Indica il supporto di più istanze separate di app UWP. Per altre informazioni, vedere la sezione osservazioni.	Un valore booleano.	No
uap10:SupportsMultipleInstances	Indica il supporto di più istanze separate di app UWP. Per altre informazioni, vedere la sezione osservazioni.	Un valore booleano.	No
uap10:TrustLevel	Specifica il livello di attendibilità dell'app "mediumIL": l'app è attendibile; il processo viene eseguito con un livello di integrità medio (vedere Controllo integrità obbligatorio). Deve essere necessaria la funzionalità con restrizioni "Livello di autorizzazione di attendibilità completa" (vedere Dichiarazioni di funzionalità dell'app). "appContainer": l'app viene eseguita in un contenitore app leggero (vedere app MSIX AppContainer); il processo viene eseguito con un livello di integrità basso. È anche possibile che un'app non pacchettiata venga eseguita in un AppContainer.	Stringa con uno dei valori seguenti: "mediumIL" o "appContainer".	No
uap16:BaseNamedObjectsIsolation	Abilita l'isolamento baseNameObject (BNO) per l'app.	Stringa che può essere uno dei valori seguenti: pacchetto o nessuno.	No
uap17:BaseNamedObjectsIsolation	Abilita l'isolamento baseNameObject (BNO) per l'app.	Stringa che può essere uno dei valori seguenti: pacchetto o nessuno.	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. App o estensioni con un runtimeBehavior di "windowsApp" in modo implicito hanno AppLifecycleBehavior di "systemManaged" a meno che non sia specificato diversamente. App o estensioni con RuntimeBehavior di "packagedClassicApp" o "win32App" in modo implicito hanno AppLifecycleBehavior di "unmanaged" a meno che non sia specificato diversamente.	Uno dei valori seguenti: "systemManaged" , "unmanaged".	No

Elementi figlio

Elemento figlio	Descrizione
uap:ApplicationContentUriRules	Specifica quali pagine nel contesto Web 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.
uap7:Properties	Specifica le proprietà dell'app.
uap:VisualElements	Descrive gli aspetti visivi dell'app: il riquadro predefinito, le immagini di logo, il testo e i colori di sfondo, l'orientamento iniziale dello schermo, l'aspetto della schermata iniziale e il riquadro della schermata di blocco.

Elementi padre

Elemento padre	Descrizione
Applicazioni	Rappresenta una o più app che comprendono 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. Gli attributi dell'applicazione 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 il comportamento).

L'attributo StartPage si applica solo alle app JavaScript. Se StartPage non è specificato, è necessario specificare sia gli attributi Eseguibili 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 uap10 spazio dei nomi (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 versioni successive, viene installato solo nei sistemi che supportano lo uap10 spazio dei 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 è possibile specificarli in un elemento Extension con ambito app. Se non sono specificati in Estensione, vengono ereditati dall'applicazione padre. Si specificano questi attributi 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.

Eseguibile, uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel=["mediumIL" o "appContainer" (impostazione predefinita se omessa)]
Eseguibile, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL" (per altri requisiti, vedere la Descrizione precedente in questo argomento per uap10:RuntimeBehavior).
Eseguibile, EntryPoint="windows.fullTrustApplication" (equivalente a uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL")
Eseguibile, EntryPoint="windows.partialTrustApplication" (equivalente a uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer")
Eseguibile, EntryPoint="<qualsiasi altro>"

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

È ridondante specificare sia uap10:RuntimeBehavior/uap10:TrustLevel e EntryPoint contemporaneamente, ma se si esegue questa operazione, si tratta di un errore se sono in contraddizione.

le attivazioni di app piattaforma UWP (Universal Windows Platform) (UWP) richiedono EntryPoint. Quindi, se si specifica eseguibile e uap10:RuntimeBehavior="windowsApp" (senza EntryPoint), si tratta di un errore. In questo caso , EntryPoint specifica un elemento 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 sarà ridondante in questo caso e si specifica eseguibile e EntryPoint.

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

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

Questo valore è true anche se uap10:TrustLevel="mediumIL" e EntryPoint è qualsiasi altro valore di "windows.fullTrustApplication" o "windows.partialTrustApplication".

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

Note importanti sulle app multi-instancing

Se un'app dichiara SupportsMultipleInstances all'interno dell'elemento Application , tutte le estensioni in primo piano verranno anche multiistanza.
Se l'app dichiara SupportsMultipleInstances all'interno dell'elemento Application , non deve essere dichiarata a livello di Extensions (ad esempio, in un elemento BackgroundTasks o AppService ).
L'app deve dichiarare solo SupportMultipleInstances nelle attività in background, nell'audio in background o nei servizi dell'app.
Le app console saranno sempre multiistanza e devono dichiarare in modo esplicito SupportMultipleInstances.
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 entra in un host separato. Pertanto, un'app non può dichiarare sia SupportMultipleInstances che ResourceGroup nel manifesto.

Per altre informazioni sull'uso dell'attributo SupportsMultipleInstances per supportare più istanze separate di app UWP, vedere Creare un'app di Windows universale a più istanze.

Requisiti

Elemento	Valore
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
attributi desktop4	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/4`
attributi uap10	`http://schemas.microsoft.com/appx/manifest/uap/windows10/10`