Androidにおける FLAG_ACTIVITY_CLEAR_TOP の使い方

Androidでは、FLAG_ACTIVITY_CLEAR_TOPは、アクティビティを起動する際に、そのアクティビティがすでにタスクスタック内に存在する場合は、そのアクティビティより上のすべてのアクティビティを消去し、そのアクティビティをスタックの一番上に配置するインテントフラグです。

以下、FLAG_ACTIVITY_CLEAR_TOP を使ったサンプルコードです。

Intent intent = new Intent(this, YourActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
startActivity(intent);

上記のコードでは、まずインテントオブジェクトが生成され、起動するアクティビティが指定されます。 次に、addFlags()メソッドが呼び出され、FLAG_ACTIVITY_CLEAR_TOPフラグが渡されることで、このフラグがインテントに追加されます。 最後に、startActivity()メソッドが呼び出されて、アクティビティが起動します。

なお、FLAG_ACTIVITY_CLEAR_TOP フラグを利用する場合は、対象のアクティビティがすでにタスクスタック内に存在している必要があります。そうでなければ、このフラグは機能しません。

さらに、起動先のActivity自体をクリアして起動する場合は、FLAG_ACTIVITY_CLEAR_TOPとFLAG_ACTIVITY_SINGLE_TOPを組み合わせたフラグを使用できます。以下に例を示します。

Intent intent = new Intent(this, YourActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
startActivity(intent);

FLAG_ACTIVITY_SINGLE_TOPフラグを追加することで、ターゲットアクティビティが再作成されるのを回避し、代わりに既にあるインスタンスを再利用できるようになります。