Capacitor

Want to launch your Capacitor app on the App Store without delays? 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:

What is a Privacy Manifest?
A structured file outlining your app’s data collection practices, API usage, and tracking domains.
Why it matters:
- Complies with App Store rules to avoid rejections or removal.
- __CAPGO_KEEP_0__を透明性で信頼を築く。
__CAPGO_KEEP_1__を含める必要がある主な要素は
- __CAPGO_KEEP_2__がユーザーデータにアクセスするAPI (例：位置情報、写真)。
- __CAPGO_KEEP_3__で収集されたデータの種類のプライバシーラベル。
- __CAPGO_KEEP_4__で使用されるトラッキングドメイン (分析や広告)。
__CAPGO_KEEP_5__の作成方法
- JSONを使用してデータ収集の詳細を定義する。
- __CAPGO_KEEP_6__をプロジェクトの正しいディレクトリに置く。 PrivacyInfo.xcprivacy __CAPGO_KEEP_7__を使用してエラーを回避する。
- __CAPGO_KEEP_7__を使用してエラーを回避するツール (例：Xcode)。 Xcodeを使用してエラーを回避するツール。 Xcodeを使用してエラーを回避するツール。
ツールを使用してプロセスを簡素化します：
プラットフォームを使用して Capgo 自動化されたプライバシーマニフェストの検証、リアルタイムの更新、およびエラーの追跡を行います。マニフェストがトラッキングまたは分析のSDKを宣言した場合、 @capgo/capacitor-app-tracking-transparency iOS ATTのポップアップを処理し @capgo/capacitor-firebase-analytics Firebaseのデータ収集をApp Storeのレビュー用に記録します。

規制に従い、ユーザーのプライバシーを保護し、アプリのストアの遅延を回避するには、このガイドを参照してください。

プライバシーマニフェストの基本

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

プライバシーマニフェストは、データの取り扱いに関するアプリの構造化されたファイルです。マニフェストは、APIがユーザーデータにアクセスする要素、トラッキングドメイン、収集されたデータの種類、第三者SDKの統合などを詳細に記載しています。このドキュメントは、信頼性を確立するだけでなく、アプリストアのガイドラインに準拠することを保証します。ここでは、マニフェストに含めるべき主な要素を解説します。

Main Privacy Manifest Elements

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

Required Reason APIs
このセクションでは、プライバシーに影響を与えるAPIをリストし、その必要性を説明しています。

Below is a table summarizing common API requirements:

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

プライバシーラベル
これらのラベルは、以下の情報を明示的に指定することで透明性を提供します。
- 収集されるデータの種類
- データ収集の理由
- ユーザー ID と関連付けられているかどうかのデータ
- トラッキング用にデータがどのように使用されているか
トラッキングドメイン
このセクションでは、分析、広告、または第三者データ処理に使用されるすべてのドメインがリストされます。

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

Capgoによると、95%のユーザーは24時間以内に更新を実行します。23.5万件以上の更新を配信したことで [1]ユーザーのプライバシーに関するドキュメントを最新の状態に保つことは、ユーザーの信頼を維持するために不可欠です。

プライバシー宣言書を作成する Capacitor

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

セットアップの要件

プライバシー宣言書を作成する前に、以下のことを確認してください。

Xcode 15以上がインストールされている
Capacitor 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"
    ]
}

よくあるミスの回避

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

必要なすべてのフィールドを含める: すべてのフィールドが空でない場合、それらは存在する必要があります。
Use Valid API Types: Appleの公式ドキュメントで確認する API の識別子と照合してください。
Check JSON Formatting: JSONの構文エラーを検出するために、ファイルをJSONフォーマッターを通して走らせてください。
Provide Complete Reasons: API のアクセスには、対応する code の理由が含まれていることを確認してください。
Keep Information Up-to-Date: 新しい機能が追加された場合、manifestを更新してください。manifestファイルは512KB未満でなければなりません。Xcodeのビルドプロセス中にファイルを定期的に検証して、ミスを早期に発見することができます。manifestが準備できたら、__CAPGO_KEEP_0__ プロジェクトにファイルを配置するガイドラインに従って統合してください。

Adding Privacy Manifests to Capacitor

: __CAPGO_KEEP_0__ プロジェクトにプライバシーマニフェストを追加する方法についてはこちらをご覧ください。

プライバシーマニフェストをプロジェクトに含めるには、Capacitor プロジェクトの PrivacyInfo.xcprivacy 以下のディレクトリ構造にファイルを置く必要があります。

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

Capacitor プラグインの場合、以下の構造を使用してください。

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

ビルド設定の設定

