| page.title=Activity |
| page.tags=Activity, Intent |
| @jd:body |
| |
| <div id="qv-wrapper"> |
| <div id="qv"> |
| <h2>本文内容</h2> |
| <ol> |
| <li><a href="#Creating">创建 Activity</a> |
| <ol> |
| <li><a href="#UI">实现用户界面</a></li> |
| <li><a href="#Declaring">在清单文件中声明 Activity</a></li> |
| </ol> |
| </li> |
| <li><a href="#StartingAnActivity">启动 Activity</a> |
| <ol> |
| <li><a href="#StartingAnActivityForResult">启动 Activity 以获得结果</a></li> |
| </ol> |
| </li> |
| <li><a href="#ShuttingDown">结束 Activity</a></li> |
| <li><a href="#Lifecycle">管理 Activity 生命周期</a> |
| <ol> |
| <li><a href="#ImplementingLifecycleCallbacks">实现生命周期回调</a></li> |
| <li><a href="#SavingActivityState">保存 Activity 状态</a></li> |
| <li><a href="#ConfigurationChanges">处理配置变更</a></li> |
| <li><a href="#CoordinatingActivities">协调 Activity</a></li> |
| </ol> |
| </li> |
| </ol> |
| |
| <h2>关键类</h2> |
| <ol> |
| <li>{@link android.app.Activity}</li> |
| </ol> |
| |
| <h2>另请参阅</h2> |
| <ol> |
| <li><a href="{@docRoot}guide/components/tasks-and-back-stack.html">任务和返回栈</a> |
| </li> |
| </ol> |
| |
| </div> |
| </div> |
| |
| |
| |
| <p>{@link android.app.Activity} |
| 是一个应用组件,用户可与其提供的屏幕进行交互,以执行拨打电话、拍摄照片、发送电子邮件或查看地图等操作。 |
| 每个 Activity 都会获得一个用于绘制其用户界面的窗口。窗口通常会充满屏幕,但也可小于屏幕并浮动在其他窗口之上。 |
| |
| </p> |
| |
| <p> 一个应用通常由多个彼此松散联系的 Activity 组成。 |
| 一般会指定应用中的某个 Activity 为“主” Activity,即首次启动应用时呈现给用户的那个 Activity。 |
| 而且每个 Activity 均可启动另一个 Activity,以便执行不同的操作。 |
| 每次新 Activity 启动时,前一 Activity 便会停止,但系统会在堆栈(“返回栈”)中保留该 Activity。 |
| |
| 当新 Activity 启动时,系统会将其推送到返回栈上,并取得用户焦点。 |
| 返回栈遵循“后进先出”堆栈机制,因此,当用户完成当前 Activity 并按“返回” |
| <em></em> |
| 按钮时,系统会从堆栈中将其弹出(并销毁),然后恢复前一 Activity。(<a href="{@docRoot}guide/components/tasks-and-back-stack.html">任务和返回栈</a>文档中对返回栈有更详细的阐述。) |
| |
| </p> |
| |
| <p>当一个 Activity 因某个新 Activity 启动而停止时,系统会通过该 Activity 的生命周期回调方法通知其这一状态变化。Activity 因状态变化—系统是创建 Activity、停止 Activity、恢复 Activity 还是销毁 Activity— 而收到的回调方法可能有若干种,每一种回调方法都会为您提供执行与该状态变化相应的特定操作的机会。 |
| |
| |
| |
| |
| 例如,停止时,您的 Activity 应释放任何大型对象,例如网络或数据库连接。 |
| 当 Activity 恢复时,您可以重新获取所需资源,并恢复执行中断的操作。 |
| 这些状态转变都是 Activity 生命周期的一部分。 |
| </p> |
| |
| <p>本文的其余部分阐述有关如何创建和使用 Activity 的基础知识(包括对 Activity 生命周期工作方式的全面阐述),以便您正确管理各种 Activity 状态之间的转变。 |
| |
| </p> |
| |
| |
| |
| <h2 id="Creating">创建 Activity</h2> |
| |
| <p>要创建 Activity,您必须创建 {@link android.app.Activity} |
| 的子类(或使用其现有子类)。您需要在子类中实现 Activity 在其生命周期的各种状态之间转变时(例如创建 Activity、停止 Activity、恢复 Activity 或销毁 Activity 时)系统调用的回调方法。 |
| |
| 两个最重要的回调方法是: |
| </p> |
| |
| <dl> |
| <dt>{@link android.app.Activity#onCreate onCreate()}</dt> |
| <dd>您必须实现此方法。系统会在创建您的 |
| Activity 时调用此方法。您应该在实现内初始化 Activity 的必需组件。 |
| |
| 最重要的是,您必须在此方法内调用 {@link android.app.Activity#setContentView |
| setContentView()},以定义 Activity 用户界面的布局。</dd> |
| <dt>{@link android.app.Activity#onPause onPause()}</dt> |
| <dd>系统将此方法作为用户离开 Activity 的第一个信号(但并不总是意味着 Activity 会被销毁)进行调用。 |
| 您通常应该在此方法内确认在当前用户会话结束后仍然有效的任何更改(因为用户可能不会返回)。 |
| |
| </dd> |
| </dl> |
| |
| <p>您还应使用几种其他生命周期回调方法,以便提供流畅的 Activity 间用户体验,以及处理导致您的 Activity 停止甚至被销毁的意外中断。 |
| |
| 后文的<a href="#Lifecycle">管理 Activity 生命周期</a>部分对所有生命周期回调方法进行了阐述。 |
| </p> |
| |
| |
| |
| <h3 id="UI">实现用户界面</h3> |
| |
| <p> Activity 的用户界面是由层级式视图—衍生自 {@link android.view.View} |
| 类的对象—提供的。每个视图都控制 Activity 窗口内的特定矩形空间,可对用户交互作出响应。 |
| 例如,视图可以是在用户触摸时启动某项操作的按钮。 |
| </p> |
| |
| <p>您可以利用 Android |
| 提供的许多现成视图设计和组织您的布局。“小工具”是提供按钮、文本字段、复选框或仅仅是一幅图像等屏幕视觉(交互式)元素的视图。 |
| “布局”是衍生自 {@link |
| android.view.ViewGroup} |
| 的视图,为其子视图提供唯一布局模型,例如线性布局、网格布局或相对布局。您还可以为 {@link android.view.View} 类和 |
| {@link android.view.ViewGroup} |
| 类创建子类(或使用其现有子类)来自行创建小工具和布局,然后将它们应用于您的 Activity 布局。</p> |
| |
| <p>利用视图定义布局的最常见方法是借助保存在您的应用资源内的 XML |
| 布局文件。这样一来,您就可以将用户界面的设计与定义 Activity 行为的源代码分开维护。 |
| 您可以通过 {@link android.app.Activity#setContentView(int) setContentView()} |
| 将布局设置为 Activity 的 UI,从而传递布局的资源 |
| ID。不过,您也可以在 Activity 代码中创建新 |
| {@link android.view.View},并通过将新 {@link |
| android.view.View} 插入 {@link android.view.ViewGroup} 来创建视图层次,然后通过将根 |
| {@link android.view.ViewGroup} 传递到 {@link android.app.Activity#setContentView(View) |
| setContentView()} 来使用该布局。</p> |
| |
| <p>如需了解有关创建用户界面的信息,请参阅<a href="{@docRoot}guide/topics/ui/index.html">用户界面</a>文档。</p> |
| |
| |
| |
| <h3 id="Declaring">在清单文件中声明 Activity</h3> |
| |
| <p>您必须在清单文件中声明您的 Activity,这样系统才能访问它。 |
| 要声明您的 Activity,请打开您的清单文件,并将 <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> 元素添加为 |
| <a href="{@docRoot}guide/topics/manifest/application-element.html">{@code <application>}</a> |
| 元素的子项。例如:</p> |
| |
| <pre> |
| <manifest ... > |
| <application ... > |
| <activity android:name=".ExampleActivity" /> |
| ... |
| </application ... > |
| ... |
| </manifest > |
| </pre> |
| |
| <p>您还可以在此元素中加入几个其他特性,以定义 Activity 标签、Activity 图标或风格主题等用于设置 Activity |
| UI |
| 风格的属性。<a href="{@docRoot}guide/topics/manifest/activity-element.html#nm">{@code android:name}</a> |
| 特性是唯一的必需特性—它指定 Activity 的类名。应用一旦发布,即不应更改此类名,否则,可能会破坏诸如应用快捷方式等一些功能(请阅读博客文章 |
| <a href="http://android-developers.blogspot.com/2011/06/things-that-cannot-change.html">Things |
| That Cannot Change</a> |
| [不能更改的内容])。</p> |
| |
| <p>请参阅 <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> |
| 元素参考文档,了解有关在清单文件中声明 Activity 的详细信息。</p> |
| |
| |
| <h4>使用 Intent 过滤器</h4> |
| |
| <p><a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code |
| <activity>}</a> 元素还可指定各种 Intent 过滤器—使用 <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code |
| <Intent-filter>}</a> |
| 元素—以声明其他应用组件激活它的方法。</p> |
| |
| <p>当您使用 Android SDK 工具创建新应用时,系统自动为您创建的存根 Activity 包含一个 Intent 过滤器,其中声明了该 Activity 响应“主”操作且应置于“launcher”类别内。 |
| |
| Intent 过滤器的内容与以下所示类似: |
| </p> |
| |
| <pre> |
| <activity android:name=".ExampleActivity" android:icon="@drawable/app_icon"> |
| <intent-filter> |
| <action android:name="android.intent.action.MAIN" /> |
| <category android:name="android.intent.category.LAUNCHER" /> |
| </intent-filter> |
| </activity> |
| </pre> |
| |
| <p><a href="{@docRoot}guide/topics/manifest/action-element.html">{@code |
| <action>}</a> 元素指定这是应用的“主”入口点。<a href="{@docRoot}guide/topics/manifest/category-element.html">{@code |
| <category>}</a> |
| 元素指定此 Activity 应列入系统的应用启动器内(以便用户启动该 Activity)。</p> |
| |
| <p>如果您打算让应用成为独立应用,不允许其他应用激活其 Activity,则您不需要任何其他 Intent 过滤器。 |
| 正如前例所示,只应有一个 Activity 具有“主”操作和“launcher”类别。 |
| 您不想提供给其他应用的 Activity 不应有任何 Intent 过滤器,您可以利用显式 Intent 自行启动它们(下文对此做了阐述)。 |
| |
| </p> |
| |
| <p>不过,如果您想让 Activity 对衍生自其他应用(以及您的自有应用)的隐式 Intent 作出响应,则必须为 Activity 定义其他 Intent 过滤器。 |
| |
| 对于您想要作出响应的每一个 Intent 类型,您都必须加入相应的 <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code |
| <Intent-filter>}</a>,其中包括一个 |
| <a href="{@docRoot}guide/topics/manifest/action-element.html">{@code |
| <action>}</a> 元素,还可选择性地包括一个 <a href="{@docRoot}guide/topics/manifest/category-element.html">{@code |
| <category>}</a> 元素和/或一个 <a href="{@docRoot}guide/topics/manifest/data-element.html">{@code |
| <data>}</a> 元素。这些元素指定您的 Activity 可以响应的 Intent 类型。 |
| </p> |
| |
| <p>如需了解有关您的 Activity 如何响应 Intent 的详细信息,请参阅<a href="{@docRoot}guide/components/intents-filters.html"> Intent 和 Intent 过滤器</a>文档。 |
| </p> |
| |
| |
| |
| <h2 id="StartingAnActivity">启动 Activity</h2> |
| |
| <p>您可以通过调用 {@link android.app.Activity#startActivity |
| startActivity()},并将其传递给描述您想启动的 Activity 的 {@link android.content.Intent} |
| 来启动另一个 Activity。Intent 对象会指定您想启动的具体 Activity 或描述您想执行的操作类型(系统会为您选择合适的 Activity,甚至是来自其他应用的 Activity)。 |
| |
| |
| Intent 对象还可能携带少量供所启动 Activity 使用的数据。 |
| </p> |
| |
| <p>在您的自有应用内工作时,您经常只需要启动某个已知 Activity。 |
| 您可以通过使用类名创建一个显式定义您想启动的 Activity 的 Intent 对象来实现此目的。 |
| 例如,可以通过以下代码让一个 Activity 启动另一个名为 {@code |
| SignInActivity} 的 Activity:</p> |
| |
| <pre> |
| Intent intent = new Intent(this, SignInActivity.class); |
| startActivity(intent); |
| </pre> |
| |
| <p>不过,您的应用可能还需要利用您的 Activity 数据执行某项操作,例如发送电子邮件、短信或状态更新。 |
| 在这种情况下,您的应用自身可能不具有执行此类操作所需的 Activity,因此您可以改为利用设备上其他应用提供的 Activity 为您执行这些操作。 |
| |
| 这便是 Intent 对象的真正价值所在—您可以创建一个 Intent 对象,对您想执行的操作进行描述,系统会从其他应用启动相应的 Activity。 |
| |
| |
| 如果有多个 Activity 可以处理 Intent,则用户可以选择要使用哪一个。 |
| 例如,如果您想允许用户发送电子邮件,可以创建以下 Intent 对象: |
| |
| </p> |
| |
| <pre> |
| Intent intent = new Intent(Intent.ACTION_SEND); |
| intent.putExtra(Intent.EXTRA_EMAIL, recipientArray); |
| startActivity(intent); |
| </pre> |
| |
| <p>添加到 Intent 中的 {@link android.content.Intent#EXTRA_EMAIL} extra 是一个字符串数组,其中包含应将电子邮件发送到的电子邮件地址。 |
| 当电子邮件应用响应此 Intent 时,它会读取 extra 中提供的字符串数组,并将它们放入电子邮件撰写窗体的“收件人”字段。 |
| |
| 在这种情况下,电子邮件应用的 Activity 启动,并且当用户完成操作时,您的 Activity 会恢复执行。 |
| </p> |
| |
| |
| |
| |
| <h3 id="StartingAnActivityForResult">启动 Activity 以获得结果</h3> |
| |
| <p>有时,您可能需要从启动的 Activity 获得结果。在这种情况下,请通过调用 {@link android.app.Activity#startActivityForResult |
| startActivityForResult()}(而非 {@link android.app.Activity#startActivity |
| startActivity()})来启动 Activity。 |
| 要想在随后收到后续 Activity 的结果,请实现 |
| {@link android.app.Activity#onActivityResult onActivityResult()} 回调方法。 |
| 当后续 Activity 完成时,它会使用 {@link |
| android.content.Intent} 向您的 {@link android.app.Activity#onActivityResult onActivityResult()} |
| 方法返回结果。</p> |
| |
| <p>例如,您可能希望用户选取其中一位联系人,以便您的 Activity 对该联系人中的信息执行某项操作。 |
| 您可以通过以下代码创建此类 Intent 并处理结果: |
| </p> |
| |
| <pre> |
| private void pickContact() { |
| // Create an intent to "pick" a contact, as defined by the content provider URI |
| Intent intent = new Intent(Intent.ACTION_PICK, Contacts.CONTENT_URI); |
| startActivityForResult(intent, PICK_CONTACT_REQUEST); |
| } |
| |
| @Override |
| protected void onActivityResult(int requestCode, int resultCode, Intent data) { |
| // If the request went well (OK) and the request was PICK_CONTACT_REQUEST |
| if (resultCode == Activity.RESULT_OK && requestCode == PICK_CONTACT_REQUEST) { |
| // Perform a query to the contact's content provider for the contact's name |
| Cursor cursor = getContentResolver().query(data.getData(), |
| new String[] {Contacts.DISPLAY_NAME}, null, null, null); |
| if (cursor.moveToFirst()) { // True if the cursor is not empty |
| int columnIndex = cursor.getColumnIndex(Contacts.DISPLAY_NAME); |
| String name = cursor.getString(columnIndex); |
| // Do something with the selected contact's name... |
| } |
| } |
| } |
| </pre> |
| |
| <p>上例显示的是,您在处理 Activity 结果时应该在 {@link |
| android.app.Activity#onActivityResult onActivityResult()} |
| 方法中使用的基本逻辑。第一个条件检查请求是否成功(如果成功,则{@code resultCode} 将为 {@link android.app.Activity#RESULT_OK})以及此结果响应的请求是否已知 — 在此情况下,{@code requestCode}与随 {@link android.app.Activity#startActivityForResult |
| startActivityForResult()} 发送的第二个参数匹配。 |
| |
| |
| 代码通过查询 {@link android.content.Intent} 中返回的数据({@code data} 参数)从该处开始处理 Activity 结果。 |
| </p> |
| |
| <p>实际情况是,{@link |
| android.content.ContentResolver} 对一个内容提供程序执行查询,后者返回一个 |
| {@link android.database.Cursor},让查询的数据能够被读取。如需了解详细信息,请参阅<a href="{@docRoot}guide/topics/providers/content-providers.html">内容提供程序</a>文档。 |
| </p> |
| |
| <p>如需了解有关 Intent 用法的详细信息,请参阅<a href="{@docRoot}guide/components/intents-filters.html"> Intent 和 Intent 过滤器</a>文档。 |
| </p> |
| |
| |
| <h2 id="ShuttingDown">结束 Activity</h2> |
| |
| <p>您可以通过调用 Activity 的 {@link android.app.Activity#finish |
| finish()} 方法来结束该 Activity。您还可以通过调用 |
| {@link android.app.Activity#finishActivity finishActivity()} 结束您之前启动的另一个 Activity。</p> |
| |
| <p class="note"><strong>注:</strong>在大多数情况下,您不应使用这些方法显式结束 Activity。 |
| 正如下文有关 Activity 生命周期的部分所述,Android 系统会为您管理 Activity 的生命周期,因此您无需完成自己的 Activity。 |
| |
| 调用这些方法可能对预期的用户体验产生不良影响,因此只应在您确实不想让用户返回此 Activity 实例时使用。 |
| |
| </p> |
| |
| |
| <h2 id="Lifecycle">管理 Activity 生命周期</h2> |
| |
| <p>通过实现回调方法管理 Activity 的生命周期对开发强大而又灵活的应用至关重要。 |
| |
| Activity 的生命周期会直接受到 Activity 与其他 Activity、其任务及返回栈的关联性的影响。 |
| </p> |
| |
| <p>Activity 基本上以三种状态存在:</p> |
| |
| <dl> |
| <dt><i>已继续</i></dt> |
| <dd>此 Activity 位于屏幕前台并具有用户焦点。(有时也将此状态称作“运行中”。) |
| </dd> |
| |
| <dt><i>已暂停</i></dt> |
| <dd>另一个 Activity 位于屏幕前台并具有用户焦点,但此 Activity 仍可见。也就是说,另一个 Activity 显示在此 Activity 上方,并且该 Activity 部分透明或未覆盖整个屏幕。 |
| |
| 已暂停的 Activity 处于完全 Activity 状态({@link android.app.Activity} |
| 对象保留在内存中,它保留了所有状态和成员信息,并与窗口管理器保持连接),但在内存极度不足的情况下,可能会被系统终止。 |
| </dd> |
| |
| <dt><i>已停止</i></dt> |
| <dd>该 Activity 被另一个 Activity 完全遮盖(该 Activity 目前位于“后台”)。 |
| 已停止的 Activity 同样仍处于 Activity 状态({@link android.app.Activity} |
| 对象保留在内存中,它保留了所有状态和成员信息,但<em>未</em>与窗口管理器连接)。 |
| 不过,它对用户不再可见,在他处需要内存时可能会被系统终止。 |
| </dd> |
| </dl> |
| |
| <p>如果 Activity 处于暂停或停止状态,系统可通过要求其结束(调用其 |
| {@link android.app.Activity#finish finish()} |
| 方法)或直接终止其进程,将其从内存中删除。(将其结束或终止后)再次打开 Activity 时,必须重建。 |
| </p> |
| |
| |
| |
| <h3 id="ImplementingLifecycleCallbacks">实现生命周期回调</h3> |
| |
| <p>当一个 Activity 转入和转出上述不同状态时,系统会通过各种回调方法向其发出通知。 |
| 所有回调方法都是挂钩,您可以在 Activity 状态发生变化时替代这些挂钩来执行相应操作。 |
| 以下框架 Activity 包括每一个基本生命周期方法: |
| </p> |
| |
| |
| <pre> |
| public class ExampleActivity extends Activity { |
| @Override |
| public void {@link android.app.Activity#onCreate onCreate}(Bundle savedInstanceState) { |
| super.onCreate(savedInstanceState); |
| // The activity is being created. |
| } |
| @Override |
| protected void {@link android.app.Activity#onStart onStart()} { |
| super.onStart(); |
| // The activity is about to become visible. |
| } |
| @Override |
| protected void {@link android.app.Activity#onResume onResume()} { |
| super.onResume(); |
| // The activity has become visible (it is now "resumed"). |
| } |
| @Override |
| protected void {@link android.app.Activity#onPause onPause()} { |
| super.onPause(); |
| // Another activity is taking focus (this activity is about to be "paused"). |
| } |
| @Override |
| protected void {@link android.app.Activity#onStop onStop()} { |
| super.onStop(); |
| // The activity is no longer visible (it is now "stopped") |
| } |
| @Override |
| protected void {@link android.app.Activity#onDestroy onDestroy()} { |
| super.onDestroy(); |
| // The activity is about to be destroyed. |
| } |
| } |
| </pre> |
| |
| <p class="note"><strong>注:</strong>正如以上示例所示,您在实现这些生命周期方法时必须始终先调用超类实现,然后再执行任何操作。 |
| </p> |
| |
| <p>这些方法共同定义 Activity 的整个生命周期。您可以通过实现这些方法监控 Activity 生命周期中的三个嵌套循环: |
| </p> |
| |
| <ul> |
| <li>Activity 的<b>整个生命周期</b>发生在 {@link |
| android.app.Activity#onCreate onCreate()} 调用与 {@link |
| android.app.Activity#onDestroy} 调用之间。您的 Activity 应在 {@link android.app.Activity#onCreate onCreate()} |
| 中执行“全局”状态设置(例如定义布局),并释放 {@link android.app.Activity#onDestroy} |
| 中的所有其余资源。例如,如果您的 Activity 有一个在后台运行的线程,用于从网络上下载数据,它可能会在 |
| {@link android.app.Activity#onCreate onCreate()} 中创建该线程,然后在 |
| {@link |
| android.app.Activity#onDestroy} 中停止该线程。</li> |
| |
| <li><p>Activity 的<b>可见生命周期</b>发生在 {@link |
| android.app.Activity#onStart onStart()} 调用与 {@link |
| android.app.Activity#onStop onStop()} 调用之间。在这段时间,用户可以在屏幕上看到 Activity 并与其交互。 |
| 例如,当一个新 Activity 启动,并且此 Activity 不再可见时,系统会调用 |
| {@link android.app.Activity#onStop onStop()}。您可以在调用这两个方法之间保留向用户显示 Activity 所需的资源。 |
| 例如,您可以在 |
| {@link |
| android.app.Activity#onStart onStart()} 中注册一个 {@link android.content.BroadcastReceiver} 以监控影响 UI |
| 的变化,并在用户无法再看到您显示的内容时在 {@link android.app.Activity#onStop onStop()} |
| 中将其取消注册。在 Activity 的整个生命周期,当 Activity 在对用户可见和隐藏两种状态中交替变化时,系统可能会多次调用 {@link android.app.Activity#onStart onStart()} 和 {@link |
| android.app.Activity#onStop onStop()}。 |
| </p></li> |
| |
| <li><p>Activity 的<b>前台生命周期</b>发生在 {@link |
| android.app.Activity#onResume onResume()} 调用与 {@link android.app.Activity#onPause |
| onPause()} 调用之间。在这段时间,Activity 位于屏幕上的所有其他 Activity 之前,并具有用户输入焦点。 |
| Activity 可频繁转入和转出前台—例如,当设备转入休眠状态或出现对话框时,系统会调用 {@link android.app.Activity#onPause onPause()}。 |
| |
| 由于此状态可能经常发生转变,因此这两个方法中应采用适度轻量级的代码,以避免因转变速度慢而让用户等待。 |
| </p></li> |
| </ul> |
| |
| <p>图 1 说明了这些循环以及 Activity 在状态转变期间可能经过的路径。矩形表示回调方法,当 Activity 在不同状态之间转变时,您可以实现这些方法来执行操作。 |
| |
| <p> |
| |
| <img src="{@docRoot}images/activity_lifecycle.png" alt="" /> |
| <p class="img-caption"><strong>图 1. </strong>Activity 生命周期。</p> |
| |
| <p>表 1 列出了相同的生命周期回调方法,其中对每一种回调方法做了更详细的描述,并说明了每一种方法在 Activity 整个生命周期内的位置,包括在回调方法完成后系统能否终止 Activity。 |
| |
| |
| </p> |
| |
| <p class="table-caption"><strong>表 1. </strong>Activity 生命周期回调方法汇总表。 |
| </p> |
| |
| <table border="2" width="85%" frame="hsides" rules="rows"> |
| <colgroup align="left" span="3"></colgroup> |
| <colgroup align="left"></colgroup> |
| <colgroup align="center"></colgroup> |
| <colgroup align="center"></colgroup> |
| |
| <thead> |
| <tr><th colspan="3">方法</th> <th>描述</th> <th>是否能事后终止?</th> <th>后接</th></tr> |
| </thead> |
| |
| <tbody> |
| <tr> |
| <td colspan="3" align="left"><code>{@link android.app.Activity#onCreate onCreate()}</code></td> |
| <td>首次创建 Activity 时调用。 |
| 您应该在此方法中执行所有正常的静态设置— |
| 创建视图、将数据绑定到列表等等。系统向此方法传递一个 Bundle 对象,其中包含 Activity 的上一状态,不过前提是捕获了该状态(请参阅后文的<a href="#actstate">保存 Activity 状态</a>)。 |
| |
| |
| |
| <p>始终后接 {@code onStart()}。</p></td> |
| <td align="center">否</td> |
| <td align="center">{@code onStart()}</td> |
| </tr> |
| |
| <tr> |
| <td rowspan="5" style="border-left: none; border-right: none;"> </td> |
| <td colspan="2" align="left"><code>{@link android.app.Activity#onRestart |
| onRestart()}</code></td> |
| <td>在 Activity 已停止并即将再次启动前调用。 |
| |
| <p>始终后接 {@code onStart()}</p></td> |
| <td align="center">否</td> |
| <td align="center">{@code onStart()}</td> |
| </tr> |
| |
| <tr> |
| <td colspan="2" align="left"><code>{@link android.app.Activity#onStart onStart()}</code></td> |
| <td>在 Activity 即将对用户可见之前调用。 |
| <p>如果 Activity 转入前台,则后接 {@code onResume()},如果 Activity 转入隐藏状态,则后接 {@code onStop()}。 |
| </p></td> |
| <td align="center">否</td> |
| <td align="center">{@code onResume()} <br/>或<br/> {@code onStop()}</td> |
| </tr> |
| |
| <tr> |
| <td rowspan="2" style="border-left: none;"> </td> |
| <td align="left"><code>{@link android.app.Activity#onResume onResume()}</code></td> |
| <td>在 Activity 即将开始与用户进行交互之前调用。 |
| 此时,Activity 处于 Activity 堆栈的顶层,并具有用户输入焦点。 |
| |
| <p>始终后接 {@code onPause()}。</p></td> |
| <td align="center">否</td> |
| <td align="center">{@code onPause()}</td> |
| </tr> |
| |
| <tr> |
| <td align="left"><code>{@link android.app.Activity#onPause onPause()}</code></td> |
| <td>当系统即将开始继续另一个 Activity 时调用。 |
| 此方法通常用于确认对持久性数据的未保存更改、停止动画以及其他可能消耗 CPU 的内容,诸如此类。 |
| |
| 它应该非常迅速地执行所需操作,因为它返回后,下一个 Activity 才能继续执行。 |
| |
| <p>如果 Activity 返回前台,则后接 {@code onResume()},如果 Activity 转入对用户不可见状态,则后接 {@code onStop()}。 |
| |
| </td> |
| <td align="center"><strong style="color:#800000">是</strong></td> |
| <td align="center">{@code onResume()} <br/>或<br/> {@code onStop()}</td> |
| </tr> |
| |
| <tr> |
| <td colspan="2" align="left"><code>{@link android.app.Activity#onStop onStop()}</code></td> |
| <td>Activity 对用户不再可见时调用。如果 Activity 被销毁,或另一个 Activity(一个现有 Activity 或新 Activity)继续执行并将其覆盖,就可能发生这种情况。 |
| |
| |
| <p>如果 Activity 恢复与用户的交互,则后接 {@code onRestart()},如果 Activity 被销毁,则后接 |
| {@code onDestroy()}。 |
| </p></td> |
| <td align="center"><strong style="color:#800000">是</strong></td> |
| <td align="center">{@code onRestart()} <br/>或<br/> {@code onDestroy()}</td> |
| </tr> |
| |
| <tr> |
| <td colspan="3" align="left"><code>{@link android.app.Activity#onDestroy |
| onDestroy()}</code></td> |
| <td>在 Activity 被销毁前调用。这是 Activity 将收到的最后调用。 |
| 当 Activity 结束(有人调用 Activity 上的 <code>{@link android.app.Activity#finish |
| finish()}</code>),或系统为节省空间而暂时销毁该 Activity 实例时,可能会调用它。 |
| |
| 您可以通过 |
| <code>{@link |
| android.app.Activity#isFinishing isFinishing()}</code> 方法区分这两种情形。</td> |
| <td align="center"><strong style="color:#800000">是</strong></td> |
| <td align="center"><em>无</em></td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <p>名为“是否能事后终止?”的列表示系统是否能在不执行另一行 Activity 代码的情况下,在<em>方法返回后</em>随时终止承载 Activity 的进程。 |
| |
| 有三个方法带有“是”标记:({@link |
| android.app.Activity#onPause |
| onPause()}、{@link android.app.Activity#onStop onStop()} 和 {@link android.app.Activity#onDestroy |
| onDestroy()})。由于 {@link android.app.Activity#onPause onPause()} |
| 是这三个方法中的第一个,因此 Activity 创建后,{@link android.app.Activity#onPause onPause()} |
| 必定成为最后调用的方法,然后<em>才能</em>终止进程—如果系统在紧急情况下必须恢复内存,则可能不会调用 |
| {@link |
| android.app.Activity#onStop onStop()} 和 |
| {@link android.app.Activity#onDestroy onDestroy()}。因此,您应该使用 {@link android.app.Activity#onPause onPause()} |
| 向存储设备写入至关重要的持久性数据(例如用户编辑)。不过,您应该对 |
| {@link android.app.Activity#onPause onPause()} |
| 调用期间必须保留的信息有所选择,因为该方法中的任何阻止过程都会妨碍向下一个 Activity 的转变并拖慢用户体验。 |
| </p> |
| |
| <p> 在<b>是否能在事后终止?</b>列中标记为“否”的方法可从系统调用它们的一刻起防止承载 Activity 的进程被终止。 |
| 因此,在从 {@link android.app.Activity#onPause onPause()} |
| 返回的时间到 {@link android.app.Activity#onResume onResume()} |
| 被调用的时间,系统可以终止 Activity。在 {@link android.app.Activity#onPause onPause()} |
| 被再次调用并返回前,将无法再次终止 Activity。 </p> |
| |
| <p class="note"><strong>注:</strong>根据表 |
| 1 |
| 中的定义属于技术上无法“终止”的 Activity 仍可能被系统终止—但这种情况只有在无任何其他资源的极端情况下才会发生。<a href="{@docRoot}guide/components/processes-and-threads.html">进程和线程处理</a>文档对可能会终止 Activity 的情况做了更详尽的阐述。 |
| |
| </p> |
| |
| |
| <h3 id="SavingActivityState">保存 Activity 状态</h3> |
| |
| <p><a href="#Lifecycle">管理 Activity 生命周期</a>的引言部分简要提及,当 Activity 暂停或停止时,Activity 的状态会得到保留。 |
| |
| 确实如此,因为当 Activity 暂停或停止时,{@link android.app.Activity} |
| 对象仍保留在内存中 — 有关其成员和当前状态的所有信息仍处于 Activity 状态。 |
| 因此,用户在 Activity 内所做的任何更改都会得到保留,这样一来,当 Activity 返回前台(当它“继续”)时,这些更改仍然存在。 |
| |
| </p> |
| |
| <p>不过,当系统为了恢复内存而销毁某项 Activity 时,{@link |
| android.app.Activity} |
| 对象也会被销毁,因此系统在继续 Activity 时根本无法让其状态保持完好,而是必须在用户返回Activity时重建 {@link android.app.Activity} |
| 对象。但用户并不知道系统销毁 Activity 后又对其进行了重建,因此他们很可能认为 Activity 状态毫无变化。 |
| |
| 在这种情况下,您可以实现另一个回调方法对有关 Activity 状态的信息进行保存,以确保有关 Activity 状态的重要信息得到保留:{@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()}。 |
| |
| </p> |
| |
| <p>系统会先调用 |
| {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()},然后再使 Activity 变得易于销毁。系统会向该方法传递一个 |
| {@link android.os.Bundle},您可以在其中使用 |
| {@link |
| android.os.Bundle#putString putString()} 和 {@link |
| android.os.Bundle#putInt putInt()} 等方法以名称-值对形式保存有关 Activity 状态的信息。然后,如果系统终止您的应用进程,并且用户返回您的 Activity,则系统会重建该 Activity,并将 |
| {@link android.os.Bundle} 同时传递给 |
| {@link android.app.Activity#onCreate onCreate()} 和 {@link |
| android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}。您可以使用上述任一方法从 |
| {@link android.os.Bundle} |
| 提取您保存的状态并恢复该 Activity 状态。如果没有状态信息需要恢复,则传递给您的 {@link |
| android.os.Bundle} |
| 是空值(如果是首次创建该 Activity,就会出现这种情况)。</p> |
| |
| <img src="{@docRoot}images/fundamentals/restore_instance.png" alt="" /> |
| <p class="img-caption"><strong>图 2. </strong>在两种情况下,Activity 重获用户焦点时可保持状态完好:系统在销毁 Activity 后重建 Activity,Activity 必须恢复之前保存的状态;系统停止 Activity 后继续执行 Activity,并且 Activity 状态保持完好。 |
| |
| |
| </p> |
| |
| <p class="note"><strong>注:</strong>无法保证系统会在销毁您的 Activity 前调用 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()},因为存在不需要保存状态的情况(例如用户使用“返回” |
| <em></em> |
| 按钮离开您的 Activity 时,因为用户的行为是在显式关闭 Activity)。 |
| |
| 如果系统调用 {@link android.app.Activity#onSaveInstanceState |
| onSaveInstanceState()},它会在调用 {@link |
| android.app.Activity#onStop onStop()} 之前,并且可能会在调用 {@link android.app.Activity#onPause |
| onPause()} 之前进行调用。</p> |
| |
| <p>不过,即使您什么都不做,也不实现 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()},{@link android.app.Activity} |
| 类的 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()} 默认实现也会恢复部分 Activity 状态。具体地讲,默认实现会为布局中的每个 |
| {@link |
| android.view.View} 调用相应的 {@link |
| android.view.View#onSaveInstanceState onSaveInstanceState()} |
| 方法,让每个视图都能提供有关自身的应保存信息。Android |
| 框架中几乎每个小工具都会根据需要实现此方法,以便在重建 Activity 时自动保存和恢复对 UI |
| 所做的任何可见更改。例如,{@link android.widget.EditText} |
| 小工具保存用户输入的任何文本,{@link android.widget.CheckBox} |
| 小工具保存复选框的选中或未选中状态。您只需为想要保存其状态的每个小工具提供一个唯一的 ID(通过 <a href="{@docRoot}guide/topics/resources/layout-resource.html#idvalue">{@code android:id}</a> |
| 属性)。如果小工具没有 ID,则系统无法保存其状态。 |
| </p> |
| |
| <div class="sidebox-wrapper"> |
| <div class="sidebox"> |
| <p>您还可以通过将 |
| {@link android.R.attr#saveEnabled android:saveEnabled} 属性设置为 {@code "false"} 或通过调用 {@link android.view.View#setSaveEnabled setSaveEnabled()} |
| 方法显式阻止布局内的视图保存其状态。您通常不应将该属性禁用,但如果您想以不同方式恢复 Activity UI |
| 的状态,就可能需要这样做。</p> |
| </div> |
| </div> |
| |
| <p>尽管 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()} |
| 的默认实现会保存有关您的Activity UI |
| 的有用信息,您可能仍需替代它以保存更多信息。例如,您可能需要保存在 Activity 生命周期内发生了变化的成员值(它们可能与 |
| UI 中恢复的值有关联,但默认情况下系统不会恢复储存这些 UI |
| 值的成员)。</p> |
| |
| <p>由于 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()} 的默认实现有助于保存 UI 的状态, |
| 因此如果您为了保存更多状态信息而重写该方法,应始终先调用 |
| {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} |
| 的超类实现,然后再执行任何操作。同样,如果您替代 {@link |
| android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} |
| 方法,也应调用它的超类实现,以便默认实现能够恢复视图状态。</p> |
| |
| <p class="note"><strong>注:</strong>由于无法保证系统会调用 |
| {@link android.app.Activity#onSaveInstanceState |
| onSaveInstanceState()},因此您只应利用它来记录 Activity 的瞬态(UI |
| 的状态)—切勿使用它来存储持久性数据,而应使用 {@link |
| android.app.Activity#onPause onPause()} |
| 在用户离开 Activity 后存储持久性数据(例如应保存到数据库的数据)。</p> |
| |
| <p>您只需旋转设备,让屏幕方向发生变化,就能有效地测试您的应用的状态恢复能力。 |
| 当屏幕方向变化时,系统会销毁并重建 Activity,以便应用可供新屏幕配置使用的备用资源。 |
| |
| 单凭这一理由,您的 Activity 在重建时能否完全恢复其状态就显得非常重要,因为用户在使用应用时经常需要旋转屏幕。 |
| |
| </p> |
| |
| |
| <h3 id="ConfigurationChanges">处理配置变更</h3> |
| |
| <p>有些设备配置可能会在运行时发生变化(例如屏幕方向、键盘可用性及语言)。 |
| 发生此类变化时,Android 会重建运行中的 Activity(系统调用 |
| {@link android.app.Activity#onDestroy},然后立即调用 {@link |
| android.app.Activity#onCreate onCreate()})。此行为旨在通过利用您提供的备用资源(例如适用于不同屏幕方向和屏幕尺寸的不同布局)自动重新加载您的应用来帮助它适应新配置。 |
| |
| |
| </p> |
| |
| <p>如果您对 Activity 进行了适当设计,让它能够按以上所述处理屏幕方向变化带来的重启并恢复 Activity 状态,那么在遭遇 Activity 生命周期中的其他意外事件时,您的应用将具有更强的适应性。 |
| |
| </p> |
| |
| <p>正如上文所述,处理此类重启的最佳方法 |
| 是利用 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()} 和 {@link |
| android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}(或 {@link |
| android.app.Activity#onCreate onCreate()})保存并恢复 Activity 的状态。</p> |
| |
| <p>如需了解有关运行时发生的配置变更以及应对方法的详细信息,请阅读<a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时变更</a>指南。 |
| |
| </p> |
| |
| |
| |
| <h3 id="CoordinatingActivities">协调 Activity</h3> |
| |
| <p>当一个 Activity 启动另一个 Activity 时,它们都会体验到生命周期转变。第一个 Activity 暂停并停止(但如果它在后台仍然可见,则不会停止)时,系统会创建另一个 Activity。 |
| |
| 如果这些 Activity 共用保存到磁盘或其他地方的数据,必须了解的是,在创建第二个 Activity 前,第一个 Activity 不会完全停止。更确切地说,启动第二个 Activity 的过程与停止第一个 Activity 的过程存在重叠。 |
| |
| |
| </p> |
| |
| <p>生命周期回调的顺序经过明确定义,当两个 Activity 位于同一进程,并且由一个 Activity 启动另一个 Activity 时,其定义尤其明确。 |
| 以下是当 Activity A |
| 启动 Activity B 时一系列操作的发生顺序: </p> |
| |
| <ol> |
| <li>Activity A 的 {@link android.app.Activity#onPause onPause()} 方法执行。</li> |
| |
| <li>Activity B 的 {@link android.app.Activity#onCreate onCreate()}、{@link |
| android.app.Activity#onStart onStart()} 和 {@link android.app.Activity#onResume onResume()} |
| 方法依次执行。(Activity B 现在具有用户焦点。)</li> |
| |
| <li>然后,如果 Activity A 在屏幕上不再可见,则其 {@link |
| android.app.Activity#onStop onStop()} 方法执行。</li> |
| </ol> |
| |
| <p>您可以利用这种可预测的生命周期回调顺序管理从一个 Activity 到另一个 Activity 的信息转变。 |
| 例如,如果您必须在第一个 Activity 停止时向数据库写入数据,以便下一个 Activity 能够读取该数据,则应在 |
| {@link android.app.Activity#onPause onPause()} |
| 而不是 {@link |
| android.app.Activity#onStop onStop()} 执行期间向数据库写入数据。</p> |
| |
| <!-- |
| <h2>Beginner's Path</h2> |
| |
| <p>For more information about how Android maintains a history of activities and |
| enables user multitasking, continue with the <b><a |
| href="{@docRoot}guide/components/tasks-and-back-stack.html">Tasks and Back |
| Stack</a></b> document.</p> |
| --> |