win32dependencies:ExternalDependency (Windows 10, Windows 11)

Artikel
01/02/2025

Hiermee geeft u een externe afhankelijkheid op die niet is opgenomen in de MSIX, maar wordt een keten geïnstalleerd als onderdeel van de installatie van de app. Als de opgegeven minimale versie van de externe afhankelijkheid nog niet is geïnstalleerd op het besturingssysteem, haalt de Microsoft App Installer-app de minimale versie op uit een externe opslagplaats en installeert u de afhankelijkheid. Microsoft onderhoudt een lijst met afhankelijkheden die met deze methode kunnen worden geïnstalleerd. Zie de sectie Opmerkingen voor de huidige lijst met toegestane pakketten.

Belangrijk

win32dependencies:ExternalDependency alleen van toepassing op installaties die gebruikmaken van de App Installer-app van Microsoft. Als een pakket is geïnstalleerd met behulp van een ander mechanisme, zoals de PackageManager-API, een PowerShell-cmdlet, Microsoft Intune of een ander mechanisme dan via de app App Installer, wordt win32dependencies:ExternalDependency genegeerd.

Elementhiërarchie

[<afhankelijkheden>]

<win32dependencies:ExternalDependency>

Syntaxis

<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.' />

Kenmerken en elementen

Kenmerken

Attribuut	Beschrijving	Gegevenstype	Vereist
naam	De naam van het afhankelijkheidspakket. Zie de sectie Opmerkingen hieronder voor de lijst met toegestane afhankelijkheidspakketten.	Een tekenreeks tussen 3 en 50 tekens lang die alleen uit alfanumerieke tekens, punten en streepjes bestaat.	Ja
Publisher-	De uitgever van het afhankelijkheidspakket.	Een tekenreeks met een waarde tussen 1 en 8192 tekens in lengte die past bij de reguliere expressie van een DN-naam.	Ja
MinVersion-	De minimale versie van de externe afhankelijkheid. Als het besturingssysteem al de minimale versie heeft geïnstalleerd, wordt de installatie niet geactiveerd.	Een versietekenreeks in quad-notatie, (`Major.Minor.Build.Revision`) waarbij `Major` niet is `0`.	Ja
Optionele	Wanneer de installatie wordt uitgevoerd zonder internetverbinding en deze waarde waar is, wordt de installatie voltooid zonder de externe afhankelijkheid te installeren. Als deze waarde onwaar is, mislukt een installatie zonder internetverbinding.	Een Booleaanse waarde.	Ja

Onderliggende elementen

Geen.

Bovenliggende elementen

Bovenliggend element	Beschrijving
afhankelijkheden	Declareert andere pakketten waaraan een pakket afhankelijk is om de software te voltooien.

Voorbeelden

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

Opmerkingen

Voor deze functie moet Microsoft App Installer versie 1.16.12651.0 of hoger op de doelcomputer zijn geïnstalleerd. De app kan worden verkregen uit de Microsoft Store.

Toegestane externe afhankelijkheden

De volgende tabel bevat de externe afhankelijkheden die momenteel zijn toegestaan in het element ExternalDependency.

Pak	Naamkenmerkwaarde	Waarde van publisher-kenmerk
Webview2-	"Microsoft.WebView2"	"CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"

Eisen

Item	Waarde
virtualisatie	`http://schemas.microsoft.com/appx/manifest/externaldependencies`

Delen via