Compartilhar via

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 Comentários para obter a lista atual de pacotes permitidos.

Importante

win32dependencies:ExternalDependency se aplica apenas 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 do Powershell, o Microsoft Intune ou qualquer outro mecanismo que não seja por meio do aplicativo Instalador de Aplicativos, win32dependencies:ExternalDependency será ignorado.

Hierarquia de elementos

do 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 dado Necessário Valor padrão
Name 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
Publisher 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 em quad notation, (Major.Minor.Build.Revision) em que Major não é 0. Sim
opcional Quando a instalação é executada sem uma conexão com a Internet e esse valor é verdadeiro, a instalação será concluída sem instalar a dependência externa. Se esse valor for falso, 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>

Observações

Esse recurso requer que o Microsoft App Installer versão 1.16.12651.0 ou posterior seja instalado no computador de destino. O aplicativo pode ser obtido noda 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 de nome 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