Apple プライバシーマニフェスト

[アーティクル]
08/08/2024

Apple は、App Store 上の iOS を対象とするアプリのプライバシーポリシーを定めています。アプリには、アプリバンドルにプライバシーマニフェストを含める必要があります。これには、.NET MAUI アプリまたはサードパーティの SDK およびパッケージが収集するデータの種類と、理由が求められる API を使う理由が一覧に含まれています。理由が求められる API またはサードパーティ SDK の使用がプライバシーマニフェストで宣言されていない場合、アプリは App Store によって拒否されることがあります。プライバシーマニフェストの詳細については、developer.apple.com の「Privacy manifest files (プライバシーマニフェストファイル)」を参照してください。

.NET MAUI を使ってアプリを開発するか、.NET MAUI アプリで使うバインディングパッケージを提供するかによって、プライバシーマニフェストを提供するための要件が異なる場合があります。

.NET MAUI アプリのプライバシーマニフェスト

iOS または iPadOS を実行しているデバイスを対象とするすべての .NET MAUI アプリには、アプリバンドル内にプライバシーマニフェストが必要です。詳細については、「プライバシーマニフェストに必要なエントリを追加する」を参照してください。

また、独自のコード、ネイティブコード、データ収集と追跡のプラクティスを確認し、以下に応じてプライバシーマニフェストを更新する必要があります。

アプリまたは SDK が、アプリを使っているユーザーに関するデータを収集する場合は、プライバシーマニフェストでデータの使用を説明する必要があります。詳細については、developer.apple.com の「Describing data use in privacy manifests (プライバシーマニフェストでのデータ使用の説明)」を参照してください。
Apple の理由が求められる API を呼び出す .NET API がアプリまたは SDK に含まれている場合は、これらの各 API の使用状況を評価し、それらを使う理由を宣言する必要があります。理由が求められる API の詳細については、developer.apple.com の「Describing use of required reason API (理由が求められる API の使用の説明)」を参照してください。

Note

アプリにサードパーティの SDK またはパッケージが含まれている場合、これらのサードパーティのコンポーネントには独自のプライバシーマニフェストを個別に含める必要があります。

プライバシーマニフェストは、.NET CLI または Visual Studio を使用して作成された新しい .NET MAUI アプリプロジェクトに自動的に追加されます。既存の .NET MAUI アプリにプライバシーマニフェストを追加する方法については、「既存のアプリにプライバシーマニフェストを追加する」をご覧ください。

重要

上記のガイドラインは利便性のために提供されています。プロジェクトのプライバシーマニフェストを作成する前に、プライバシーマニフェストファイルに関する Apple のドキュメントを確認することが重要です。

バインドプロジェクトのプライバシーマニフェスト

バインドプロジェクトは、2 つのカテゴリ (静的フレームワークバインディングと動的フレームワークバインディング) に分類されます。プライバシーマニフェストは、フレームワークバンドルに格納してフレームワークに含める必要があります。バインドプロジェクトは、正しく配置すると、アプリバンドルに自動的に追加されるため、アプリ開発者はフレームワーク API の使用理由を指定する必要がありません。詳細については、バンドルへのコンテンツの格納に関する記事を参照してください。

動的フレームワークの場合、フレームワークはアプリバンドルに追加されます。プライバシーポリシーマニフェストは、App Store で想定されている場所に追加され、アプリ開発者は何も行う必要がありません。

現在、静的フレームワークをバインドする場合、アプリ開発者は、静的フレームワークに含まれるプライバシーマニフェストをアプリのプライバシーマニフェストに手動でマージする必要があります。これは、静的ライブラリがメインアプリバイナリにリンクされ、フレームワークが不要になるためです。

既存のアプリにプライバシーマニフェストを追加する

既存の .NET MAUI アプリプロジェクトにプライバシーマニフェストを追加するには、PrivacyInfo.xcprivacy という名前の新しい XML ファイルをアプリプロジェクトの Platforms/iOS フォルダーに追加します。 PrivacyInfo.xcprivacy ファイルに .xml 拡張子がないことを確認します。それから、次の XML をファイルに追加します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict/>
</plist>

次に、.NET MAUI アプリプロジェクトファイル (*.csproj) を編集し、ルート <Project> 要素の下部に次の iOS 用ビルド項目を追加します。

<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">
    <BundleResource Include="Platforms\iOS\PrivacyInfo.xcprivacy" LogicalName="PrivacyInfo.xcprivacy" />
</ItemGroup>

これにより、確実にプライバシーマニフェストがバンドルのルートにある iOS アプリにパッケージ化されます。

必要なエントリをプライバシーマニフェストに追加する

iOS または iPadOS を実行しているデバイスを対象とするすべての .NET MAUI アプリには、アプリバンドル内にプライバシーマニフェストが必要です。これは、.NET ランタイムと基本クラスライブラリ (BCL) が、リンカーモードに関係なく削除されない、理由が求められる API を使っていることが原因です。次の表に、.NET MAUI アプリのプライバシーマニフェストに含める必要がある 3 つの API カテゴリとそれに関連付けられた理由を示します。

