このページは Cloud Translation API によって翻訳されました。

インテントとインテントフィルタ

Intent は、別のアプリコンポーネントからのアクションをリクエストするために使用できるメッセージングオブジェクトです。インテントはいくつかの方法でコンポーネント間の通信を容易にしますが、基本的なユースケースは次の 3 つです。

アクティビティを開始する
Activity はアプリ内の 1 つの画面を表します。Activity の新しいインスタンスを開始するには、Intent を startActivity() に渡します。Intent は、開始するアクティビティを記述し、必要なデータすべてを含んでいます。

アクティビティの完了時に結果を受け取る場合は、startActivityForResult() を呼び出します。アクティビティは、結果を別の Intent オブジェクトとして、アクティビティの onActivityResult() コールバック内で受け取ります。詳しくは、アクティビティガイドをご覧ください。
サービスの開始
Service は、ユーザーインターフェースを持たず、バックグラウンドで操作を実行するコンポーネントです。Android 5.0（API レベル 21）以降では、JobScheduler を使用してサービスを開始できます。JobScheduler の詳細については、API-reference documentation をご覧ください。

Android 5.0（API レベル 21）より前のバージョンでは、Service クラスのメソッドを使用してサービスを開始できます。サービスを開始して 1 回限りの操作を実行する（ファイルのダウンロードなど）には、Intent を startService() に渡します。Intent は、開始するサービスを記述し、必要なデータすべてを含んでいます。

クライアント / サーバーインターフェースでサービスが設計されている場合、Intent を bindService() に渡して、別のコンポーネントからサービスにバインドできます。詳細については、サービスガイドをご覧ください。
ブロードキャストの配信
ブロードキャストは、アプリが受け取ることのできるメッセージです。システムは、システムの起動時やデバイスの充電開始時など、システムイベントに対してさまざまなブロードキャストを配信します。他のアプリにブロードキャストを配信するには、Intent を sendBroadcast() または sendOrderedBroadcast() に渡します。

このページの後半では、インテントの仕組みと使用方法について説明します。関連情報については、他のアプリとの連携とコンテンツの共有をご覧ください。

インテントのタイプ

インテントには 2 つのタイプがあります。

明示的インテントでは、完全な ComponentName を指定することで、インテントを満たすアプリのコンポーネントを指定します。通常は開始するアクティビティやサービスのクラス名がわかっているため、明示的インテントを使用してアプリ内のコンポーネントを開始します。たとえば、ユーザー操作に応答してアプリ内で新しいアクティビティを開始したり、バックグラウンドでファイルをダウンロードするサービスを開始したりできます。
暗黙的インテントでは、特定のコンポーネントを指定せず、代わりに実行する全般的な動作を宣言することで、他のアプリからコンポーネントを処理できるようにします。たとえば、マップ上にユーザーの位置を表示する場合、暗黙的インテントを使って、特定の場所をマップ上に表示できる別のアプリにその操作を要求します。

図 1 は、アクティビティの開始時にインテントがどのように使用されるかを示しています。Intent オブジェクトで特定のアクティビティコンポーネントの名前を明示的に指定すると、システムはすぐにそのコンポーネントを起動します。

図 1. 暗黙的インテントが他のアクティビティを開始するようシステム内に配信される仕組み: [1] Activity A がアクションの記述を使って Intent を作成し、それを startActivity() に渡します。[2] Android システムは、すべてのアプリでインテントに一致するインテントフィルタを検索します。一致が見つかった場合、[3] システムは onCreate() メソッドを呼び出して Intent を渡すことで、一致するアクティビティ（アクティビティ B）を開始します。

暗黙的インテントを使用すると、Android システムはインテントの内容を、デバイス上の他のアプリのマニフェストファイルで宣言されたインテントフィルタと比較して、開始すべきコンポーネントを見つけます。インテントがインテントフィルタに一致した場合、システムは該当するコンポーネントを起動して Intent オブジェクトを配信します。複数のインテントフィルタが競合する場合、ユーザーが仕様するアプリを選択できるようシステムによってダイアログが表示されます。

インテントフィルタは、コンポーネントが受け取りたいインテントのタイプを指定する式で、アプリのマニフェストファイルに含まれています。たとえば、アクティビティのインテントフィルタを宣言すると、特定のインテントタイプを持つアクティビティを他のアプリから直接開始できるようになります。同様に、アクティビティでインテントフィルタを宣言しない場合は、明示的インテントでのみアクティビティを開始できます。

注意: アプリの安全性を確保するため、Service の起動には必ず明示的インテントを使用します。このサービスにはインテントフィルタを宣言しないでください。暗黙的インテントを使用してサービスを開始すると、どのサービスがインテントに応答するのかを把握できず、ユーザーにはどのサービスが開始するのかがわからないため、セキュリティ上の危険が伴います。Android 5.0（API レベル 21）以降では、暗黙的インテントを使用して bindService() を呼び出すと、システムから例外がスローされます。

インテントを作成する

Intent オブジェクトには、Android システムが開始するコンポーネントの決定に使用する情報（インテントを受け取る正確なコンポーネント名やコンポーネントカテゴリなど）と、受信コンポーネントがアクションを適切に実行するために使用する情報（実行するアクション、処理するデータなど）が格納されています。

Intent に含まれる主な情報は次のとおりです。

コンポーネント名

開始するコンポーネントの名前。