ファイルが置かれたら、Xcode ビルド設定を更新して適切に統合するようにします。

Xcode でプロジェクトを開きます。
「TARGETS」セクションの下で、 アプリまたはプラグインのターゲットを選択します。「ビルド設定」タブを選択します。
protectedTokens protectedTokens protectedTokens
設定 プライバシーマニフェスト開発リージョン に en.
設定 プライバシーマニフェストを含める に 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

これらの変更を実施した後、実装チェックを実行して、すべてが正しく設定されていることを確認してください。

実装チェック

プライバシーマニフェストが正常に機能していることを確認するには、次の手順に従ってください。

ビルド検証
- ビルド中にプライバシー関連の警告がないことを確認します。
- 問題なくコンパイルされることを確認します。
- ビルド製品にプライバシーマニフェストが含まれていることを確認します。
実行時検証
- デバッグモードで、適切なプライバシーポップアップとAPIアクセス動作が正しく機能していることを確認します。
App Store Connect検証
- ビルドをアップロードし、App Store Connectのプライバシー報告を確認します。
- APIの宣言が完全で、トラッキングドメインの形式が正しいことを確認します。

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

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

テストと修正

Appleのガイドラインに適合するプライバシーマニフェストを作成することは非常に重要です。開発プロセスに信頼できるエラー追跡を組み込むことで、開発の取り組みと規制要件を関連付けることができます。

開発に役立つツール Capgo can help. It monitors API access and identifies manifest issues before they affect users. Once potential problems are flagged, you can shift your focus to thorough validation.

__CAPGO_KEEP_0__

Capgo __CAPGO_KEEP_0__

Capgo

約23.5百万のセキュアなアップデートと、 82％のグローバル成功率で、 __CAPGO_KEEP_0__は95％のアクティブユーザーが24時間以内にアップデートを受け取ることを保証します。 以下の機能を提供しています。, Capgo ensures that アップデートの配布を制御するためのチャネルシステム [1]エラーのトラッキング

protectedTokens targetLanguage
texts translations
With more than 問題を迅速に特定して対処する
1クリックで戻す 前のバージョンに即座に戻す

Capgoをワークフローに追加することが、Capgoを使用することで、スムーズかつ効率的なものになります。

Capgoを使用する

始めるには Capgo プラグインをインストールするこのコマンドを実行する

npx @capgo/cli init

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

“私たちはアジャイル開発を実践しています。 @Capgo は、ユーザーに継続的に提供するmission-criticalなものです！” – Rodrigo Mantica

“Capgoは、熱いcodeを送信する賢い方法です 🙂” – NASAのOSIRIS-REx

Capgoは、実時間でアップデートの成功率とユーザーの関与度を監視するための組み込みの分析機能を備えています。この機能により、プライバシー更新がAppleのガイドラインに準拠しながら、ユーザーの全体のベースに到達することが保証されます。

結論

キーアウトライン

プライバシーマニフェストの管理、法的適合性、強固なセキュリティ対策の維持は非常に重要です。ここでは、最も重要な点をご紹介します。

エンドツーエンド暗号化: は始まりから終わりまで、更新を安全に保証します。
リアルタイムモニタリングアップデートの配布を効果的に追跡する。
Instant rollback capability修正機能
Automated validation自動検証

Building a reliable update system helps you keep up with Apple and Google’s evolving privacy requirements. This approach has been shown to improve app store approval rates and strengthen user confidence [1].

Capgoの導入

You can begin implementing these principles by following these steps:

環境設定: Run npx @capgo/cli init Capgoを実行
Enable privacy features: 終端間暗号化を使用して安全な更新を実行.
監視ツールを展開する: アナリティクスを使用して更新を追跡する。
ロールバックの計画: 必要に応じて以前のバージョンに迅速に戻ることができるようにする。

“Capgo is a must-have tool for developers who want to boost productivity. Avoiding review delays for bug fixes is a game changer.” - Bessie Cooper

__CAPGO_KEEP_0__は、開発者が生産性を向上させるために必要なツールです。バグ修正のためのレビュー遅延を回避することは、ゲームチェンジャーです。

Keep going from Privacy Manifest for Capacitor Apps: Guide

__CAPGO_KEEP_0__アプリのためのプライバシー・マニフェストから続けてください: ガイド Capacitorアプリのためのプライバシー・マニフェストを使用している場合 セキュリティと規制遵守を計画するには、プライバシー・マニフェストを「エンクリプションエンクリプション Compliance for the implementation detail in Compliance, Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security for the product workflow in Capgo Security, and Capgo Trust Center for the product workflow in Capgo Trust Center.

Capacitor アプリ用プライバシーマニフェストのガイド