win32dependencies:ExternalDependency (Windows 11, Windows 10)

Wichtig

Im Hinblick auf Installationszeit und Laufzeit gilt win32dependencies:ExternalDependency nur für Installationen, die die Microsoft App Installer-App verwenden. Wenn ein Paket mit einem anderen Mechanismus wie der PackageManager-API oder einem PowerShell-Cmdlet oder Microsoft Intune oder einem anderen Mechanismus als über die App Installer-App installiert wird, wird win32dependencies:ExternalDependency ignoriert.

Wichtig

In Bezug auf die Buildzeit wird win32dependencies:ExternalDependency nicht von PackageWriter, makeappx.exeoder AppxManifestReader überprüft.

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.

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	Standardwert
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 0ist.	Ja
Optionaler	Wenn die Installation ohne Internetverbindung ausgeführt wird und dieser Wert true ist, wird die Installation abgeschlossen, ohne die externe Abhängigkeit zu installieren. Wenn dieser Wert "false" 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