AndroidManifest.xml は、すべての Android のアプリケーションの中心的なコンポーネントであり、開発者がアプリの構造と振る舞いの重要な側面を定義する宣言的なファイルとして働きます。この XML のファイルは、アプリのコンポーネント (アクティビティ、サービス、ブロードキャストレシーバー、コンテンツプロバイダー) や、アプリが正しく機能するのに必要な権限など、アプリの基本的なプロパティを指定するために不可欠です。AndroidManifest.xml はアプリと Android のオペレーティングシステムをつなぐ役割を果たし、アプリがどのように統合され、デバイスのリソースやほかのアプリケーションとどのようにやり取りするべきかをシステムが理解できるようにします。
画面の向き、アプリのアイコンとテーマ、アプリが使うハードウェア機能などの要素を定義することで、AndroidManifest.xml により、開発者はユーザー体験を調整し、アプリをどのデバイスに提供するかを制御できます。そのため、このファイルは単なる技術的な必需品ではなく、絶えず進化するモバイルの世界で、アプリが技術的な要件とユーザーの期待の両方を満たすようにするうえで極めて重要な役割を果たす戦略的なコンポーネントです。
AndroidManifest.xml は、すべての Android のアプリケーションの中心的なファイルであり、アプリの構造と機能の道しるべとして働きます。アプリのコンポーネント (アクティビティ、サービス、ブロードキャストレシーバー、コンテンツプロバイダー) や、アプリが正しく機能するのに必要な権限など、不可欠な情報を定義します。ビルドの構成とともに、マニフェストはさまざまな Android のバージョンとデバイスの構成とのアプリの互換性も決め、アプリがさまざまなデバイスでスムーズに実行できるようにするのに役立ちます。AndroidManifest.xml にメタデータと構成の詳細を含めることで、開発者はアプリの振る舞いとシステムとのやり取りを制御でき、Android の開発の過程の不可欠な部分となっています。
More about AndroidManifest.xml
AndroidManifest.xml は、すべての Android のアプリケーションの不可欠な構成ファイルであり、アプリの基本的なプロパティとコンポーネントの中心的な宣言として働きます。このファイルは、アプリケーションがどのように振る舞うべきか、どのコンポーネントを含むか、正しく機能するのにどの権限を必要とするかを Android のシステムが理解できるようにするうえで極めて重要です。
技術的には、AndroidManifest.xml はアプリのモジュールの src/main フォルダーにある XML のファイルです。アクティビティ、サービス、ブロードキャストレシーバー、コンテンツプロバイダーなど、アプリを構成するコンポーネントといった重要な側面を定義します。現代のプロジェクトでは、パッケージ ID (applicationId) とバージョンは Gradle のビルドファイルで設定され、ビルドツールがこれらとすべてのライブラリのマニフェストを最終的なマニフェストにマージします。マニフェストは、たとえばインターネットやデバイスのカメラへのアクセスなど、アプリが必要とする権限も指定します。機密性の高い権限については、アプリは実行時にもユーザーに尋ねなければならず、アプリがどのリソースを使うかをユーザーが知らされるようにします。
AndroidManifest.xml にはいくつかの異なるセクションを含められ、それぞれが異なる機能を支えます。
application のセクション：ここでは、テーマ、アイコン、名前など、アプリケーションの全体的なプロパティが定義されます。アプリを構成するコンポーネントと、それらをどのように開始できるかが宣言されるのもここです。このセクションは、アプリが正しく表示され、期待どおりに機能するようにするうえで極めて重要です。
権限のセクション：マニフェストのこの部分は、システムやユーザーデータの保護された部分にアクセスするのにアプリが必要とする権限を指定します。ネットワーク接続の使用、連絡先の読み取り、デバイスのストレージへのアクセスの権限を含められます。権限を正しく扱うことは、セキュリティとユーザー体験の両方にとって極めて重要です。
インテントフィルター：インテントフィルターは、アプリのコンポーネントがほかのアプリやシステムとどのようにやり取りできるかを定義するために使われます。Web ページを開く、ファイルを共有するなど、特定のアクションやデータにアプリが応答できるようにします。これにより、アプリをデバイス上のほかのサービスや機能とシームレスに統合できます。
AndroidManifest.xml の最大の強みの一つは、Android のアプリケーションを実行するのに必要な情報を一元化し整理できる能力です。この情報を一か所に集めることで、開発者はアプリの構成を簡単に管理し更新でき、エラーと不整合のリスクが減ります。
AndroidManifest.xml は、アプリのセキュリティでも重要な役割を果たします。明示的な権限を求め、たとえば android:exported 属性を使って、アプリのコンポーネントがほかのアプリに何を公開するかの明確な境界を定義することで、マニフェストはユーザーのデータとデバイスの完全性を守るのに役立ちます。これは、セキュリティとプライバシーが重視される時代に特に重要です。
実際に、AndroidManifest.xml はすべての Android の開発の過程の不可欠な部分です。アプリが正しく構成され、ユーザーとシステムの両方と安全かつ効率的にやり取りする準備ができていることを確保します。アプリがシンプルなものでも、多くのコンポーネントを持つ複雑な解決策でも、よく構造化された AndroidManifest.xml が成功の鍵です。
まとめると、AndroidManifest.xml は、構造、セキュリティ、機能を一つのファイルに組み合わせた、Android の開発の重要なコンポーネントです。アプリの振る舞いを定義し制御できる能力により、Android のプラットフォーム向けに堅牢で安全なアプリケーションを作りたい開発者にとって不可欠なツールとなっています。
Frequently asked questions about AndroidManifest.xml
Android のアプリの AndroidManifest.xml のファイルの目的は何ですか？
AndroidManifest.xml のファイルは、アプリの基本的なプロパティとコンポーネントを定義する中心的な構成ファイルとして働くため、すべての Android のアプリケーションの不可欠なコンポーネントです。特に、アプリの名前、アイコン、アプリが正しく機能するのに必要な権限を指定します。一方、バージョンは通常 Gradle のビルドで設定され、最終的なマニフェストに追加されます。アプリがインストールされると、Android のシステムはこのファイルを読み、アプリをシステムにどのように統合するべきか、どのようなリソースを必要とするかを理解します。
さらに、AndroidManifest.xml のファイルには、アクティビティ、サービス、ブロードキャストレシーバー、コンテンツプロバイダーなど、アプリのコンポーネントの宣言が含まれます。これらの宣言は、Android のシステムがアプリのさまざまな部分を正しく登録し扱うために必要です。たとえば、マニフェストで宣言されたアクティビティはアプリ自体から開始でき、エクスポート済みとして指定されていれば、ほかのアプリやシステムからも開始でき、アプリがほかのアプリやシステムの機能とやり取りできるようにします。
Android のアプリにはほかの構成ファイルもあります。これに対して、AndroidManifest.xml は、アプリの構造と権限を定義するだけでなく、さまざまな文脈と環境でアプリがどのように振る舞うかも制御するため、独特です。これにより、マニフェストファイルは、アプリがさまざまな Android のデバイスとバージョンで正しく安全に機能するようにするのに役立つため、アプリの開発と配布の重要な部分となっています。
AndroidManifest.xml では、権限はどのように定義されるのですか？
権限は、AndroidManifest.xml で uses-permission の要素を使って宣言され、この要素は manifest の要素の直下、application の要素の外に置かれます。各要素は権限を指定し、たとえばネットワークへのアクセスには android.permission.INTERNET、カメラには android.permission.CAMERA を指定します。このような宣言がないと、コードが何をしようとしても、アプリは保護された機能を使えません。これは iOS に似ており、iOS では、保護されたリソースを使うアプリの理由が Info.plist のファイルに記述されます。
Android は権限を保護レベルに分けます。インターネットへのアクセスなどの通常の権限は、アプリのインストール時に自動的に付与されます。カメラ、位置情報、連絡先、マイクなどの危険な権限は、Android 6.0 以降では実行時にもユーザーに要求しなければならず、アプリはユーザーが拒否した場合に対処しなければなりません。Android 13 以降は、通知を表示する権限もこの方法で要求する必要があります。一部の権限は、android:maxSdkVersion 属性で特定の Android のバージョンに限定できます。
不要な権限はユーザーの信頼を下げ、Google Play の審査で質問につながることがあるため、アプリが本当に必要とする権限だけを要求するのがよい慣行です。ライブラリもマニフェストのマージを通じて権限を追加できるため、リリース前に、たとえば Android Studio の Merged Manifest の表示でマージされたマニフェストを確認するべきです。可能であれば、システムの写真選択ツールなど、権限を必要としない代替手段を優先するべきです。
AndroidManifest.xml では、アプリの起動アクティビティはどのように指定されるのですか？
アプリの起動アクティビティは、AndroidManifest.xml で、アクティビティにアクション android.intent.action.MAIN とカテゴリ android.intent.category.LAUNCHER を持つインテントフィルターを与えることで指定されます。これにより、ユーザーがアプリのアイコンをタップしたときにそのアクティビティを開始するべきことがシステムに伝わります。
Android 12 以降は、インテントフィルターを持つアクティビティに android:exported 属性も指定しなければならず、起動アクティビティではこれを true に設定しなければなりません。複数のアクティビティがこの組み合わせを持つと、ランチャーに複数のアイコンが表示されることがあるため、通常は一つのアクティビティだけがこれを持ちます。たとえばロゴを表示する起動画面は、現在では SplashScreen API で扱われることがよくあります。
AndroidManifest.xml は、アプリのライフサイクルでどのような役割を果たすのですか？
AndroidManifest.xml はライフサイクル自体を制御するわけではありませんが、アプリがどのコンポーネントで構成され、それらをどのように開始できるかをシステムに伝えます。アクティビティ、サービス、ブロードキャストレシーバー、コンテンツプロバイダーはこのファイルで宣言しなければなりません。そうしないと、システムはそれらを作成できません。
マニフェストは、ライフサイクルの展開にも影響することがあります。たとえば configChanges 属性を使うと、アクティビティが再作成される代わりに画面の回転を自分で扱うことを指定でき、launchMode は新しいインスタンスが作成されるかどうかを決めます。さらに、カスタムの Application クラスを指定でき、これはアプリのプロセスが開始するときにほかのすべてのコンポーネントより前に作成されます。
Android のアプリの最小 SDK バージョンとターゲット SDK バージョンは、どのように指定されるのですか？
最小 SDK バージョンとターゲット SDK バージョンは、アプリがどの Android のバージョンに対応し、どのバージョン向けにビルドされテストされたかを指定します。以前は AndroidManifest.xml で uses-sdk の要素を使って指定されていましたが、現代のプロジェクトでは、モジュールの build.gradle のファイルで minSdk と targetSdk を使って設定されます。その後、Gradle が値を最終的なマニフェストに挿入します。
minSdk は、アプリをインストールできる最も低い Android のバージョンです。targetSdk は、アプリがどのバージョンの振る舞いとルールに適応しているかをシステムに伝えます。Google Play は、アプリを公開し更新するために、targetSdk を定期的に最近のバージョンに更新することを求めます。
AndroidManifest.xml では、カスタム権限はどのように扱われるのですか？
アプリは、AndroidManifest.xml で permission の要素を使って独自の権限を定義できます。ここでは、通常はアプリのパッケージ名に基づく一意の名前を、説明と保護レベルとともに指定します。signature のレベルは、同じ鍵で署名されたアプリだけがその権限を得られることを意味します。一方、normal と dangerous は、ほかのアプリに異なる条件でアクセスを与えます。
この権限は、たとえばアクティビティ、サービス、コンテンツプロバイダーに android:permission 属性を設定することで、アプリのコンポーネントを守るために使われます。そのコンポーネントを使いたいほかのアプリは、uses-permission でその権限を要求しなければなりません。signature のレベルは、同じ開発者の複数のアプリがデータを安全に共有する必要があるときによく使われます。
AndroidManifest.xml for dummies
AndroidManifest.xml は、Android のアプリの目次のようなものです。アプリが何をでき、どのように振る舞うべきかを電話に伝えるリストと考えるとわかりやすいでしょう。アプリがインストールされると、電話はまずこのファイルを見て、インターネットや電話のカメラへのアクセスなど、アプリがどの機能を必要とするかを確認します。アプリがどのように起動するべきか、アプリにどの部分があるかを示すのもここです。つまり、AndroidManifest.xml は、電話がアプリを正しく理解し扱うのに役立つ重要なファイルです。