Compartir a través de

win32dependencies:ExternalDependency (Windows 10, Windows 11)

  • Artículo

Especifica una dependencia externa que no se incluye en MSIX, pero que se instalará como parte de la instalación de la aplicación. Si la versión mínima especificada de la dependencia externa aún no está instalada en el sistema operativo, la aplicación Microsoft App Installer recuperará la versión mínima de un repositorio externo e instalará la dependencia. Microsoft mantiene una lista de dependencias que se pueden instalar mediante este método. Consulte la sección comentarios de para obtener la lista actual de paquetes permitidos.

Importante

win32dependencies:ExternalDependency solo se aplica a las instalaciones que usan la aplicación Microsoft App Installer. Si un paquete se instala con cualquier otro mecanismo, como la API de PackageManager, un cmdlet de PowerShell, Microsoft Intune o cualquier otro mecanismo que no sea a través de la aplicación instalador de aplicaciones, se omite win32dependencies:ExternalDependency.

Jerarquía de elementos

del paquete de

    [<Dependencias>]

          <win32dependencies:ExternalDependency>

Sintaxis

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

Atributos y elementos

Atributos

Atributo Descripción Tipo de dato Obligatorio Valor predeterminado
nombre de Nombre del paquete de dependencia. Para obtener la lista de paquetes de dependencia permitidos, consulte la sección Comentarios a continuación. Cadena entre 3 y 50 caracteres de longitud que consta de caracteres alfanuméricos, puntos y guiones únicamente. Sí
Publisher Publicador del paquete de dependencias. Cadena con un valor entre 1 y 8192 caracteres de longitud que se ajusta a la expresión regular de un nombre distintivo. Sí
MinVersion Versión mínima de la dependencia externa. Si el sistema operativo ya tiene instalada la versión mínima, no se desencadenará la instalación. Cadena de versión en notación cuádruple, (Major.Minor.Build.Revision) donde Major no es 0. Sí
opcional Cuando la instalación se realiza sin conexión a Internet y este valor es false, la instalación se completará sin instalar la dependencia externa. Si este valor es true, se producirá un error en una instalación sin conexión a Internet. Valor booleano. Sí

Elementos secundarios

Ninguno.

Elementos primarios

Elemento primario Descripción
dependencias de Declara otros paquetes de los que depende un paquete para completar su software.

Ejemplos

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

Observaciones

Esta característica requiere que microsoft App Installer versión 1.16.12651.0 o posterior se instale en el equipo de destino. La aplicación se puede obtener de Microsoft Store.

Dependencias externas permitidas

En la tabla siguiente se enumeran las dependencias externas permitidas actualmente en el elemento ExternalDependency.

Paquete Valor del atributo Name Valor del atributo publisher
Webview2 "Microsoft.WebView2" "CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"

Requisitos

Artículo Valor
virtualización http://schemas.microsoft.com/appx/manifest/externaldependencies