これは省略可能ですが、インテントを明示的にするためには不可欠な情報です。つまり、コンポーネント名で定義されたアプリコンポーネントにのみ、インテントが配信されます。コンポーネント名を指定しない場合、インテントは暗黙的となり、他のインテント情報（後述のアクション、データ、カテゴリなど）に基づいて、システムがインテントを受け取るコンポーネントを決定します。アプリ内の特定のコンポーネントを開始する必要がある場合は、コンポーネント名を指定する必要があります。

注: Service を開始するときは、常にコンポーネント名を指定してください。そうしないと、どのサービスがインテントに応答するかがわかりません。また、ユーザーはどのサービスが開始するのかを知ることができません。

Intent のこのフィールドは ComponentName オブジェクトで、アプリのパッケージ名など、ターゲットコンポーネントの完全修飾クラス名を使用して指定できます（例: com.example.ExampleActivity）。コンポーネント名は、setComponent()、setClass()、setClassName()、または Intent コンストラクタで設定できます。

操作

実行する全体的なアクションを指定する文字列です（閲覧や選択など）。

ブロードキャストインテントの場合、これは実行され、報告されるアクションです。ほとんどのアクションは、残りのインテントがどのように構成されているか、特にデータやエクストラに含まれている情報によって決まります。

インテントによって自身のアプリで使用する（または他のアプリで使用して自身のアプリのコンポーネントを呼び出す）独自のアクションを指定できますが、通常は Intent クラスや他のフレームワーククラスで定義されたアクション定数を指定します。アクティビティを開始する際の一般的なアクションをいくつか次に示します。

ACTION_VIEW: ギャラリーアプリで表示する写真や、マップアプリで表示する住所など、アクティビティ内にユーザーに表示する情報がある場合は、startActivity() を使ってインテントにこのアクションを使用します。
ACTION_SEND: これは「共有」インテントとしても知られており、メールアプリやソーシャルシェアリングアプリなどの他のアプリ経由でユーザーが共有できるデータがある場合に、startActivity() でインテントに使用します。

汎用アクションを定義するその他の定数については、Intent クラスのリファレンスをご覧ください。システムの設定アプリで特定の画面を開くアクションの Settings など、他のアクションは Android フレームワークの別の場所で定義されます。

インテントのアクションは、setAction() または Intent コンストラクタを使って指定できます。

独自のアクションを定義する場合は、次の例に示すように、接頭辞としてアプリのパッケージ名を必ず含めます。

Kotlin

const val ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL"

Java

static final String ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL";

データ

アクションの実行対象であるデータや、データの MIME タイプを参照する URI（Uri オブジェクト）です。提供されるデータタイプは、インテントのアクションによって決まります。たとえば、アクションが ACTION_EDIT の場合、データには編集するドキュメントの URI が含まれます。

インテントを作成する際は、URI に加えてデータのタイプ（MIME タイプ）を指定することが重要です。たとえば、画像を表示できるアクティビティは、URI の形式が類似していても、音声ファイルを再生できない可能性があります。データの MIME タイプを指定すると、Android システムがインテントを受け取る最適なコンポーネントを見つけやすくなります。ただし、特にデータが content: URI の場合、MIME タイプは URI から推測できる場合があります。content: URI は、データがデバイス上にあり、ContentProvider によって制御されていることを示します。これにより、データの MIME タイプがシステムに表示されます。

データ URI のみを設定するには、setData() を呼び出します。MIME タイプのみを設定するには、setType() を呼び出します。必要に応じて、setDataAndType() を使用して両方を明示的に設定することもできます。

注意: URI と MIME タイプの両方を設定する場合は、お互いの値を無効にしてしまわないよう、setData() と setType() を呼び出さないでください。URI と MIME タイプの両方を設定する場合は、必ず setDataAndType() を使用してください。

カテゴリ

インテントを処理するコンポーネントの種類に関する追加情報を含む文字列。カテゴリの記述は、インテントにいくつでも含めることができますが、ほとんどのインテントではカテゴリは必須ではありません。一般的なカテゴリは次のとおりです。

CATEGORY_BROWSABLE: ターゲットのアクティビティは、ウェブブラウザから開始して画像やメールメッセージなど、リンクで参照されたデータを表示できます。
CATEGORY_LAUNCHER: このアクティビティはタスクの初期のアクティビティで、システムのアプリケーションランチャーの一覧に表示されます。

カテゴリの全一覧は、Intent クラスの説明をご覧ください。

カテゴリは addCategory() で指定できます。

上記のプロパティ（コンポーネント名、アクション、データ、カテゴリ）は、インテントの特性の定義を表しています。これらのプロパティを読み取ることで、Android システムはどのアプリコンポーネントを開始すべきかを解決できます。ただし、インテントにはアプリコンポーネントの解決に影響を与えない追加情報を含めることもできます。インテントに含めることのできる情報は次のとおりです。

おまけ

要求されたアクションの実行に必要な追加情報のキーと値のペアです。一部のアクションが特定の種類のデータ URI を使用するのと同様に、一部のアクションは特定のエクストラを使用します。

各種の putExtra() メソッド（それぞれがキー名と値の 2 つのパラメータを受け入れる）を使用して、データを追加できます。すべてのエクストラデータを使って Bundle オブジェクトを作成し、putExtras() を使って Bundle を Intent に挿入することもできます。

