Applicazione (Windows 10)Application (Windows 10)

Rappresenta un'app che comprende parte di o di tutte le funzionalità fornite nel pacchetto.Represents an app that comprises part of or all of the functionality delivered in the package.

Gerarchia degli elementiElement hierarchy

<Pacchetto>
<Package>
<Applicazioni>
<Applications>
<Applicazione><Application>

SintassiSyntax

<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?          = Any valid URI or IRI (the non-ASCII version of a URI). See below for more details. 
             ResourceGroup?      = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
             desktop4:Subsystem? = String value. Can be one of the following: "console", "windows"
             uap10:Subsystem?    = String value. Can be one of the following: "console", "windows"
             desktop4:SupportsMultipleInstances? = Boolean.
             uap10:SupportsMultipleInstances? = Boolean.
             uap10:TrustLevel?   = String value. Can be one of the following: "appContainer", "mediumIL".
             uap10:RuntimeBehavior?  = String value. Can be one of the following: "windowsApp", "packagedClassicApp", "win32App".
             uap10:HostId?       = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
             uap10:Parameters?   = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. >

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

</Application>

ChiaveKey

?  connettore interleave facoltativo (zero o uno) &    (possono verificarsi in qualsiasi ordine)?   optional (zero or one) &   interleave connector (may occur in any order)

Attributi ed elementiAttributes and Elements

AttributiAttributes

AttributoAttribute DescrizioneDescription Tipo di datiData type ObbligatoriaRequired Valore predefinitoDefault value
EntryPointEntryPoint

ID della classe attivabile, ad esempio " " Office. Winword. Class " .The activatable class ID, such as ""Office.Winword.Class".

Se si specifica questo attributo, è necessario specificare anche l'attributo Executable .If you specify this attribute, you must also specify the Executable attribute. Se si specifica questo attributo, non è necessario specificare l'attributo Startpage .If you specify this attribute you must not specify the StartPage attribute.

Stringa di lunghezza compresa tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione.A string between 1 and 256 characters in length, representing the task handling the extension. Si tratta in genere il nome completo dello spazio dei nomi di tipo Windows Runtime.This is normally the fully namespace-qualified name of a Windows Runtime type. Se EntryPoint non è specificato, viene usato il EntryPoint definito per l'app.If EntryPoint is not specified, the EntryPoint defined for the app is used instead. NoNo
File eseguibileExecutable

Eseguibile di avvio predefinito per l'app.The default launch executable for the app. Questo file deve essere presente nel pacchetto.This file must be present in the package.

Se si specifica questo attributo, è necessario specificare l'attributo EntryPoint .If you specify this attribute you must specify the EntryPoint attribute. Se si specifica questo attributo, non è necessario specificare l'attributo Startpage .If you specify this attribute you must not specify the StartPage attribute.

Una stringa di lunghezza compresa tra 1 e 256 caratteri che deve terminare con " . exe " e non può contenere i caratteri seguenti: < , > ,:, " , |,? o \*.A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or \*. Specifica il file eseguibile predefinito per l'estensione.It specifies the default executable for the extension. Se non specificato, viene usato il file eseguibile definito per l'app.If not specified, the executable defined for the app is used. Se specificato, viene utilizzata anche la proprietà EntryPoint.If specified, the EntryPoint property is also used. Se tale proprietà EntryPoint non è specificata, viene usato il EntryPoint definito per l'app.If that EntryPoint property isn't specified, the EntryPoint defined for the app is used. NoNo
IdId

Identificatore univoco dell'applicazione all'interno del pacchetto.The unique identifier of the application within the package. È detto anche identificatore applicazione relativo al pacchetto.This value is sometimes referred to as the package-relative app identifier (PRAID).

L'ID è univoco all'interno del pacchetto, ma non a livello globale.The ID is unique within the package but not globally. Nel sistema può essere presente un altro pacchetto che usa lo stesso ID.There may be another package on the system that uses the same ID. Lo stesso ID non può essere utilizzato più di una volta nello stesso pacchetto.The same ID cannot be used more than once in the same package.

Questa stringa contiene campi alfanumerici separati da punti.This string contains alpha-numeric fields separated by periods. Ogni campo deve iniziare con un carattere alfabetico ASCII.Each field must begin with an ASCII alphabetic character. 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 " .You cannot use these as field values: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", and "LPT9".

Quando si usa un modello di Visual Studio, il valore predefinito di questo attributo è " app " .When using a Visual Studio template, the default value of this attribute is "App". Gli sviluppatori devono modificare manualmente questa operazione nel manifesto.Developers should manually change this in the manifest.

L'identificatore dell'app non deve essere modificato dopo che l'app è stata pubblicata nell'Microsoft Store; in questo modo si interrompe la posizione del riquadro nella schermata Start.The app's identifier should not be changed after the app has been published to the Microsoft Store; doing so will disrupt the tile's position on the Start screen.

