メイン コンテンツにスキップ
Capgo ロゴ
開発 モバイル セキュリティ

Privacy Manifest for Capacitor Apps: Guide

アプリのプライバシー マニフェストを作成して、アプリ ストアの要件に準拠し、ユーザー データを効果的に保護する方法を学びましょう。

マーティン ドナディュー

マーティン ドナディュー

コンテンツ マーケティング
Capacitor アプリのプライバシー マニフェスト: ガイド

__CAPGO_KEEP_0__ アプリをアプリ ストアにデリートなしでリリースしたいですか? Capacitor アプリ ストア 遅れなくリリースしたい場合は、まずプライバシー マニフェストを作成してください。 Apple は、開発者がこの文書を含めることを要求しており、これによりアプリが厳格なプライバシー基準を満たすことが保証されます。ここでは、必要な情報について説明します。 プライバシー マニフェストとは何ですか? What is a Privacy Manifest?

  • Start by creating a Privacy Manifest. Apple now requires developers to include this document to ensure apps meet strict privacy standards. Here’s what you need to know:
    アプリのデータ収集の実践、API の使用、トラッキングドメインを記述した構造化されたファイル。

  • なぜ重要なのか:

    • アプリストアの規則に準拠し、却下または削除を回避する。
    • ユーザーデータの取り扱いについて、透明性を保ち、信頼を築く。

  • 「必要なコンポーネント」

    • ユーザーデータにアクセスするAPI (例: 位置情報、写真)。
    • データ収集されたデータの種類のプライバシーラベル。
    • アナリティクスや広告のために使用されるドメインを追跡します。

  • Capgoを使用して1つを作る方法

    • データ収集の詳細を JSON で定義してください。
    • 位置を置く PrivacyInfo.xcprivacy プロジェクトの正しいディレクトリ内にファイルを置いてください。
    • ツールで検証してください Xcode エラーを回避するために。

  • プロセスを簡素化するツール:
    自動化されたプライバシーマニフェストの検証、リアルタイムの更新、およびエラーの追跡を含む Capgo プライバシーマニフェストの基本

プライバシーマニフェストの定義

プライバシーマニフェストは、アプリのデータの取り扱いを概説した構造化されたファイルです。ユーザーデータにアクセスするAPI、トラッキングドメイン、収集されるデータの種類、および第三者

の

A privacy manifest is a structured file that outlines your app’s data practices. It details elements like APIs accessing user data, tracking domains, data types collected, and third-party SDK integrations. This document not only helps establish trust but also ensures compliance with App Store guidelines. Let’s break down the key components your manifest should include.

プライバシーマニフェストの主な要素

Appleの要件に沿ったプライバシーマニフェストに含めるべき主な要素はこちらです。

  1. 必要な理由API
    このセクションでは、プライバシーに敏感なAPIを使用しているアプリと、その必要性を説明しています。

    以下は、一般的なAPI要件の概要表です。

    API カテゴリー一般的な使用方法必要なドキュメント
    位置情報サービスユーザーがナビゲートする目的の文字列と使用方法の説明
    写真ライブラリプロフィール画像アクセス権限と意図
    連絡先アドレス帳の同期データ最小化声明

  2. プライバシー ラベル
    これらのラベルは、以下を明確に指定することで透明性を提供します。

    • 収集されるデータの種類
    • データ収集の理由
    • データがユーザー ID に関連しているかどうか
    • データがトラッキングに使用されている方法

  3. トラッキング ドメイン
    このセクションでは、分析、広告、または第三者データ処理に使用されるドメインをすべてリストします。

「App Storeの規制に適合する」 - Capgo [1]

Capgoによると、95%のユーザーは24時間以内に更新を実行する [1]__CAPGO_KEEP_0__を利用して、2300万以上の更新を実行

プライバシー文書を最新の状態に保つことは、ユーザーの信頼を維持するために不可欠です。 Capacitor

Capacitor

__CAPGO_KEEP_0__フレームワークドキュメントサイト

セットアップ要件

  • マニフェストを構築する前に、以下の条件を確認してください。
  • A Capacitor 8.0+ project set up
  • __CAPGO_KEEP_0__ 8.0+プロジェクトをセットアップ Info.plist アプリのファイルへのアクセス権
  • JSON構造の基本的な理解
  • アプリのデータ収集実践に関するドキュメント

