1page.title=重新创建Activity
2page.tags=Activity生命周期
3helpoutsWidget=true
4
5trainingnavtop=true
6
7@jd:body
8
9<div id="tb-wrapper">
10  <div id="tb">
11
12    <h2>本课程将向您展示如何</h2>
13    <ol>
14      <li><a href="#SaveState">保存Activity状态</a></li>
15      <li><a href="#RestoreState">恢复Activity状态</a></li>
16    </ol>
17
18    <h2>您还应阅读</h2>
19    <ul>
20      <li><a href="{@docRoot}training/basics/supporting-devices/screens.html">支持不同屏幕</a>
21</li>
22      <li><a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时更改</a></li>
23      <li><a href="{@docRoot}guide/components/activities.html">Activity</a>
24      </li>
25    </ul>
26
27  </div>
28</div>
29
30<p>在有些情况下，您的Activity会因正常应用行为而销毁，比如当用户按 <em>返回</em>按钮或您的Activity通过调用
31 {@link android.app.Activity#finish()}示意自己的销毁。
32如果Activity当前被停止或长期未使用，或者前台Activity需要更多资源以致系统必须关闭后台进程恢复内存，系统也可能会销毁Activity。
33
34</p>
35
36<p>当您的Activity因用户按了<em>返回</em> 或Activity自行完成而被销毁时，系统的 {@link android.app.Activity} 实例概念将永久消失，因为行为指示不再需要Activity。
37
38但是，如果系统因系统局限性（而非正常应用行为）而销毁Activity，尽管
39{@link android.app.Activity} 实际实例已不在，系统会记住其存在，这样，如果用户导航回实例，系统会使用描述Activity被销毁时状态的一组已保存数据创建Activity的新实例。
40
41
42系统用于恢复先前状态的已保存数据被称为“实例状态”，并且是
43 {@link android.os.Bundle} 对象中存储的键值对集合。
44</p>
45
46<p class="caution"><strong>注意：</strong>每次用户旋转屏幕时，您的Activity将被销毁并重新创建。
47当屏幕方向变化时，系统会销毁并重新创建前台Activity，因为屏幕配置已更改并且您的Activity可能需要加载备用资源（比如布局）。
48
49</p>
50
51<p>默认情况下，系统会使用 {@link android.os.Bundle} 实例状态保存您的Activity布局（比如，输入到 {@link android.widget.EditText} 对象中的文本值）中有关每个 {@link android.view.View} 对象的信息。
52
53这样，如果您的Activity实例被销毁并重新创建，布局状态便恢复为其先前的状态，且您无需代码。
54
55但是，您的Activity可能具有您要恢复的更多状态信息，比如跟踪用户在Activity中进度的成员变量。
56
57</p>
58
59<p class="note"><strong>注意：</strong>为了 Android 系统恢复Activity中视图的状态，<strong>每个视图必须具有</strong>
60<a href="{@docRoot}reference/android/view/View.html#attr_android:id">{@code
61android:id}</a> 属性提供的唯一 ID。
62</p>
63
64<p>要保存有关Activity状态的其他数据，您必须替代
65 {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} 回调方法。当用户要离开Activity并在Activity意外销毁时向其传递将保存的 {@link android.os.Bundle} 对象时，系统会调用此方法。
66
67
68如果系统必须稍后重新创建Activity实例，它会将相同的 {@link
69android.os.Bundle} 对象同时传递给 {@link android.app.Activity#onRestoreInstanceState
70onRestoreInstanceState()} 和 {@link android.app.Activity#onCreate onCreate()}
71方法。
72</p>
73
74<img src="{@docRoot}images/training/basics/basic-lifecycle-savestate.png" />
75<p class="img-caption"><strong>图 2.</strong>当系统开始停止您的Activity时，它会
76调用 {@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)。
77
78
79
80
81
82</p>
83
84
85
86<h2 id="SaveState">保存Activity状态</h2>
87
88<p>当您的Activity开始停止时，系统会调用 {@link android.app.Activity#onSaveInstanceState
89onSaveInstanceState()} 以便您的Activity可以保存带有键值对集合的状态信息。
90此方法的默认实现保存有关Activity视图层次的状态信息，例如 {@link android.widget.EditText} 小工具中的文本或{@link android.widget.ListView} 的滚动位置。
91
92</p>
93
94<p>要保存Activity的更多状态信息，您必须实现 {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} 并将键值对添加至 {@link android.os.Bundle} 对象。
95
96例如：</p>
97
98<pre>
99static final String STATE_SCORE = "playerScore";
100static final String STATE_LEVEL = "playerLevel";
101...
102
103&#64;Override
104public void onSaveInstanceState(Bundle savedInstanceState) {
105    // Save the user's current game state
106    savedInstanceState.putInt(STATE_SCORE, mCurrentScore);
107    savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel);
108
109    // Always call the superclass so it can save the view hierarchy state
110    super.onSaveInstanceState(savedInstanceState);
111}
112</pre>
113
114<p class="caution"><strong>注意：</strong>始终调用 {@link
115android.app.Activity#onSaveInstanceState onSaveInstanceState()} 的超类实现，以便默认实现可以保存视图层次的状态。
116</p>
117
118
119
120<h2 id="RestoreState">恢复Activity状态</h2>
121
122<p>当您的Activity在先前销毁之后重新创建时，您可以从系统向Activity传递的
123{@link android.os.Bundle}
124恢复已保存的状态。{@link android.app.Activity#onCreate onCreate()} 和 {@link
125android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} 回调方法均接收包含实例状态信息的相同 {@link android.os.Bundle}。
126</p>
127
128<p>因为无论系统正在创建Activity的新实例还是重新创建先前的实例，都会调用 {@link android.app.Activity#onCreate onCreate()} 方法，因此您必须在尝试读取它之前检查状态 {@link android.os.Bundle} 是否为 null。
129
130如果为 null，则系统将创建Activity的新实例，而不是恢复已销毁的先前实例。
131
132</p>
133
134<p>例如，此处显示您如何可以在 {@link android.app.Activity#onCreate
135onCreate()} 中恢复一些状态数据：</p>
136
137<pre>
138&#64;Override
139protected void onCreate(Bundle savedInstanceState) {
140    super.onCreate(savedInstanceState); // Always call the superclass first
141
142    // Check whether we're recreating a previously destroyed instance
143    if (savedInstanceState != null) {
144        // Restore value of members from saved state
145        mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
146        mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
147    } else {
148        // Probably initialize members with default values for a new instance
149    }
150    ...
151}
152</pre>
153
154<p>您可以选择实现系统在 {@link android.app.Activity#onStart()} 方法之后调用的 {@link
155android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} ，而不是在{@link android.app.Activity#onCreate onCreate()} 期间恢复状态。
156
157系统只在存在要恢复的已保存状态时调用 {@link
158android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}
159，因此您无需检查 {@link android.os.Bundle} 是否为 null：</p>
160
161<pre>
162public void onRestoreInstanceState(Bundle savedInstanceState) {
163    // Always call the superclass so it can restore the view hierarchy
164    super.onRestoreInstanceState(savedInstanceState);
165
166    // Restore state members from saved instance
167    mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
168    mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
169}
170</pre>
171
172<p class="caution"><strong>注意：</strong>始终调用 {@link
173android.app.Activity#onSaveInstanceState onSaveInstanceState()} 的超类实现，以便默认实现可以恢复视图层次的状态。
174</p>
175
176<p>要了解更多有关因运行时重启事件（例如屏幕旋转时）而重新创建Activity的信息，请阅读<a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时更改</a>。
177</p>
178
179