Stringa ASCII di lunghezza compresa tra 1 e 64 caratteri.An ASCII string between 1 and 64 characters in length. Yes
ResourceGroupResourceGroup

ResourceGroup è un tag che è possibile usare per raggruppare le attivazioni di estensione per finalità di gestione delle risorse, ad esempio CPU e memoria.ResourceGroup is a tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). Vedere Extension@ResourceGroup .See Extension@ResourceGroup.

Stringa alfanumerica di lunghezza compresa tra 1 e 255 caratteri.An alphanumeric string between 1 and 255 characters in length. Deve iniziare con un carattere alfabetico.Must begin with an alphabetic character. NoNo
StartPageStartPage

Pagina HTML di avvio predefinita per l'app.The default launch HTML page for the app. Può trattarsi di un percorso di file di Windows relativo che fa riferimento a un documento nel pacchetto dell'app oppure può essere un URL assoluto (in modo che un sito Web possa pubblicare come app nello Store).This can be a relative Windows file path referencing a document in the app's package, or it can be an absolute URL (so that a web site can publish as an app in the Store). L'URL può essere solo a partire da http://, https://o ms-appx-web://.The URL can only be starting with http://, https:// or ms-appx-web://. Si tratta del documento del punto di ingresso che verrà caricato da WWAHost quando si avvia un WWA per l'app.This is the entry point document that will be loaded by WWAHost when starting a WWA for that app.

Tecnicamente, il valore può essere un URL o un IRI, ovvero la versione non ASCII di un URI.Technically, the value may be a URL or an IRI—the non-ASCII version of a URI. Un IRI deve supportare fino a 2084 caratteri e deve contenere la percentuale e i caratteri riservati e non riservati, come descritto in RFC 3986 appendice a.An IRI must support up to 2084 characters and must be allowed to contain the %, and reserved and unreserved characters as described in RFC 3986 Appendix A.

Se si specifica questo attributo, non è possibile specificare l'attributo EntryPoint o l'attributo Executable .If you specify this attribute, you cannot specify either the EntryPoint attribute or the Executable attribute.

Qualsiasi URI o IRI valido (la versione non ASCII di un URI).Any valid URI or IRI (the non-ASCII version of a URI). NoNo
desktop4: sottosistemadesktop4:Subsystem

Indica se l'app è un'app UWP standard o un'app console UWP.Indicates whether the app is a standard UWP app or a UWP console app.

Valore stringa.String value. Può essere uno dei seguenti: "console", "Windows".Can be one of the following: "console", "windows". NoNo
uap10: sottosistemauap10:Subsystem

Indica se l'app è un'app UWP standard o un'app console UWP.Indicates whether the app is a standard UWP app or a UWP console app.

Valore stringa.String value. Può essere uno dei seguenti: "console", "Windows".Can be one of the following: "console", "windows". NoNo
desktop4:SupportsMultipleInstancesdesktop4:SupportsMultipleInstances

Indica il supporto di più istanze separate di app UWP.Indicates support of multiple, separate instances of UWP apps. Per ulteriori informazioni, vedere la sezione Osservazioni.For more information, see the remarks section. namespace. namespace.

.Boolean value. NoNo
uap10:SupportsMultipleInstancesuap10:SupportsMultipleInstances

Indica il supporto di più istanze separate di app UWP.Indicates support of multiple, separate instances of UWP apps. Per ulteriori informazioni, vedere la sezione Osservazioni.For more information, see the remarks section. namespace. namespace.

.Boolean value. NoNo
uap10: TrustLeveluap10:TrustLevel

Specifica il livello di attendibilità dell'app.Specifies the trust level of the app. Questo attributo viene usato per le app ospitate.This attribute is used for hosted apps.

Valore stringa.String value. Può essere uno dei seguenti: "appContainer", "mediumIL".Can be one of the following: "appContainer", "mediumIL". NoNo
uap10:RuntimeBehavioruap10:RuntimeBehavior

Specifica il comportamento in fase di esecuzione dell'app.Specifies the run time behavior of the app. Questo attributo viene usato per le app ospitate.This attribute is used for hosted apps.

Valore stringa.String value. Può essere uno dei seguenti: "windowsApp", "packagedClassicApp", "win32App".Can be one of the following: "windowsApp", "packagedClassicApp", "win32App". NoNo
uap10: HostIduap10:HostId

Questo valore specifica l'ID app dell'app host per l'app corrente.This value specifies the app ID of the host app for the current app. Questo attributo viene usato per le app ospitate.This attribute is used for hosted apps.

Stringa alfanumerica di lunghezza compresa tra 1 e 255 caratteri.An alphanumeric string between 1 and 255 characters in length. Deve iniziare con un carattere alfabetico.Must begin with an alphabetic character. NoNo
uap10: parametriuap10:Parameters

