win32dependencies:ExternalDependency (Windows 10, Windows 11)

  • Artículo

Especifica una dependencia externa que no está incluida en MSIX, pero se encadenará 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 Instalador de aplicación de Microsoft 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 para obtener la lista actual de paquetes permitidos .

Jerarquía de elemento

<Paquete>

    [<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 datos Obligatorio Valor predeterminado
Nombre 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í
Publicador 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 0es . 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. Un valor booleano. Sí

Elementos secundarios

Ninguno.

Elementos primarios

Elemento primario Descripción
Dependencias 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 Instalador de aplicación de Microsoft versión 1.16.12651.0 o posterior se instalen 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

Elemento Value
virtualización http://schemas.microsoft.com/appx/manifest/externaldependencies