AndroidManifest.xmlファイル詳細(activity)(一)
9936 ワード
1 <activity
2 android:allowTaskReparenting=["true" | "false"]
3 android:alwaysRetainTaskState=["true" | "false"]
4 android:clearTaskOnLaunch=["true" | "false"]
5 android:configChanges=["mcc", "mnc", "locale",
6 "touchscreen", "keyboard", "keyboardHidden",
7 "navigation", "screenLayout", "fontScale", "uiMode",
8 "orientation", "screenSize", "smallestScreenSize"]
9 android:enabled=["true" | "false"]
10 android:excludeFromRecents=["true" | "false"]
11 android:exported=["true" | "false"]
12 android:finishOnTaskLaunch=["true" | "false"]
13 android:hardwareAccelerated=["true" | "false"]
14 android:icon="drawable resource"
15 android:label="string resource"
16 android:launchMode=["multiple" | "singleTop" |
17 "singleTask" | "singleInstance"]
18 android:multiprocess=["true" | "false"]
19 android:name="string"
20 android:noHistory=["true" | "false"]
21 android:permission="string"
22 android:process="string"
23 android:screenOrientation=["unspecified" | "user" | "behind" |
24 "landscape" | "portrait" |
25 "reverseLandscape" | "reversePortrait" |
26 "sensorLandscape" | "sensorPortrait" |
27 "sensor" | "fullSensor" | "nosensor"]
28 android:stateNotNeeded=["true" | "false"]
29 android:taskAffinity="string"
30 android:theme="resource or theme"
31 android:uiOptions=["none" | "splitActionBarWhenNarrow"]
32 android:windowSoftInputMode=["stateUnspecified",
33 "stateUnchanged", "stateHidden",
34 "stateAlwaysHidden", "stateVisible",
35 "stateAlwaysVisible", "adjustUnspecified",
36 "adjustResize", "adjustPan"] >
37 . . .
38 </activity>
(CONTAINED IN):
含めることができる要素(CAN CONTAIN):
説明(DESCRIPTION):
この要素は、アプリケーションの可視化されたユーザーインタフェース部分を実装するActivity(またはActivityのサブクラス)を宣言します.アプリケーション内のすべてのActivityは、リストファイルに
プロパティ(ATTRIBUTES):
android:allowTaskReparenting
このプロパティは、Activityが起動したタスクから起動したタスクと親関係のある別のタスクに移行できるように設定するために使用され、この親関係のあるタスクがフロントに持ち込まれたときに移行タイミングが設定されます.trueが設定されている場合は移行できますが、falseが設定されている場合は、このActivityを起動したタスクに保持する必要があります.
この属性が設定されていない場合、その対応する<アプリケーション>要素のallowTaskReparenting属性値がこのActivityに適用されます.デフォルトはfalseです.
通常、Activityが起動されると、起動タスクに関連付けられ、ライフサイクル全体がそのタスクに保持されます.ただし、Activityの現在のタスクが表示されていない場合は、このプロパティを使用してActivityを現在のタスクと親関係のあるタスクに強制的に移行できます.この場合の典型的なアプリケーションは、アプリケーションのActivityをこのアプリケーションに関連付けられたメインタスクに移行することである.
たとえば、電子メールメッセージにWebページのリンクが含まれている場合、このリンクをクリックすると、そのWebページを表示するActivityが起動します.ただし、e-mailタスクセクションで起動したこのActivityはブラウザアプリケーションによって定義されています.ブラウザのタスクに格納すると、ブラウザが次回フロントに起動すると、このページが表示され、e-mailタスクが再び表示されると、このActivityは消えます.
Activityの親関係はtaskAffinity属性によって定義されます.タスクのルートActivityの親関係を読み取ることでタスクの親関係を判断する.したがって,定義により,タスク中のルートActivityはタスクと同じ親縁関係を持つ.したがってsingleTaskまたはsingleInstance起動モードを持つActivityは、タスクのルートノードのみであり、Activityのタスク帰属はstandardおよびsingleTopモードに限定される.
android:alwaysRetainTaskState
このプロパティは、Activityが属するタスクステータスが常にシステムによって維持されるかどうかを設定するために使用されます.trueに設定すると、ステータスがシステムによって維持されfalseに設定されます.場合によっては、タスクの初期ステータスのリセットが許可されることがあります.デフォルトはfalseです.このプロパティは、タスクルートノードのActivityにのみ意味があり、他のすべてのActivityは無視されます.
通常、ユーザーがメイン画面からタスクを再起動すると、タスクが消去されます(ルートノードActivityの上にあるすべてのActivityがスタックから削除されます).
ただし、このプロパティがtrueに設定されている場合、ユーザーは、どのような操作が行われているかにかかわらず、このタスクの最後のステータスに戻ります.これにより、例えば、Webブラウザのアプリケーションは、複数の開かれたラベルページなど、多くのユーザが失いたくない状態を保持することができる.
android:clearTaskOnLaunch
このプロパティは、メイン画面からタスクを再起動するときに、ルートノードを処理するActivity以外のタスクの他のすべてのActivityを削除するかどうかを設定するために使用します.trueに設定すると、タスクルートノードのActivityの上にあるすべてのActivityがクリアされ、falseが設定されている場合はクリアされません.デフォルト設定時false.このプロパティは、新しいタスク(またはルートActivity)を起動するActivityにのみ意味があり、タスク内の他のすべてのActivityは無視されます.
この属性値がtrueに設定され、ユーザーがタスクを再起動すると、タスクの最後に何をしても、タスクがBackボタンを使用しても、ホームを使用して離れても、タスクルートノードのActivityが表示されます.このプロパティがfalseに設定されている場合、このタスクのActivityはクリアできますが、必ずしもそうではありません.
例えば、誰かがメイン画面からActivity Pを起動し、PからActivity Qを起動したとする.次にユーザはホームボタンを押し、Activity Pに戻る.通常、ユーザーはActivity Qを見ることができます.これはPのタスクで最後にしたことだからです.ただし、Pがこの属性をtrueに設定すると、ユーザがホームボタンを押下してタスクが保留されると、Activity P以上のすべてのActivity(本例ではActivity Q)が削除される.したがって、ユーザが再びこのタスクに戻ると、ユーザはActivity Pのみを見ることができる.
この属性とallowTaskReparenting属性がtrueに設定されている場合、親関係が設定されているActivityは共有されている親タスクに移行し、残りのActivityを削除します.