作成手順

まず、iOSプロジェクトディレクトリに PrivacyInfo.xcprivacy ファイルを作成します。このファイルは、特定のフォーマットガイドラインに従う必要があります:

基本情報の設定

{
    "NSPrivacyTracking": false,
    "NSPrivacyTrackingDomains": [],
    "NSPrivacyCollectedDataTypes": []
}

データ収集の詳細を定義

{
    "NSPrivacyAccessedAPITypes": [
        {
            "NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["1.1"]
        },
        {
            "NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["2.1"]
        }
    ]
}

トラッキングドメインの追加

{
    "NSPrivacyTrackingDomains": [
        "analytics.yourdomain.com",
        "metrics.yourdomain.com"
    ]
}

よくあるミスを避ける

問題を防ぐために、次の点を考慮してください:

  • すべての必須フィールドを含めるフィールドが空でも、必ず存在する必要があります。
  • 正しい API を使用してください: Apple の公式ドキュメントで API の識別子を確認してください。
  • JSON のフォーマットを確認してください: JSON リンターを実行してシンタックス エラーを検出してください。
  • __CAPGO_KEEP_0__ のアクセスには、対応する __CAPGO_KEEP_1__ の理由を含めるようにしてください。: Make sure every API access includes a corresponding reason code.
  • Capgo にプライバシー マニフェストを追加するファイル配置ガイド

Also, ensure the manifest file stays under 512KB to avoid build errors. Regularly validate the file during Xcode’s build process to catch mistakes early. Once your manifest is ready, integrate it into your Capacitor project by following the file placement guidelines.

Adding Privacy Manifests to Capacitor

Capacitor

To include a privacy manifest in your Capacitor project, place the PrivacyInfo.xcprivacy 指定されたディレクトリ構造内のファイル:

your-app/
├── ios/
│   ├── App/
│   │   ├── PrivacyInfo.xcprivacy
│   │   └── Info.plist
│   └── App.xcworkspace

Capgo Capacitor プラグインの場合、次の構造を使用してください:

your-plugin/
├── ios/
│   ├── Plugin/
│   │   └── PrivacyInfo.xcprivacy
│   └── Plugin.xcodeproj

ビルド設定の設定

ファイルが置かれたら、Xcodeのビルド設定を更新して適切に統合されるようにしてください:

  1. Xcodeでプロジェクトを開いてください。
  2. 「TARGETS」セクションの下で、 ターゲットを選択してください。「ビルド設定」タブを選択してください。
  3. 設定 Cloudflare Capacitor
  4. GitHub プライバシーマニフェスト開発地域 に en.
  5. 設定 プライバシーマニフェストを含める に YES.

あなたのプロジェクトが CocoaPodsを使用している場合 Podfile 、以下のスニペットをあなたの

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['INCLUDE_PRIVACY_MANIFEST'] = 'YES'
    end
  end
end

プライバシーマニフェストを有効にするために

変更を加えた後、実装チェックに進み、すべてが正しく設定されていることを確認する。

実装チェック

  1. ビルド検証

    • ビルド中にプライバシーに関する警告がないことを確認してください。
    • マニフェストのコンパイルに問題がないことを確認してください。
    • ビルド製品にプライバシー マニフェストが含まれていることを確認してください。

  2. 実行時検証

    • デバッグモードで、適切なプライバシー ポップアップと API アクセス動作が正しく機能していることを確認してください。

  3. App Store Connect検証

    • ビルドをアップロードし、App Store Connectでプライバシー レポートを確認してください。
    • API 宣言が完全で、トラッキング ドメイン形式が正しいことを確認してください。

「プライバシー マニフェスト検証失敗」エラーが発生した場合、最新のApp Store要件を満たしていることを確認し、 API 型とトラッキング ドメイン構成を特に注意して確認してください。

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

テストと修正

Appleのガイドラインを満たすプライバシーマニフェストを作成することは重要です。目標を達成するために、開発プロセスに信頼できるエラートラッキングを統合する必要があります。これにより、開発の取り組みと合規性の要件がリンクされます。