たとえば、ACTION_SEND を使ってメールを送信するインテントを作成するとき、EXTRA_EMAIL キーを使って「宛先」の受信者を指定したり、EXTRA_SUBJECT キーを使って「件名」を指定したりできます。

Intent クラスは、標準化されたデータ型の多くの EXTRA_* 定数を指定します。独自のエクストラキーを宣言する必要がある場合は（アプリが受け取るインテント用に）、次の例に示すように、アプリのパッケージ名を接頭辞として必ず含めます。

Kotlin

const val EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS"

Java

static final String EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS";

注意: 別のアプリが受信することを想定したインテントを送信する場合は、Parcelable データまたは Serializable データを使用しないでください。アプリが Bundle オブジェクトのデータにアクセスしようとしたが、パーセル化されたクラスまたはシリアル化されたクラスにアクセスできない場合、システムは RuntimeException を発生させます。

フラグ

フラグは、インテントのメタデータとして機能する Intent クラスで定義されます。フラグは、Android システムにアクティビティの起動方法（アクティビティがどのタスクに属するかなど）や、起動後の取り扱い方法（最近のアクティビティの一覧に含めるかどうかなど）を指示します。

詳細については、setFlags() メソッドをご覧ください。

明示的インテントの例

明示的インテントは、アプリ内の特定のアクティビティやサービスなど、特定のアプリコンポーネントを起動する際に使用するものです。明示的インテントを作成するには、Intent オブジェクトのコンポーネント名を定義します。他のインテントプロパティはすべて省略可能です。

たとえば、アプリでウェブからファイルをダウンロードするサービスを DownloadService という名前で作成した場合、次のコードでそれを開始できます。

Kotlin

// Executed in an Activity, so 'this' is the Context
// The fileUrl is a string URL, such as "http://www.example.com/image.png"
val downloadIntent = Intent(this, DownloadService::class.java).apply {
    data = Uri.parse(fileUrl)
}
startService(downloadIntent)

Java

// Executed in an Activity, so 'this' is the Context
// The fileUrl is a string URL, such as "http://www.example.com/image.png"
Intent downloadIntent = new Intent(this, DownloadService.class);
downloadIntent.setData(Uri.parse(fileUrl));
startService(downloadIntent);

Intent(Context, Class) コンストラクタは、アプリ Context とコンポーネントに Class オブジェクトを提供します。このようにして、このインテントはアプリの DownloadService クラスを明示的に開始します。

サービスのビルドと開始の詳細については、サービスのガイドをご覧ください。

暗黙的インテントの例

暗黙的インテントは、端末上のどんなアプリでも実行できるアクションを指定します。暗黙的インテントは、自身のアプリではそのアクションを実行できないが、他のアプリでは実行可能であり、どのアプリを使うかをユーザーに選ばせたい場合に便利です。

たとえば、他のユーザーと共有できるようにするコンテンツがある場合は、ACTION_SEND アクションを使ってインテントを作成し、共有するコンテンツを指定するエクストラを追加します。そのインテントで startActivity() を呼び出すと、ユーザーはどのアプリでコンテンツを共有するかを選択できます。

Kotlin

// Create the text message with a string.
val sendIntent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, textMessage)
    type = "text/plain"
}

// Try to invoke the intent.
try {
    startActivity(sendIntent)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

// Create the text message with a string.
Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage);
sendIntent.setType("text/plain");

// Try to invoke the intent.
try {
    startActivity(sendIntent);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

startActivity() が呼び出されたとき、システムによってすべてのインストール済みアプリの中にこのタイプのインテント（ACTION_SEND アクションとテキスト/プレーンデータが含まれるインテント）を処理できるものがあるかどうかが確認されます。インテントを処理できるアプリが 1 つしかない場合は、そのアプリがすぐに開いてインテントを受け取ります。他のアプリが処理できない場合、アプリは発生した ActivityNotFoundException をキャッチできます。インテントを処理できるアクティビティが複数ある場合、図 2 のようなダイアログが表示され、ユーザーが使用するアプリを選択できます。

他のアプリを起動する方法については、別のアプリにユーザーを送信するためのガイドでも説明しています。

図 2. チューザダイアログ

アプリチューザを表示する

暗黙的インテントに応答するアプリが 2 つ以上ある場合、ユーザーは使用するアプリを選択でき、そのアプリをアクションに対するデフォルトの選択肢にすることができます。デフォルトを選択できる機能は、ウェブページを開くときなど、ユーザーが毎回同じアプリを使用したいアクションを実行する場合に便利です（多くの場合、ユーザーは 1 つのウェブブラウザのみを希望します）。

ただし、インテントに応答するアプリが複数あって、ユーザーが毎回別のアプリを使用する可能性がある場合は、チューザのダイアログを明示的に表示する必要があります。チューザダイアログでは、アクションに使用するアプリを選択するようユーザーに求めます（ユーザーはアクションのデフォルトアプリを選択することはできません）。たとえば、アプリが ACTION_SEND アクションを使用して「共有」を実行する場合、ユーザーは現在の状況に応じて別のアプリを使用して共有することを希望する可能性があります。この場合、図 2 に示すように、常に選択ツールダイアログを使用する必要があります。

選択ツールを表示するには、次の例に示すように、createChooser() を使用して Intent を作成し、startActivity() に渡します。この例では、createChooser() メソッドに渡されたインテントに応答するアプリのリストを示すダイアログが表示され、指定されたテキストがダイアログのタイトルになります。

Kotlin

val sendIntent = Intent(Intent.ACTION_SEND)
...

// Always use string resources for UI text.
// This says something like "Share this photo with"
val title: String = resources.getString(R.string.chooser_title)
// Create intent to show the chooser dialog
val chooser: Intent = Intent.createChooser(sendIntent, title)

// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(packageManager) != null) {
    startActivity(chooser)
}

