win32dependencies:ExternalDependency (Windows 10, Windows 11)

Especifica uma dependência externa que não está incluída no MSIX, mas será instalada em cadeia como parte da instalação do aplicativo. Se a versão mínima especificada da dependência externa ainda não estiver instalada no sistema operacional, o aplicativo Instalador de Aplicativo da Microsoft recuperará a versão mínima de um repositório externo e instalará a dependência. A Microsoft mantém uma lista de dependências que podem ser instaladas usando esse método. Consulte a seção Comentários para obter a lista atual de pacotes permitidos.

Hierarquia de elementos

<Pacote>

    [<Dependências>]

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

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Valor padrão
Nome	O nome do pacote de dependência. Para obter a lista de pacotes de dependência permitidos, consulte a seção Comentários abaixo.	Uma cadeia de caracteres entre 3 e 50 caracteres de comprimento que consiste apenas em caracteres alfanuméricos, períodos e traços.	Sim
Publicador	O editor do pacote de dependência.	Uma cadeia de caracteres com um valor entre 1 e 8.192 caracteres de comprimento que se ajusta à expressão regular de um nome diferenciado.	Sim
MinVersion	A versão mínima da dependência externa. Se o sistema operacional já tiver a versão mínima instalada, a instalação não será disparada.	Uma cadeia de caracteres de versão na notação quad, ondeMajor.Minor.Build.RevisionMajor não 0é .	Sim
Opcional	Quando a instalação é executada sem uma conexão com a Internet e esse valor é falso, a instalação será concluída sem instalar a dependência externa. Se esse valor for verdadeiro, uma instalação sem conexão com a Internet falhará.	Um valor booliano.	Sim

Elementos filho

Nenhum.

Elementos pai

Elemento pai	Descrição
Dependências	Declara outros pacotes dos quais um pacote depende para concluir seu software.

Exemplos

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

Comentários

Esse recurso requer que Instalador de Aplicativo da Microsoft versão 1.16.12651.0 ou posterior seja instalada no computador de destino. O aplicativo pode ser obtido da Microsoft Store.

Dependências externas permitidas

A tabela a seguir lista as dependências externas que atualmente são permitidas no elemento ExternalDependency .

Pacote	Valor do atributo name	Valor do atributo Publisher
Webview2	"Microsoft.WebView2"	"CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"

Requisitos

Item	Valor
virtualização	http://schemas.microsoft.com/appx/manifest/externaldependencies