win32dependencies :ExternalDependency (Windows 10, Windows 11)

Article
08/18/2024

Spécifie une dépendance externe qui n’est pas incluse dans MSIX, mais qui sera installée dans le cadre de l’installation de l’application. Si la version minimale spécifiée de la dépendance externe n’est pas déjà installée sur le système d’exploitation, l’application Microsoft App Installer récupère la version minimale d’un référentiel externe et installe la dépendance. Microsoft gère une liste de dépendances qui peuvent être installées à l’aide de cette méthode. Consultez la section Remarques pour obtenir la liste actuelle des packages autorisés.

Important

win32dependencies :ExternalDependency s’applique uniquement aux installations qui utilisent l’application Microsoft App Installer. Si un package est installé à l’aide d’un autre mécanisme, tel que l’API PackageManager , une applet de commande PowerShell, Microsoft Intune ou tout autre mécanisme autre que via l’application App Installer, win32dependencies :ExternalDependency est ignoré.

Hiérarchie d’éléments

[<Dépendances>]

<win32dependencies :ExternalDependency>

Syntaxe

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

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
Nom	Nom du package de dépendances. Pour obtenir la liste des packages de dépendances autorisés, consultez la section Remarques ci-dessous.	Chaîne comprise entre 3 et 50 caractères de longueur qui se compose de caractères alphanumériques, de points et de tirets uniquement.	Oui
Publisher	Éditeur du package de dépendances.	Chaîne avec une valeur comprise entre 1 et 8192 caractères, qui correspond à l’expression régulière d’un nom unique.	Oui
MinVersion	Version minimale de la dépendance externe. Si la version minimale du système d’exploitation est déjà installée, l’installation n’est pas déclenchée.	Chaîne de version en quad notation, (`Major.Minor.Build.Revision`) où `Major` n’est pas `0`.	Oui
facultatif	Lorsque l’installation est effectuée sans connexion Internet et que cette valeur est false, l’installation se termine sans installer la dépendance externe. Si cette valeur est true, une installation sans connexion Internet échoue.	Valeur booléenne.	Oui

Éléments enfants

Aucun.

Éléments parents

Parent, élément	Description
dépendances	Déclare d’autres packages dont dépend un package pour terminer son logiciel.

Exemples

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

Remarques

Cette fonctionnalité nécessite l’installation de Microsoft App Installer version 1.16.12651.0 ou ultérieure sur l’ordinateur cible. L’application peut être obtenue à partir du Microsoft Store.

Dépendances externes autorisées

Le tableau suivant répertorie les dépendances externes actuellement autorisées dans l’élément ExternalDependency.

Colis	Valeur de l’attribut Name	Valeur de l’attribut Publisher
webview2	« Microsoft.WebView2 »	« CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US »

Exigences

Article	Valeur
virtualisation	`http://schemas.microsoft.com/appx/manifest/externaldependencies`

Partager via