Java

Intent sendIntent = new Intent(Intent.ACTION_SEND);
...

// Always use string resources for UI text.
// This says something like "Share this photo with"
String title = getResources().getString(R.string.chooser_title);
// Create intent to show the chooser dialog
Intent chooser = Intent.createChooser(sendIntent, title);

// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(chooser);
}

インテントの安全でない起動を検出する

アプリは、アプリ内のコンポーネント間を移動するため、または別のアプリに代わってアクションを実行するため、インテントを起動することがあります。Android 12（API レベル 31）以降では、プラットフォームのセキュリティを強化するため、アプリがインテントの安全でない起動を実行したときに警告するデバッグ機能が導入されました。たとえば、ネストされたインテント（別のインテントにエクストラとして渡されるインテント）の安全でない起動をアプリが実行する場合があります。

アプリが次のアクションの両方を実行すると、システムによってインテントの安全でない起動が検出され、StrictMode 違反が発生します。

配信されたインテントのエクストラから、ネストされたインテントを取り出した。
そのネストされたインテントを使用して（たとえば startActivity()、startService()、または bindService() にインテントを渡して）、アプリコンポーネントを直ちに開始した。

この状況を識別してアプリに変更を加える方法について詳しくは、Medium の Android のネストインテントに関するブログ記事をご覧ください。

安全でないインテントの起動を確認する

アプリでの安全でないインテントの起動を確認するには、VmPolicy を構成する際に detectUnsafeIntentLaunch() を呼び出します。次のコードスニペットをご覧ください。アプリで StrictMode 違反が検出された場合は、機密に該当する可能性がある情報を保護するために、アプリの実行を停止することをおすすめします。

Kotlin

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        // Other StrictMode checks that you've previously added.
        // ...
        .detectUnsafeIntentLaunch()
        .penaltyLog()
        // Consider also adding penaltyDeath()
        .build())
}

Java

protected void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
        // Other StrictMode checks that you've previously added.
        // ...
        .detectUnsafeIntentLaunch()
        .penaltyLog()
        // Consider also adding penaltyDeath()
        .build());
}

より厳格なインテントの使い方

安全でないインテントの起動や StrictMode 違反の発生を最小限に抑えるには、次のベストプラクティスに従ってください。

インテント内の必須のエクストラのみをコピーして、必要なサニタイズと検証を行います。アプリは、あるインテントから、新しいコンポーネントの起動に使用される別のインテントに、エクストラをコピーすることがあります。これは、アプリが putExtras(Intent) または putExtras(Bundle) を呼び出したときに発生します。アプリがこれらのオペレーションのいずれかを実行する場合、受信コンポーネントで想定されるエクストラのみをコピーします。コピーを受信するインテントがエクスポートされていないコンポーネントを起動する場合は、エクストラをサニタイズして検証してから、コンポーネントを起動するインテントにコピーします。

アプリのコンポーネントを不必要にエクスポートしないでください。たとえば、内部のネストインテントを使用してアプリコンポーネントを起動する場合は、そのコンポーネントの android:exported 属性を false に設定します。

ネストされたインテントではなく PendingIntent を使用してください。この方法では、別のアプリがそのアプリの Intent の PendingIntent を展開すると、そのアプリはアプリの ID を使用して PendingIntent を起動できます。この構成により、他のアプリは、アプリのエクスポートされていないコンポーネントを含む任意のコンポーネントを安全に起動できます。

図 2 の図は、システムが（クライアント）アプリから別の（サービス）アプリに制御を渡し、アプリに戻す方法を示しています。

アプリは、別のアプリのアクティビティを呼び出すインテントを作成します。そのインテント内に、PendingIntent オブジェクトをエクストラとして追加します。このペンディングインテントは、アプリ内のコンポーネントを呼び出します。このコンポーネントはエクスポートされません。
アプリのインテントを受け取ると、他のアプリはネストされた PendingIntent オブジェクトを抽出します。
もう一方のアプリは、PendingIntent オブジェクトの send() メソッドを呼び出します。
アプリに制御を戻した後、システムはアプリのコンテキストを使用して保留中のインテントを呼び出します。

図 2. ネストされたペンディングインテントを使用する場合のアプリ間通信の図。

暗黙的インテントを受け取る

アプリが受け取る暗黙的インテントをアドバタイズするには、マニフェストファイルで <intent-filter> 要素を使用して、アプリコンポーネントごとに 1 つ以上のインテントフィルタを宣言します。各インテントフィルタには、インテントのアクション、データ、カテゴリに基づいて受け入れるインテントのタイプを指定します。インテントがいずれかのインテントフィルタを通過した場合のみ、システムが暗黙的インテントをアプリのコンポーネントに配信します。

注: 明示的インテントは、コンポーネントが宣言しているインテントフィルタに関係なく、常にターゲットに配信されます。

アプリのコンポーネントは固有のジョブそれぞれに対して個別のフィルタを宣言する必要があります。たとえば、画像ギャラリーアプリの 1 つのアクティビティには、画像を表示するフィルタと、画像を編集するフィルタの 2 つがあります。アクティビティが開始すると、Intent を調べて Intent にある情報に基づいてどのように動作するかを決定します（編集コントロールを表示するかどうかなど）。