のようなツール Capgo は、APIのアクセスを監視し、ユーザーに影響を与える前にマニフェストの問題を特定することができます。問題が指摘されたら、徹底的な検証に焦点を当てることができます。

更新を実施した後、開発環境でマニフェストをテストしてください。エラートラッキングの洞察に基づいてレビューを導きます。このアプローチにより、Appleのプライバシースタンダードと整列するようにアプリを保証できます。

Capgo プライバシーツール

Capgo Live Update Dashboard インターフェイス

Capgoは、プライバシーマニフェストとアプリの更新の管理を簡素化し、遅延を伴わずにプライバシースタンダードを維持することができます。

Capgo機能

100を超える 23.5百万のセキュアなアップデート そして 82%のグローバル成功率, Capgoは 95%のアクティブユーザーが24時間以内にアップデートを受信することを保証します。 [1]ここでは、以下の機能が提供されます。

  • エンドツーエンドの暗号化 アップデートをセキュアに保つ
  • チャンネルシステム アップデートの配布を制御
  • エラー追跡 問題を迅速に特定および解決する
  • 1クリックでロールバック 直前のバージョンに即座に戻ることができます。

これらのツールは、ワークフローにCapgoを追加することをスムーズかつ効率的に行うのに役立ちます。

Capgoを使用します。

「始め方」を知りたい場合は、以下の手順に従ってください。 install the Capgo plugin このコマンドを使用します。

npx @capgo/cli init

CapgoはCI/CDパイプラインと完全に統合され、Cloudflare、GitHubなどのプラットフォームを通じてプライバシー マニフェストの検証を自動化します。 GitHub アクション, GitLab CI、または Jenkins. Capgoは、クラウドまたは自社ホストのオプションを選ばれますが、750の生産アプリケーションをサポートし、プライバシー基準に準拠したすべての更新を確実に実行します。

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” – Rodrigo Mantica

“Capgo is a smart way to make hot code pushes 🙂” – NASA’s OSIRIS-REx

Capgo also includes built-in analytics to monitor update success rates and user engagement in real time. This ensures privacy updates reach your entire user base while staying compliant with Apple’s guidelines.

  • 安全性を確保するためのバックアップとしての迅速な修正
  • 自動検証規制基準を満たす更新を確実にする

AppleとGoogleのプライバシー要件の進化に追随するために、信頼できる更新システムを構築することは、アプリストアの承認率の向上とユーザーの信頼性の強化に役立ちます。 [1].

はじめに

これらの原則を実装するには、以下の手順を実行してください。

  • 環境を設定する: Run npx @capgo/cli init を実行してください。
  • プライバシー機能を有効にする: 安全な更新のためにエンドツーエンド暗号化を使用する
  • 監視ツールをデプロイする: アナリティクスでアップデートを追跡する。
  • ロールバック計画: 必要に応じて、以前のバージョンに戻ることができるようにしてください。

“Capgoは、開発者が生産性を高めるために必要なツールです。バグ修正のレビュー遅延を回避することは、ゲームチェンジャーです。” - Bessie Cooper

定期の更新と適切なツールは、規制の遵守と時間の経過とともに改善するための鍵です。

Capacitorアプリのリアルタイム更新

Capgoアプリの場合、ウェブ層のバグが発生した場合、通常のアプリストアの承認待ちではなく、Capgoを通じて修正を配信することができます。ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー経路で残ります。

はじめに

ブログの最新記事

Capgoを使用すると、プロフェッショナルなモバイルアプリを作成するために必要な最良の洞察を得ることができます。

Capacitorアプリの2方向コミュニケーション
開発、モバイル、更新
2025年4月26日

Capacitor アプリの2方向通信

モバイル アプリのライブ更新における5つの一般的なミス
開発、セキュリティ、更新
2025年4月13日

モバイル アプリのライブ更新における5つの一般的なミス

モバイル アプリのライブ更新におけるセキュリティのベスト プラクティス
開発、モバイル、更新
2025年1月14日

モバイルアプリのライブアップデートのための5つのセキュリティベストプラクティス

全てのブログ記事を表示