API カテゴリ	理由	リンク
`NSPrivacyAccessedAPICategoryFileTimestamp`	`C617.1`	File timestamp APIs (ファイルタイムスタンプ API)
`NSPrivacyAccessedAPICategorySystemBootTime`	`35F9.1`	System boot time APIs (システム起動時間 API)
`NSPrivacyAccessedAPICategoryDiskSpace`	`E174.1`	Disk space APIs (ディスク領域 API)

既存の .NET MAUI アプリにプライバシーマニフェストを手動で追加した場合は、これらのエントリをプライバシーマニフェストに追加する必要があります。それには、テキストエディターで PrivacyInfo.xcprivacy ファイルを開き、NSPrivacyAccessAPITypes キーを追加します。続いて、ここに、各 API カテゴリの使用理由 (必須) を追加します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
    </array>
</dict>
</plist>

次に、理由 C617.1 の NSPrivacyAccessedAPICategoryFileTimestamp カテゴリ、理由 35F9.1 の NSPrivacyAccessedAPICategorySystemBootTime カテゴリ、理由 E174.1 の NSPrivacyAccessedAPICategoryDiskSpace カテゴリをプライバシーマニフェストの NSPrivacyAccessedAPITypes 配列に追加します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>C617.1</string>
            </array>
        </dict>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategorySystemBootTime</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>35F9.1</string>
            </array>
        </dict>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryDiskSpace</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>E174.1</string>
            </array>
        </dict>       
    </array>
</dict>
</plist>

これらのエントリは、アプリにとって最低限必要なものです。指定された理由コードによってカバーされない方法で、理由が求められる API のいずれかを使用する場合は、API の使用をサポートするために、新たな理由コードを追加する必要があります。追加の理由コードが必要になる可能性がある .NET ランタイム、.NET 基本クラスライブラリ (BCL)、.NET for iOS、および .NET MAUI での API の使用の詳細については、「関連項目」セクションのリンクを参照してください。

.NET MAUI アプリが Preferences API を使用する、または NSUserDefaults API を直接使用する場合は、プライバシーマニフェストに使用理由を含める必要があります。 NSPrivacyAccessedAPITypes ディクショナリの NSPrivacyAccessedAPIType キーの値として、文字列 NSPrivacyAccessedAPICategoryUserDefaults を使います。たとえば、アプリまたは SDK が .NET MAUI の Preferences API を経由して直接または間接的に NSUserDefaults API を使用する場合、以下のように PrivacyInfo.xcprivacy ファイルの NSPrivacyAccessedAPITypes キーの配列の中に追加の dict 要素を含める必要があります。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>C617.1</string>
            </array>
        </dict>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategorySystemBootTime</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>35F9.1</string>
            </array>
        </dict>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryDiskSpace</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>E174.1</string>
            </array>
        </dict>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>CA92.1</string>
            </array>
        </dict>
    </array>
</dict>
</plist>

developer.apple.com 上のユーザー既定値 API の理由コードを 1 つ以上指定する必要があります。正当な使用方法であることを示すために、以下の理由コードを 1 つ以上追加します。

CA92.1 - 自分のアプリの中だけでユーザー既定値にアクセスします。
1C8F.1 - 同じアプリグループのメンバーであるアプリ、アプリ拡張機能、アプリクリップからユーザー既定値にアクセスします。
C56D.1 - SDK からユーザー既定値にアクセスします。
AC6B.1 - com.apple.configuration.managed または com.apple.feedback.managed キーを読み取るためにユーザー既定値にアクセスします。

重要

アプリ内のコードを変更した場合、アプリの PrivacyInfo.xcprivacy ファイルの更新が必要になる場合があります。これには、Apple の理由が求められる API を呼び出す NuGet パッケージまたはバインドプロジェクトをアプリに追加することが含まれます。

次の方法で共有

Apple プライバシーマニフェスト

.NET MAUI アプリのプライバシーマニフェスト

バインドプロジェクトのプライバシーマニフェスト

既存のアプリにプライバシーマニフェストを追加する

必要なエントリをプライバシーマニフェストに追加する

関連項目

その他のリソース

次の方法で共有

Apple プライバシー マニフェスト

.NET MAUI アプリのプライバシー マニフェスト

バインド プロジェクトのプライバシー マニフェスト

既存のアプリにプライバシー マニフェストを追加する

必要なエントリをプライバシー マニフェストに追加する

関連項目

その他のリソース

Apple プライバシーマニフェスト

.NET MAUI アプリのプライバシーマニフェスト

バインドプロジェクトのプライバシーマニフェスト

既存のアプリにプライバシーマニフェストを追加する

必要なエントリをプライバシーマニフェストに追加する