各インテントフィルタは、アプリのマニフェストファイルの <intent-filter> 要素で定義され、これは対応するアプリのコンポーネント（<activity> 要素など）にネストされます。

<intent-filter> 要素を含む各アプリコンポーネントで、android:exported の値を明示的に設定します。この属性は、アプリコンポーネントが他のアプリからアクセスできるかどうかを示します。インテントフィルタに LAUNCHER カテゴリが含まれているアクティビティなど、この属性を true に設定すると便利な場合があります。それ以外の場合は、この属性を false に設定することをおすすめします。

警告: アプリ内のアクティビティ、サービス、ブロードキャストレシーバがインテントフィルタを使用し、android:exported の値を明示的に設定していない場合、Android 12 以降を実行しているデバイスにアプリをインストールできません。

<intent-filter> 内で、次の 3 つの要素のなかで 1 つ以上を使用して、受け入れるインテントのタイプを指定できます。

<action>: name 属性で、受け入れるインテントのアクションを宣言します。この値は、クラス定数ではなく、アクションのリテラル文字列値にする必要があります。
<data>: データ URI（scheme、host、port、path）のさまざまな側面と MIME タイプを指定する 1 つ以上の属性を使用して、受け入れるデータのタイプを宣言します。
<category>: 受け入れるインテントカテゴリを name 属性で宣言します。値は、クラス定数ではなく、アクションのリテラル文字列値である必要があります。
注: 暗黙的インテントを受け取るには、インテントフィルタに CATEGORY_DEFAULT カテゴリを含める必要があります。startActivity() メソッドと startActivityForResult() メソッドは、CATEGORY_DEFAULT カテゴリを宣言しているものとして、すべてのインテントを処理します。インテントフィルタでカテゴリを宣言していない場合、暗黙的インテントはアクティビティに紐付けされません。

次に、データタイプがテキストの場合に、ACTION_SEND インテントを受け取るインテントフィルタを使用したアクティビティ宣言の例を示します。

<activity android:name="ShareActivity" android:exported="false">
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

<action>、<data>、または <category> の複数のインスタンスを含むフィルタを作成できます。その場合、コンポーネントがそれらのフィルタ要素のすべての組み合わせを処理できることを確認しておきます。

複数のタイプのインテントに対応しながら、アクション、データ、カテゴリタイプの特定の組み合わせのみを処理する場合は、複数のインテントフィルタを作成する必要があります。

暗黙的インテントは、3 つの要素それぞれへのインテントを比較して、フィルタでテストされます。コンポーネントに配信されるには、インテントが 3 つのテストすべてを通過する必要があります。一致しないものが 1 つでも場合、Android システムはインテントをコンポーネントに配信しません。ただし、コンポーネントは複数のインテントフィルタを保持していることもあるため、1 つのインテントフィルタを通過できなかったインテントでも、別のフィルタを通過できる場合があります。システムがインテントを解決する方法について詳しくは、インテントの解決のセクションをご覧ください。

注意: インテントフィルタを使用して他のアプリでコンポーネントを開始できないようにする方法は安全ではありません。インテントフィルタは、コンポーネントが特定の種類の暗黙的インテントのみに対応するように制限しますが、デベロッパーがコンポーネント名を決定した場合、別のアプリが明示的インテントを使用してアプリコンポーネントを起動する可能性があります。独自のアプリのみがコンポーネントを起動できるようにすることが重要である場合は、マニフェストでインテントフィルタを宣言しないでください。代わりに、そのコンポーネントの exported 属性を "false" に設定します。

同様に、別のアプリの Service を誤って実行しないように、常に明示的インテントを使用して独自のサービスを開始します。

注: すべてのアクティビティにおいて、インテントフィルタはマニフェストファイルで宣言する必要があります。ただし、ブロードキャストレシーバのフィルタは、registerReceiver() を呼び出すことで動的に登録できます。その後、unregisterReceiver() を使用してレシーバの登録を解除できます。これにより、アプリが実行中の特定の期間だけ、アプリが特定のブロードキャストをリッスンできるようになります。

フィルタの例

ソーシャル共有アプリのマニフェストファイルを使用したインテントフィルタの動作の例を以下に示します。

<activity android:name="MainActivity" android:exported="true">
    <!-- This activity is the main entry, should appear in app launcher -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<activity android:name="ShareActivity" android:exported="false">
    <!-- This activity handles "SEND" actions with text data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
    <!-- This activity also handles "SEND" and "SEND_MULTIPLE" with media data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <action android:name="android.intent.action.SEND_MULTIPLE"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="application/vnd.google.panorama360+jpg"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="video/*"/>
    </intent-filter>
</activity>

1 つ目のアクティビティ MainActivity は、アプリのメインのエントリポイントです。ユーザーがランチャーアイコンを使用してアプリを最初に起動したときに開くアクティビティです。

ACTION_MAIN アクションが、これがメインのエントリポイントで、インテントデータはないことを示しています。
CATEGORY_LAUNCHER カテゴリは、このアクティビティのアイコンをシステムのアプリランチャーに配置する必要があることを示しています。<activity> 要素で icon を使ってアイコンを指定しない場合、システムは <application> 要素のアイコンを使用します。

アクティビティをアプリランチャーに表示するには、この 2 つをペアリングする必要があります。

