win32dependencies:ExternalDependency(Windows 10, Windows 11)

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

요소 계층 구조

<패키지>
<종속성>
<win32dependencies:ExternalDependency>

구문

<win32dependencies:ExternalDependency Name = A string between 3 and 50 characters in
                                   length that consists of alpha-numeric, 
                                   period, and dash characters. 
                            Publisher = A string between 1 and 8192 characters in length that fits the regular expression  of a distinguished name : "(CN | L | O | OU | E | C | S | STREET | T | G | I | SN | DC | SERIALNUMBER | Description | PostalCode | POBox | Phone | X21Address | dnQualifier | (OID\.(0 | [1-9][0-9]*)(\.(0 | [1-9][0-9]*))+))=(([^,+="<>#;])+ | ".*")(, ((CN | L | O | OU | E | C | S | STREET | T | G | I | SN | DC | SERIALNUMBER | Description | PostalCode | POBox | Phone | X21Address | dnQualifier | (OID\.(0 | [1-9][0-9]*)(\.(0 | [1-9][0-9]*))+))=(([^,+="<>#;])+ | ".*")))*". Further, semantic validation ensures that the string is compliant with CertNameToStr Windows API implementation of X.500 rules.
                            MinVersion = A version string in quad notation, "Major.Minor.Build.Revision".
                            Optional = boolean>
</win32dependencies:ExternalDependency>

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
이름 종속성 패키지 이름입니다. 허용되는 종속성 패키지 목록은 아래 설명 섹션을 참조하세요. 영숫자, 마침표 및 대시 문자로 구성된 길이가 3~50자인 문자열입니다. Yes
게시자 종속성 패키지의 게시자입니다. 고유 이름의 정규식에 맞는 길이가 1자에서 8192자 사이의 문자열입니다. "(CN | L | O | OU | E | C | S | STREET | T | G | | SN | DC | SERIALNUMBER | 설명 | PostalCode | POBox | 전화 | X21Address | dnQualifier | (OID. (0 | [1-9] [0-9] )(.( 0 | [1-9] [0-9])) +))=(([^,+="<>#;]) + | ". ")(, ((CN | L | O | OU | E | C | S | STREET | T | G | | SN | DC | SERIALNUMBER | 설명 | PostalCode | POBox | 전화 | X21Address | dnQualifier | (OID. (0 | [1-9] [0-9]) (. (0 | [1-9] [0-9] ))+))=(([^,+="<>#;]) + | "."))) *". 또한 의미 체계 유효성 검사는 문자열이 X.500 규칙의 CertNameToStr Windows API 구현을 준수하는지 확인합니다.
MinVersion 외부 종속성의 최소 버전입니다. OS에 이미 최소 버전이 설치된 경우 설치가 트리거되지 않습니다. 쿼드 표기법 "Major.Minor.Build.Revision"의 버전 문자열입니다. Yes
선택 사항 인터넷 연결 없이 설치를 수행하고 이 값이 false이면 외부 종속성을 설치하지 않고 설치가 완료됩니다. 이 값이 true이면 인터넷에 연결되지 않은 설치가 실패합니다. 쿼드 표기법 "Major.Minor.Build.Revision"의 버전 문자열입니다. Yes

 

자식 요소

없음

부모 요소

부모 요소 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"

요구 사항

네임스페이스
win32dependencies "http://schemas.microsoft.com/appx/manifest/externaldependencies"