win32dependencies:ExternalDependency (Windows 10, Windows 11)

Articolo
08/18/2024

Specifica una dipendenza esterna non inclusa in MSIX, ma che verrà installata come parte dell'installazione dell'app. Se la versione minima specificata della dipendenza esterna non è già installata nel sistema operativo, l'app Programma di installazione app Microsoft recupererà la versione minima da un repository esterno e installerà la dipendenza. Microsoft gestisce un elenco di dipendenze che possono essere installate usando questo metodo. Per l'elenco corrente dei pacchetti consentiti, vedere la sezione osservazioni .

Importante

win32dependencies:ExternalDependency si applica solo alle installazioni che usano l'app Microsoft App Installer. Se un pacchetto viene installato usando qualsiasi altro meccanismo, ad esempio l'API PackageManager , un cmdlet di PowerShell, Microsoft Intune o qualsiasi altro meccanismo diverso dall'app Del programma di installazione app, win32dependencies:ExternalDependency viene ignorato.

Gerarchia degli elementi

pacchetto

[<dipendenze>]

<win32dependencies:ExternalDependency>

Sintassi

<win32dependencies:ExternalDependency
    Name = 'A string between 3 and 50 characters in length that consists of alpha-numeric characters, periods, and dashes only.' 
    Publisher = 'A string with a value between 1 and 8192 characters in length that fits the regular expression  of a distinguished name.'
    MinVersion = 'A version string in quad notation, ("Major.Minor.Build.Revision") where "Major" is not "0".'
    Optional = 'A boolean value.' />

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatorio
Nome	Nome del pacchetto di dipendenza. Per l'elenco dei pacchetti di dipendenze consentiti, vedere la sezione Osservazioni di seguito.	Stringa compresa tra 3 e 50 caratteri costituita solo da caratteri alfanumerici, punti e trattini.	Sì
Publisher	Autore del pacchetto di dipendenza.	Stringa con un valore compreso tra 1 e 8192 caratteri che si adatta all'espressione regolare di un nome distinto.	Sì
MinVersion	Versione minima della dipendenza esterna. Se il sistema operativo ha già installato la versione minima, l'installazione non verrà attivata.	Stringa di versione nella notazione quad, (`Major.Minor.Build.Revision`) in cui `Major` non è `0`.	Sì
facoltativo	Quando l'installazione viene eseguita senza una connessione Internet e questo valore è false, l'installazione verrà completata senza installare la dipendenza esterna. Se questo valore è true, un'installazione senza connessione Internet avrà esito negativo.	Valore booleano.	Sì

Elementi figlio

Nessuno.

Elementi padre

Elemento padre	Descrizione
dipendenze	Dichiara altri pacchetti da cui dipende un pacchetto per completare il software.

Esempi

<Package
    xmlns:win32dependencies="http://schemas.microsoft.com/appx/manifest/externaldependencies"  
    IgnorableNamespaces="... win32dependencies">
    <Dependencies>  
        <TargetDeviceFamily
            Name="Windows.Universal"
            MinVersion="11.0.0.0" 
            MaxVersionTested="12.0.0.0"/>  
        <uap4:MainPackageDependency
            Name="MyApp"
            Publisher="CN=DianCert, O=Contoso Corporation, C=US" />  
        <win32dependencies:ExternalDependency
            Name="Microsoft.WebView2"
            Publisher="CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
            MinVersion="1.1.1.1"
            Optional="true"/>
    </Dependencies>  
</Package>

Osservazioni

Questa funzionalità richiede l'installazione di Microsoft App Installer versione 1.16.12651.0 o successiva nel computer di destinazione. L'app può essere ottenuta dal Microsoft Store.

Dipendenze esterne consentite

Nella tabella seguente sono elencate le dipendenze esterne attualmente consentite nell'elemento ExternalDependency.

Pacco	Valore attributo name	Valore dell'attributo del server di pubblicazione
webview2	"Microsoft.WebView2"	"CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"

Fabbisogno

Articolo	Valore
virtualizzazione	`http://schemas.microsoft.com/appx/manifest/externaldependencies`

Condividi tramite