2 つ目のアクティビティである ShareActivity は、テキストやメディアコンテンツの共有を促すためのものです。ユーザーは MainActivity に移動することでこのアクティビティに入ることもありますが、2 つのインテントフィルタのいずれかに一致する暗黙的インテントを発行する別のアプリから直接 ShareActivity に入ることもできます。

注: MIME タイプ（application/vnd.google.panorama360+jpg）はパノラマ写真を指定する特殊なデータタイプで、Google パノラマ API で処理できます。

インテントと他のアプリのインテントフィルタを一致させる

別のアプリが Android 13（API レベル 33）以降をターゲットとしている場合、そのアプリは、アプリのインテントがそのアプリの <intent-filter> 要素のアクションとカテゴリと一致する場合にのみ、アプリのインテントを処理できます。一致が見つからない場合、ActivityNotFoundException がスローされます。送信側のアプリはこの例外を処理する必要があります。

同様に、Android 13 以上をターゲットとするようにアプリを更新した場合、外部アプリから発信されるすべてのインテントは、アプリで宣言された <intent-filter> 要素のアクションとカテゴリと一致する場合にのみ、アプリのエクスポート済みコンポーネントに配信されます。この動作は、送信元アプリのターゲット SDK バージョンに関係なく発生します。

次のケースでは、インテントマッチングは適用されません。

インテントフィルタを宣言していないコンポーネントに配信されるインテント。
同じアプリからのインテント。
システムからのインテント、つまり「システム UID」（uid=1000）から送信されるインテント。システムアプリとしては、system_server と、android:sharedUserId を android.uid.system に設定するアプリがあります。
ルートからのインテント。

詳しくは、インテントマッチングについての記事をご覧ください。

ペンディングインテントを使用する

PendingIntent オブジェクトは、Intent オブジェクトをラップするオブジェクトです。PendingIntent の主な目的は、別のアプリケーションに、アプリ自身のプロセスから実行したように、含まれる Intent を使用できる権限を付与することです。

ペンディングインテントの主なユースケースは次のとおりです。

ユーザーが通知を使ってアクションを実行するときに実施するインテントを宣言する（Android システムの NotificationManager が Intent を実行します）。
ユーザーがアプリウィジェットでアクションを実行したときに実行するインテントを宣言する（ホーム画面アプリが Intent を実行する）。
今後の指定された時間に実施するインテントを宣言する（Android システムの AlarmManager が Intent を実行します）。

各 Intent オブジェクトは、特定のタイプのアプリコンポーネント（Activity、Service、BroadcastReceiver のいずれか）で処理されることを前提としているため、PendingIntent も同様の前提で作成する必要があります。ペンディングインテントを使用している場合、アプリは startActivity() などの呼び出しではインテントを実行しません。代わりに、PendingIntent の作成時にそれぞれのクリエーターメソッドを呼び出して目的のコンポーネントタイプを宣言する必要があります。

Activity を開始する Intent の PendingIntent.getActivity()。
Service を開始する Intent の場合は PendingIntent.getService()。
BroadcastReceiver を開始する Intent の PendingIntent.getBroadcast()。

アプリが他のアプリからペンディングインテントを受け取る場合を除いて、PendingIntent の作成時に必要となる PendingIntent メソッドはほぼ上記の 3 つのみです。

各メソッドは、現在のアプリ Context、ラップする Intent、インテントの使用方法を指定する 1 つ以上のフラグ（インテントを 2 回以上できるかどうかなど）を受け取ります。

ペンディングインテントの使用に関する詳細については、通知やアプリウィジェットの API ガイドなど、それぞれのユースケースのドキュメントをご覧ください。

可変性を指定する

Android 12 以降をターゲットとするアプリでは、アプリが作成する各 PendingIntent オブジェクトの可変性を指定する必要があります。特定の PendingIntent オブジェクトが可変または不変であることを宣言するには、それぞれ PendingIntent.FLAG_MUTABLE フラグまたは PendingIntent.FLAG_IMMUTABLE フラグを使用します。

アプリがどちらの可変性フラグも設定せずに PendingIntent オブジェクトを作成しようとすると、IllegalArgumentException がスローされ、logcat に次のメッセージが表示されます。

PACKAGE_NAME: Targeting S+ (version 31 and above) requires that one of \
FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.

Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if \
some functionality depends on the PendingIntent being mutable, e.g. if \
it needs to be used with inline replies or bubbles.

可能な限り不変のペンディングインテントを作成する

ほとんどの場合において、アプリでは不変の PendingIntent オブジェクトを作成するようにしてください（次のコードスニペットを参照）。PendingIntent オブジェクトが不変の場合、他のアプリはそのインテントを変更して、インテント呼び出しの結果を調整することはできません。

Kotlin

val pendingIntent = PendingIntent.getActivity(applicationContext,
        REQUEST_CODE, intent,
        /* flags */ PendingIntent.FLAG_IMMUTABLE)

Java

PendingIntent pendingIntent = PendingIntent.getActivity(getApplicationContext(),
        REQUEST_CODE, intent,
        /* flags */ PendingIntent.FLAG_IMMUTABLE);

ただし、次のユースケースでは可変の PendingIntent オブジェクトが必要です。

