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

属性と要素

属性

属性	説明	データ型	必須
名前	依存関係パッケージ名。許可される依存関係パッケージの一覧については、以下の「解説」セクションを参照してください。	英数字、ピリオド、ダッシュのみで構成される 3 ~ 50 文字の長さの文字列。	はい
発行元	依存関係パッケージの発行元。	識別名の正規表現に適合する長さが 1 ~ 8192 文字の文字列。	はい
MinVersion	外部依存関係の最小バージョン。 OS に最小バージョンが既にインストールされている場合、インストールはトリガーされません。	四角形表記のバージョン文字列。(`Major.Minor.Build.Revision`) `Major` は指定されていません `0`。	はい
省略可能	インターネット接続なしでインストールが実行され、この値が false の場合、インストールは外部依存関係をインストールせずに完了します。この値が true の場合、インターネットに接続されていないインストールは失敗します。	ブール値。	はい

子要素

なし。

親要素

Parent 要素	説明
依存関係	パッケージがそのソフトウェアを完了するために依存する他のパッケージを宣言します。

例

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

Remarks

この機能を使用するには、Microsoft アプリインストーラーバージョン 1.16.12651.0 以降をターゲットコンピューターにインストールする必要があります。アプリは Microsoft Store から取得できます。

許可される外部依存関係

次の表に、 ExternalDependency 要素で現在許可されている外部依存関係を示します。

Package	名前の属性値	パブリッシャーの属性値
Webview2	"Microsoft.WebView2"	"CN=Microsoft Windows、O=Microsoft Corporation、L=Redmond、S=Washington、C=US"

要件

Item	値
仮想化	`http://schemas.microsoft.com/appx/manifest/externaldependencies`

Share via