win32dependencies:ExternalDependency (Windows 10, Windows 11)

Artikel
08/18/2024

Gibt eine externe Abhängigkeit an, die nicht im MSIX enthalten ist, sondern als Teil der App-Installation verkettet wird. Wenn die angegebene Mindestversion der externen Abhängigkeit noch nicht auf dem Betriebssystem installiert ist, ruft die Microsoft App Installer-App die Mindestversion aus einem externen Repository ab und installiert die Abhängigkeit. Microsoft verwaltet eine Liste von Abhängigkeiten, die mit dieser Methode installiert werden können. Die aktuelle Liste der zulässigen Pakete finden Sie im Abschnitt Anmerkungen.

Wichtig

win32dependencies:ExternalDependency gilt nur für Installationen, die die Microsoft App Installer-App verwenden. Wenn ein Paket mithilfe eines anderen Mechanismus installiert wird, z. B. die PackageManager-API, ein PowerShell-Cmdlet, Microsoft Intune oder einen anderen Mechanismus als über die App Installer-App, wird win32dependencies:ExternalDependency ignoriert.

Elementhierarchie

<-Paket->

[<Abhängigkeiten>]

<win32dependencies:ExternalDependency>

Syntax

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

Attribute und Elemente

Attribute

Attribut	Beschreibung	Datentyp	Erforderlich
Name	Der Name des Abhängigkeitspakets. Eine Liste der zulässigen Abhängigkeitspakete finden Sie im Abschnitt "Hinweise" weiter unten.	Eine Zeichenfolge zwischen 3 und 50 Zeichen länge, die nur aus alphanumerischen Zeichen, Punkten und Gedankenstrichen besteht.	Ja
Publisher-	Der Herausgeber des Abhängigkeitspakets.	Eine Zeichenfolge mit einem Wert zwischen 1 und 8192 Zeichen länge, die dem regulären Ausdruck eines distinguishierten Namens entspricht.	Ja
MinVersion-	Die Mindestversion der externen Abhängigkeit. Wenn das Betriebssystem bereits die Mindestversion installiert hat, wird die Installation nicht ausgelöst.	Eine Versionszeichenfolge in vierer Schreibweise(`Major.Minor.Build.Revision`), wobei `Major` nicht `0`ist.	Ja
Optionaler	Wenn die Installation ohne Internetverbindung ausgeführt wird und dieser Wert falsch ist, wird die Installation abgeschlossen, ohne die externe Abhängigkeit zu installieren. Wenn dieser Wert "true" ist, schlägt eine Installation ohne Internetverbindung fehl.	Ein boolescher Wert.	Ja

Untergeordnete Elemente

Nichts.

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
Abhängigkeiten	Deklariert andere Pakete, von denen ein Paket abhängig ist, um seine Software abzuschließen.

Beispiele

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

Bemerkungen

Für dieses Feature muss Microsoft App Installer, Version 1.16.12651.0 oder höher, auf dem Zielcomputer installiert werden. Die App kann aus dem Microsoft Storeabgerufen werden.

Zulässige externe Abhängigkeiten

In der folgenden Tabelle sind die externen Abhängigkeiten aufgeführt, die derzeit im ExternalDependency-Element zulässig sind.

Paket	Name-Attributwert	Publisher-Attributwert
Webview2-	"Microsoft.WebView2"	"CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"

Anforderungen

Artikel	Wert
Virtualisierung	`http://schemas.microsoft.com/appx/manifest/externaldependencies`

Freigeben über