通知のダイレクト返信アクションのサポート。ダイレクトリプライでは、そのリプライに関連付けられている PendingIntent オブジェクトのクリップデータを変更する必要があります。通常は、fillIn() メソッドに FILL_IN_CLIP_DATA をフラグとして渡すことにより、この変更をリクエストします。
CarAppExtender のインスタンスを使用して通知を Android Auto フレームワークに関連付ける。
PendingIntent のインスタンスを使用して会話をバブルに配置する。可変の PendingIntent オブジェクトを使用すると、システムは FLAG_ACTIVITY_MULTIPLE_TASK や FLAG_ACTIVITY_NEW_DOCUMENT などの正しいフラグを適用できます。
requestLocationUpdates() などの API を呼び出して、デバイスの位置情報をリクエストする。変更可能な PendingIntent オブジェクトを使用すると、位置情報のライフサイクルイベントを表すインテントエクストラをシステムが追加できます。これらのイベントには、場所の変更やプロバイダの利用可能化が含まれます。
AlarmManager を使用してアラームのスケジュールを設定する。変更可能な PendingIntent オブジェクトを使用すると、システムがEXTRA_ALARM_COUNT インテントエクストラを追加できます。この追加情報は、繰り返しアラートがトリガーされた回数を表します。このエクストラを含めると、インテントは、デバイスがスリープ状態だったときなど、繰り返しアラームが複数回トリガーされたかどうかについて、アプリに正確に通知できます。

アプリで可変の PendingIntent オブジェクトを作成する場合は、明示的インテントを使用して ComponentName の値をフィルインすることを強くおすすめします。そうすれば、別のアプリが PendingIntent を呼び出してアプリに制御を戻すたびに、常にアプリ内の同じコンポーネントが開始されます。

ペンディングインテント内で明示的インテントを使用する

他のアプリがアプリのペンディングインテントをどのように使用できるかを明確に定義するには、常にペンディングインテントを明示的インテントでラップします。このベストプラクティスに沿って対応するには、次の手順を行います。

ベースインテントのアクション、パッケージ、コンポーネントの各フィールドが設定されていることを確認します。
Android 6.0（API レベル 23）で追加された FLAG_IMMUTABLE を使用して、保留中のインテントを作成します。このフラグは、PendingIntent を受け取ったアプリで未入力のプロパティが入力されないようにします。アプリの minSdkVersion が 22 以下の場合は、次のコードを使用して安全性と互換性を同時に提供できます。
```
if (Build.VERSION.SDK_INT >= 23) {
  // Create a PendingIntent using FLAG_IMMUTABLE.
} else {
  // Existing code that creates a PendingIntent.
}
```

インテントの解決

システムは、アクティビティを開始する暗黙的インテントを受け取ると、次の 3 つの要素に基づいてインテントフィルタと比較することで、そのインテントに最適なアクティビティを検索します。

アクション。
データ（URI とデータタイプの両方）。
カテゴリ。

以降のセクションでは、アプリのマニフェストファイルで宣言されたインテントフィルタに基づいて、インテントが適切なコンポーネントに紐付けられる方法について説明します。

アクションのテスト

受け入れるインテントのアクションを指定するには、インテントフィルタでゼロ個以上の <action> 要素を宣言します。次の例をご覧ください。

<intent-filter>
    <action android:name="android.intent.action.EDIT" />
    <action android:name="android.intent.action.VIEW" />
    ...
</intent-filter>

このフィルタを通過するには、Intent で指定されたアクションが、フィルタにリストされたアクションのいずれかに一致する必要があります。

フィルタのリストにアクションが 1 つもない場合は、インテントに一致するものがないため、すべてのインテントがテストに失敗します。ただし、Intent がアクションを指定していない場合でも、フィルタに少なくとも 1 つのアクションが含まれていればテストに合格します。

カテゴリのテスト

受け入れるインテントカテゴリを指定するには、次の例に示すように、インテントフィルタで 0 個以上の <category> 要素を宣言します。

<intent-filter>
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    ...
</intent-filter>

インテントがカテゴリのテストに合格するには、Intent 内のすべてのカテゴリが、フィルタ内のカテゴリに一致する必要があります。逆は必要ありません。インテントフィルタでは、Intent で指定されたカテゴリよりも多くのカテゴリが宣言されている場合もありますが、Intent は引き続き合格します。したがって、カテゴリのないインテントは、フィルタで宣言されているカテゴリに関係なく、常にこのテストに合格します。

注: Android では、startActivity() と startActivityForResult() に渡されるすべての暗黙的インテントに CATEGORY_DEFAULT カテゴリが自動的に適用されます。アクティビティが暗黙的インテントを受け取るようにするには、前の <intent-filter> の例で示したように、インテントフィルタに "android.intent.category.DEFAULT" のカテゴリを含める必要があります。

データテスト

受け入れるインテントデータを指定するには、インテントフィルタでゼロ個以上の <data> 要素を宣言します。次の例をご覧ください。

<intent-filter>
    <data android:mimeType="video/mpeg" android:scheme="http" ... />
    <data android:mimeType="audio/mpeg" android:scheme="http" ... />
    ...
</intent-filter>

各 <data> 要素では、URI 構造とデータタイプ（MIME メディアタイプ）を指定できます。URI の各部分は、scheme、host、port、path の個別の属性です。

<scheme>://<host>:<port>/<path>

次の例は、これらの属性の有効な値を示しています。

content://com.example.project:200/folder/subfolder/etc

この URI では、スキームが content、ホストが com.example.project、ポートが 200、パスが folder/subfolder/etc です。