Contiene i parametri della riga di comando da passare all'app.Contains command line parameters to pass to the app. Supportato solo per le applicazioni desktop con identità del pacchetto.Only supported for desktop apps that have package identity.

Una stringa di lunghezza compresa tra 1 e 32767 caratteri con un carattere diverso da uno spazio vuoto all'inizio e alla fine.A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. NoNo

 

Elementi figlioChild Elements

Elemento figlioChild Element DescrizioneDescription
Estensioni (tipo: CT_ApplicationExtensions) Extensions (type: CT_ApplicationExtensions)

Definisce uno o più punti di estensibilità per l'app.Defines one or more extensibility points for the app.

UAP: ApplicationContentUriRules uap:ApplicationContentUriRules

Specifica le pagine del contesto Web che possono accedere ai dispositivi di georilevazione del sistema (se l'app dispone dell'autorizzazione per accedere a questa funzionalità) e l'accesso agli Appunti.Specifies which pages in the web context have access to the system's geolocation devices (if the app has permission to access this capability) and access to the clipboard.

UAP: VisualElements uap:VisualElements

Vengono descritti gli aspetti visivi dell'app: il riquadro predefinito, le immagini del logo, il testo e i colori di sfondo, l'orientamento iniziale dello schermo, la schermata iniziale e l'aspetto del riquadro della schermata di blocco.Describes the visual aspects of the app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.

uap7: Proprietà uap7:Properties

Specifica le proprietà dell'app.Specifies properties of the app.

 

Elementi padreParent Elements

Elemento padreParent Element DescrizioneDescription
Applicazioni Applications

Rappresenta una o più app che costituiscono il pacchetto.Represents one or more apps that comprise the package.

 

CommentiRemarks

L'elemento Application contiene attributi comuni ai punti di estensibilità che riguardano l'app.The Application element contains attributes that are common to the extensibility points that pertain to the app. Queste informazioni vengono usate da altri punti di estendibilità per ottenere informazioni sull'app.This information is used by other extensibility points to get information about the app. Inoltre, gli attributi dell' applicazione vengono usati per l'avvio e la gestione di un'istanza dell'app.Also, Application attributes are used in the start and management of an instance of the app.

L'oggetto Startpage si applica solo a un'app JavaScript.The StartPage applies only to a JavaScript app. Se Startpage non è specificato, è necessario specificare entrambi gli attributi Executable e EntryPoint , che si applica solo a un'app C#, C++ o VB.If StartPage is not specified, then both the Executable and EntryPoint attributes must be specified, and this applies only to a C#, C++, or VB app.

Note importanti sulle app con istanze multiple:Important notes about multi-instancing apps:

  • Se un'app dichiara SupportsMultipleInstances all'interno dell'elemento Application , tutte le estensioni in primo piano saranno anche a istanze diverse.If an app declares SupportsMultipleInstances within the Application element, then all foreground extensions will also be multi-instanced.
  • Se l'app dichiara SupportsMultipleInstances all'interno dell'elemento Application , non è necessario che sia dichiarata a livello di estensioni , ad esempio in un elemento backgroundTasks o AppService .If the app declares SupportsMultipleInstances within the Application element, then it does not need to be declared at the Extensions level (for example, in a BackgroundTasks or AppService element).
  • L'app deve dichiarare solo SupportsMultipleInstances su attività in background, audio di background o servizi app.The app should only declare SupportsMultipleInstances on background tasks, background audio, or app services.
  • Le app console saranno sempre a istanze diverse e dovranno dichiarare in modo esplicito SupportsMultipleInstances.Console apps will always be multi-instanced and must explicitly declare SupportsMultipleInstances.
  • Le app possono usare la Dichiarazione ResourceGroup nel manifesto per raggruppare più attività in background nello stesso host.Apps can use the ResourceGroup declaration in the manifest to group multiple background tasks into the same host. Questa operazione è in conflitto con istanze multiple, in cui ogni attivazione viene inserita in un host separato.This conflicts with multi-instancing, where each activation goes into a separate host. Pertanto, un'app non può dichiarare sia SupportsMultipleInstances che ResourceGroup nel manifesto.Therefore, an app cannot declare both SupportsMultipleInstances and ResourceGroup in the manifest.

Per altre informazioni sull'uso dell'attributo SupportsMultipleInstances per supportare più istanze separate di app UWP, vedere creare un'app di Windows universalea più istanze.For more information about using the SupportsMultipleInstances attribute to support multiple, separate instances of UWP apps, see Create a multi-instance Universal Windows App.

RequisitiRequirements

Spazio dei nomiNamespace http://schemas.microsoft.com/appx/manifest/uap/windows10

attributi desktop4 :http://schemas.microsoft.com/appx/manifest/desktop/windows10/4desktop4 attributes: http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

attributi uap10 :http://schemas.microsoft.com/appx/manifest/uap/windows10/10uap10 attributes: http://schemas.microsoft.com/appx/manifest/uap/windows10/10