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 Microsoft App Installer 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 Observações para obter a lista atual de pacotes permitidos.

Importante

win32dependencies:ExternalDependency só se aplica a instalações que usam o aplicativo Microsoft App Installer. Se um pacote for instalado usando qualquer outro mecanismo, como a API PackageManager, um cmdlet Powershell, o Microsoft Intune ou qualquer outro mecanismo que não seja por meio do aplicativo App Installer, win32dependencies:ExternalDependency será ignorado.

Hierarquia de elementos

<Pacote>

    [<Dependências>]

          <win32dependencies:ExternalDependency>

Sintaxe

<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	Necessá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 que consiste apenas em caracteres alfanuméricos, pontos e traços.	Sim
Publisher	O editor do pacote de dependência.	Uma cadeia de caracteres com um valor entre 1 e 8192 caracteres de comprimento que se ajusta à expressão regular de um nome distinto.	Sim
MinVersion	A versão mínima da dependência externa. Se o SO já tiver a versão mínima instalada, a instalação não será acionada.	Uma cadeia de caracteres de versão em notação quad, (Major.Minor.Build.Revision) onde Major não é 0.	Sim
opcional	Quando a instalação é executada sem uma conexão com a Internet e esse valor é true, a instalação será concluída sem instalar a dependência externa. Se esse valor for false, uma instalação sem conexão com a Internet falhará.	Um valor booleano.	Sim

Elementos filho

Nenhuma.

Elementos pai

Elemento pai	Descrição
Dependências	Declara outros pacotes dos quais um pacote depende para completar 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 o Microsoft App Installer versão 1.16.12651.0 ou posterior esteja instalado na máquina de destino. O aplicativo pode ser obtido na Microsoft Store.

Dependências externas permitidas

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

Embalagem	Valor do atributo Name	Valor do atributo do editor
Webview2	"Microsoft.WebView2"	"CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=EUA"

Requerimentos

Número	Valor
virtualização	http://schemas.microsoft.com/appx/manifest/externaldependencies