win32dependencies:ExternalDependency(Windows 10, Windows 11)

아티클
08/31/2023

MSIX에 포함되지 않지만 앱 설치의 일부로 체인이 설치되는 외부 종속성을 지정합니다. 지정된 최소 버전의 외부 종속성이 OS에 아직 설치되지 않은 경우 Microsoft 앱 설치 관리자 앱은 외부 리포지토리에서 최소 버전을 검색하고 종속성을 설치합니다. Microsoft는 이 메서드를 사용하여 설치할 수 있는 종속성 목록을 유지 관리합니다. 허용되는 패키지의 현재 목록은 주의 섹션을 참조하세요.

요소 계층 구조

<패키지>

[<종속성>]

<win32dependencies:ExternalDependency>

구문

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

특성 및 요소

특성

attribute	Description	데이터 형식	필수
이름	종속성 패키지 이름입니다. 허용되는 종속성 패키지 목록은 아래 설명 섹션을 참조하세요.	알파 숫자 문자, 마침표 및 대시로만 구성된 길이가 3자에서 50자 사이의 문자열입니다.	예
게시자	종속성 패키지의 게시자입니다.	고유 이름의 정규식에 맞는 길이가 1~8192자인 문자열입니다.	예
MinVersion	외부 종속성의 최소 버전입니다. OS에 이미 설치된 최소 버전이 있는 경우 설치가 트리거되지 않습니다.	()`Major`가 아닌 `0`쿼드 표기법`Major.Minor.Build.Revision`의 버전 문자열입니다.	예
선택 사항	인터넷 연결 없이 설치가 수행되고 이 값이 false이면 외부 종속성을 설치하지 않고 설치가 완료됩니다. 이 값이 true이면 인터넷에 연결되지 않은 설치가 실패합니다.	부울 값입니다.	예

자식 요소

없음

부모 요소

부모 요소	Description
종속성	패키지가 소프트웨어를 완료하기 위해 종속되는 다른 패키지를 선언합니다.

예제

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

설명

이 기능을 사용하려면 Microsoft 앱 설치 관리자 버전 1.16.12651.0 이상을 대상 컴퓨터에 설치해야 합니다. Microsoft Store에서 앱을 가져올 수 있습니다.

허용되는 외부 종속성

다음 표에서는 ExternalDependency 요소에서 현재 허용되는 외부 종속성을 나열합니다.

패키지	이름 특성 값	게시자 특성 값
Webview2	"Microsoft.WebView2"	"CN=Microsoft Windows, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"

요구 사항

항목	값
가상화(virtualization)	`http://schemas.microsoft.com/appx/manifest/externaldependencies`