| page.title=重新创建Activity |
| page.tags=Activity生命周期 |
| helpoutsWidget=true |
| |
| trainingnavtop=true |
| |
| @jd:body |
| |
| <div id="tb-wrapper"> |
| <div id="tb"> |
| |
| <h2>本课程将向您展示如何</h2> |
| <ol> |
| <li><a href="#SaveState">保存Activity状态</a></li> |
| <li><a href="#RestoreState">恢复Activity状态</a></li> |
| </ol> |
| |
| <h2>您还应阅读</h2> |
| <ul> |
| <li><a href="{@docRoot}training/basics/supporting-devices/screens.html">支持不同屏幕</a> |
| </li> |
| <li><a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时更改</a></li> |
| <li><a href="{@docRoot}guide/components/activities.html">Activity</a> |
| </li> |
| </ul> |
| |
| </div> |
| </div> |
| |
| <p>在有些情况下,您的Activity会因正常应用行为而销毁,比如当用户按 <em>返回</em>按钮或您的Activity通过调用 |
| {@link android.app.Activity#finish()}示意自己的销毁。 |
| 如果Activity当前被停止或长期未使用,或者前台Activity需要更多资源以致系统必须关闭后台进程恢复内存,系统也可能会销毁Activity。 |
| |
| </p> |
| |
| <p>当您的Activity因用户按了<em>返回</em> 或Activity自行完成而被销毁时,系统的 {@link android.app.Activity} 实例概念将永久消失,因为行为指示不再需要Activity。 |
| |
| 但是,如果系统因系统局限性(而非正常应用行为)而销毁Activity,尽管 |
| {@link android.app.Activity} 实际实例已不在,系统会记住其存在,这样,如果用户导航回实例,系统会使用描述Activity被销毁时状态的一组已保存数据创建Activity的新实例。 |
| |
| |
| 系统用于恢复先前状态的已保存数据被称为“实例状态”,并且是 |
| {@link android.os.Bundle} 对象中存储的键值对集合。 |
| </p> |
| |
| <p class="caution"><strong>注意:</strong>每次用户旋转屏幕时,您的Activity将被销毁并重新创建。 |
| 当屏幕方向变化时,系统会销毁并重新创建前台Activity,因为屏幕配置已更改并且您的Activity可能需要加载备用资源(比如布局)。 |
| |
| </p> |
| |
| <p>默认情况下,系统会使用 {@link android.os.Bundle} 实例状态保存您的Activity布局(比如,输入到 {@link android.widget.EditText} 对象中的文本值)中有关每个 {@link android.view.View} 对象的信息。 |
| |
| 这样,如果您的Activity实例被销毁并重新创建,布局状态便恢复为其先前的状态,且您无需代码。 |
| |
| 但是,您的Activity可能具有您要恢复的更多状态信息,比如跟踪用户在Activity中进度的成员变量。 |
| |
| </p> |
| |
| <p class="note"><strong>注意:</strong>为了 Android 系统恢复Activity中视图的状态,<strong>每个视图必须具有</strong> |
| <a href="{@docRoot}reference/android/view/View.html#attr_android:id">{@code |
| android:id}</a> 属性提供的唯一 ID。 |
| </p> |
| |
| <p>要保存有关Activity状态的其他数据,您必须替代 |
| {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} 回调方法。当用户要离开Activity并在Activity意外销毁时向其传递将保存的 {@link android.os.Bundle} 对象时,系统会调用此方法。 |
| |
| |
| 如果系统必须稍后重新创建Activity实例,它会将相同的 {@link |
| android.os.Bundle} 对象同时传递给 {@link android.app.Activity#onRestoreInstanceState |
| onRestoreInstanceState()} 和 {@link android.app.Activity#onCreate onCreate()} |
| 方法。 |
| </p> |
| |
| <img src="{@docRoot}images/training/basics/basic-lifecycle-savestate.png" /> |
| <p class="img-caption"><strong>图 2.</strong>当系统开始停止您的Activity时,它会 |
| 调用 {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} (1),因此,您可以指定您希望在 {@link android.app.Activity} 实例必须重新创建时保存的额外状态数据。如果Activity被销毁且必须重新创建相同的实例,系统将在 (1) 中定义的状态数据同时传递给 {@link android.app.Activity#onCreate onCreate()} 方法(2) 和 {@link android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} 方法(3)。 |
| |
| |
| |
| |
| |
| </p> |
| |
| |
| |
| <h2 id="SaveState">保存Activity状态</h2> |
| |
| <p>当您的Activity开始停止时,系统会调用 {@link android.app.Activity#onSaveInstanceState |
| onSaveInstanceState()} 以便您的Activity可以保存带有键值对集合的状态信息。 |
| 此方法的默认实现保存有关Activity视图层次的状态信息,例如 {@link android.widget.EditText} 小工具中的文本或{@link android.widget.ListView} 的滚动位置。 |
| |
| </p> |
| |
| <p>要保存Activity的更多状态信息,您必须实现 {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} 并将键值对添加至 {@link android.os.Bundle} 对象。 |
| |
| 例如:</p> |
| |
| <pre> |
| static final String STATE_SCORE = "playerScore"; |
| static final String STATE_LEVEL = "playerLevel"; |
| ... |
| |
| @Override |
| public void onSaveInstanceState(Bundle savedInstanceState) { |
| // Save the user's current game state |
| savedInstanceState.putInt(STATE_SCORE, mCurrentScore); |
| savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel); |
| |
| // Always call the superclass so it can save the view hierarchy state |
| super.onSaveInstanceState(savedInstanceState); |
| } |
| </pre> |
| |
| <p class="caution"><strong>注意:</strong>始终调用 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()} 的超类实现,以便默认实现可以保存视图层次的状态。 |
| </p> |
| |
| |
| |
| <h2 id="RestoreState">恢复Activity状态</h2> |
| |
| <p>当您的Activity在先前销毁之后重新创建时,您可以从系统向Activity传递的 |
| {@link android.os.Bundle} |
| 恢复已保存的状态。{@link android.app.Activity#onCreate onCreate()} 和 {@link |
| android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} 回调方法均接收包含实例状态信息的相同 {@link android.os.Bundle}。 |
| </p> |
| |
| <p>因为无论系统正在创建Activity的新实例还是重新创建先前的实例,都会调用 {@link android.app.Activity#onCreate onCreate()} 方法,因此您必须在尝试读取它之前检查状态 {@link android.os.Bundle} 是否为 null。 |
| |
| 如果为 null,则系统将创建Activity的新实例,而不是恢复已销毁的先前实例。 |
| |
| </p> |
| |
| <p>例如,此处显示您如何可以在 {@link android.app.Activity#onCreate |
| onCreate()} 中恢复一些状态数据:</p> |
| |
| <pre> |
| @Override |
| protected void onCreate(Bundle savedInstanceState) { |
| super.onCreate(savedInstanceState); // Always call the superclass first |
| |
| // Check whether we're recreating a previously destroyed instance |
| if (savedInstanceState != null) { |
| // Restore value of members from saved state |
| mCurrentScore = savedInstanceState.getInt(STATE_SCORE); |
| mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL); |
| } else { |
| // Probably initialize members with default values for a new instance |
| } |
| ... |
| } |
| </pre> |
| |
| <p>您可以选择实现系统在 {@link android.app.Activity#onStart()} 方法之后调用的 {@link |
| android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} ,而不是在{@link android.app.Activity#onCreate onCreate()} 期间恢复状态。 |
| |
| 系统只在存在要恢复的已保存状态时调用 {@link |
| android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} |
| ,因此您无需检查 {@link android.os.Bundle} 是否为 null:</p> |
| |
| <pre> |
| public void onRestoreInstanceState(Bundle savedInstanceState) { |
| // Always call the superclass so it can restore the view hierarchy |
| super.onRestoreInstanceState(savedInstanceState); |
| |
| // Restore state members from saved instance |
| mCurrentScore = savedInstanceState.getInt(STATE_SCORE); |
| mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL); |
| } |
| </pre> |
| |
| <p class="caution"><strong>注意:</strong>始终调用 {@link |
| android.app.Activity#onSaveInstanceState onSaveInstanceState()} 的超类实现,以便默认实现可以恢复视图层次的状态。 |
| </p> |
| |
| <p>要了解更多有关因运行时重启事件(例如屏幕旋转时)而重新创建Activity的信息,请阅读<a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时更改</a>。 |
| </p> |
| |