win32dependencies:ExternalDependency (Windows 10, Windows 11)

Artigo
08/18/2024

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

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`

Compartilhar via