<data> 要素ではこれらの各属性は省略可能ですが、線形依存関係があります。

スキームが指定されていない場合、ホストは無視されます。
ホストが指定されていない場合、ポートは無視されます。
スキームとホストの両方が指定されていない場合、パスは無視されます。

インテントの URI をフィルタの URI 仕様に比較するときは、フィルタに含まれる URI の一部でのみ比較されます。例:

フィルタでスキームのみが指定されている場合、そのスキームを持つすべての URI がフィルタに一致します。
フィルタでスキームと認証局が指定されていて、パスが指定されていない場合、パスにかかわらず同じスキームと認証局を持つすべての URI がフィルタを通過します。
フィルタでスキーム、認証局、パスが指定されている場合、同じスキーム、認証局、パスを持つ URI のみがフィルタを通過します。

注: パスの指定にワイルドカードアスタリスク（*）を含めると、パス名の部分一致のみを求めることができます。

データのテストでは、インテントの URI と MIME タイプの両方を、フィルタで指定された URI と MIME タイプと比較します。ルールは次のとおりです。

URI も MIME タイプも含まないインテントは、フィルタで URI や MIME タイプが指定されていない場合のみテストをパスします。
URI を含んでいて MIME タイプを含んでいないインテント（明示的にも含まれておらず、URI からも推測できない）場合は、URI がフィルタの URI 形式に一致し、フィルタが MIME タイプを指定していない場合のみテストをパスします。
MIME タイプを含んでいて、URI を含んでいないインテントは、フィルタのリストに同じ MIME タイプがあり、URI 形式が指定されていない場合のみテストをパスします。
URI と MIME タイプ（明示的または URI から推定可能）の両方を含むインテントは、そのタイプがフィルタにリストされているタイプと一致する場合にのみ、テストの MIME タイプの部分をパスします。テストの URI のパートは、URI がフィルタの URI に一致するか、content: URI または file: URI があって URI が指定されていない場合にパスできます。つまり、フィルタリストに MIME タイプのみがある場合、コンポーネントは content: データと file: データをサポートすると推定されます。

注: インテントで URI または MIME タイプが指定されている場合、<intent-filter> に <data> 要素がないと、データテストは失敗します。

この最後のルール（d）は、コンポーネントがファイルまたはコンテンツプロバイダからローカルデータを取得できるという想定を反映しています。そのため、フィルタにはデータタイプのみをリストして、content: スキームと file: スキームを明示的に指定する必要はありません。次の例は、コンポーネントがコンテンツプロバイダから画像データを取得して表示できることを、<data> 要素が Android に伝える一般的なケースを示しています。

<intent-filter>
    <data android:mimeType="image/*" />
    ...
</intent-filter>

利用可能なデータのほとんどはコンテンツプロバイダによって提供されるため、データタイプが指定されていて URI 指定されていないデータが最も一般的です。

もうひとつ一般的な設定として、スキームとデータタイプを使ったフィルタがあります。たとえば、次の <data> 要素は、アクションを実行するためにコンポーネントがネットワークから動画データを取得できることを Android に伝えています。

<intent-filter>
    <data android:scheme="http" android:mimeType="video/*" />
    ...
</intent-filter>

インテントマッチング

インテントをインテントフィルタにマッチングする目的には、アクティベートするターゲットを発見するということだけでなく、端末上のコンポーネントのセットに関連する何かを発見するという目的があります。たとえば、ホームアプリは、ACTION_MAIN アクションと CATEGORY_LAUNCHER カテゴリを指定するインテントフィルタを持つすべてのアクティビティを見つけることで、アプリランチャーを設定します。IntentFilter クラスのドキュメントに記載されているように、インテントのアクションとカテゴリがフィルタと一致する場合にのみ、マッチングが成功します。

アプリは、Google Home アプリと同様にインテントマッチングを使用できます。PackageManager には、特定のインテントを受け入れることのできるすべてのコンポーネントを返す一連の query...() メソッドと、同様にインテントに応答できる最適なコンポーネントを返す一連の resolve...() メソッドがあります。たとえば、queryIntentActivities() は引数として渡されたインテントを実行できるすべてのアクティビティのリストを返します。queryIntentServices() は同様のサービスのリストを返します。どちらの方法でもコンポーネントはアクティブになりません。応答できるコンポーネントのみがリストされます。ブロードキャストレシーバにも、同様のメソッド queryBroadcastReceivers() があります。

インテントとインテント フィルタ

インテントのタイプ

インテントを作成する

Kotlin

Java

Kotlin

Java

明示的インテントの例

Kotlin

Java

暗黙的インテントの例

Kotlin

Java

アプリチューザを表示する

Kotlin

Java

インテントの安全でない起動を検出する

安全でないインテントの起動を確認する

Kotlin

Java

より厳格なインテントの使い方

暗黙的インテントを受け取る

フィルタの例

インテントと他のアプリのインテント フィルタを一致させる

ペンディング インテントを使用する

可変性を指定する

可能な限り不変のペンディング インテントを作成する

Kotlin

Java

ペンディング インテント内で明示的インテントを使用する

インテントの解決

アクションのテスト

カテゴリのテスト

データテスト

インテント マッチング

インテントとインテントフィルタ

インテントと他のアプリのインテントフィルタを一致させる

ペンディングインテントを使用する

可能な限り不変のペンディングインテントを作成する

ペンディングインテント内で明示的インテントを使用する

インテントマッチング