1page.title=开始Activity
2page.tags=Activity生命周期
3helpoutsWidget=true
4
5trainingnavtop=true
6
7@jd:body
8
9
10<div id="tb-wrapper">
11  <div id="tb">
12
13    <h2>本课程将向您展示如何</h2>
14<ol>
15  <li><a href="#lifecycle-states">了解生命周期回调</a></li>
16  <li><a href="#launching-activity">指定您的应用的启动器Activity</a></li>
17  <li><a href="#Create">创建一个新实例</a></li>
18  <li><a href="#Destroy">销毁Activity</a></li>
19</ol>
20
21    <h2>您还应阅读</h2>
22    <ul>
23      <li><a href="{@docRoot}guide/components/activities.html">Activity</a></li>
24    </ul>
25
26<h2>试一试</h2>
27
28<div class="download-box">
29 <a href="http://developer.android.com/shareables/training/ActivityLifecycle.zip" class="button">下载演示</a>
30 <p class="filename">ActivityLifecycle.zip</p>
31</div>
32
33  </div>
34</div>
35
36<p>不同于使用 {@code main()} 方法启动应用的其他编程范例，Android 系统会通过调用对应于其生命周期中特定阶段的特定回调方法在 {@link android.app.Activity} 实例中启动代码。
37
38
39有一系列可启动Activity的回调方法，以及一系列可分解Activity的回调方法。
40</p>
41
42<p>本课程概述了最重要的生命周期方法，并向您展示如何处理创建Activity新实例的第一个生命周期回调。
43</p>
44
45
46
47<h2 id="lifecycle-states">了解生命周期回调</h2>
48
49<p>在Activity的生命周期中，系统会按类似于阶梯金字塔的顺序调用一组核心的生命周期方法。
50也就是说，Activity生命周期的每个阶段就是金字塔上的一阶。
51当系统创建新Activity实例时，每个回调方法会将Activity状态向顶端移动一阶。
52金字塔的顶端是Activity在前台运行并且用户可以与其交互的时间点。
53</p>
54
55<p>当用户开始离开Activity时，系统会调用其他方法在金字塔中将Activity状态下移，从而销毁Activity。
56在有些情况下，Activity将只在金字塔中部分下移并等待（比如，当用户切换到其他应用时），Activity可从该点开始移回顶端（如果用户返回到该Activity），并在用户停止的位置继续。
57
58
59</p>
60
61
62<img src="{@docRoot}images/training/basics/basic-lifecycle.png" />
63<p class="img-caption"><strong>图 1.</strong>简化的Activity生命周期图示，以阶梯金字塔表示。
64此图示显示，对于用于将Activity朝顶端的“继续”状态移动一阶的每个回调，有一种将Activity下移一阶的回调方法。
65
66Activity还可以从“暂停”和“停止”状态回到继续状态。
67</p>
68
69
70<p>根据Activity的复杂程度，您可能不需要实现所有生命周期方法。
71但是，了解每个方法并实现确保您的应用按照用户期望的方式运行的方法非常重要。
72正确实现您的Activity生命周期方法可确保您的应用按照以下几种方式良好运行，包括：
73</p>
74<ul>
75  <li>如果用户在使用您的应用时接听来电或切换到另一个应用，它不会崩溃。
76</li>
77  <li>在用户未主动使用它时不会消耗宝贵的系统资源。
78</li>
79  <li>如果用户离开您的应用并稍后返回，不会丢失用户的进度。
80</li>
81  <li>当屏幕在横向和纵向之间旋转时，不会崩溃或丢失用户的进度。
82</li>
83</ul>
84
85<!--
86<p class="table-caption"><strong>Table 1.</strong> Activity lifecycle state pairs and callback
87methods.</p>
88<table>
89  <tr>
90    <th scope="col">Lifecycle State</th>
91    <th scope="col">Startup Method</th>
92    <th scope="col">Teardown Method</th>
93  </tr>
94  <tr>
95    <td>Created / Destroyed</td>
96    <td>{@link android.app.Activity#onCreate onCreate()}</td>
97    <td>{@link android.app.Activity#onDestroy()}</td>
98  </tr>
99  <tr>
100    <td>Started / Stopped</td>
101    <td>{@link android.app.Activity#onStart()}</td>
102    <td>{@link android.app.Activity#onStop()}</td>
103  </tr>
104  <tr>
105    <td>Resumed / Resumed</td>
106    <td>{@link android.app.Activity#onResume()}</td>
107    <td>{@link android.app.Activity#onPause()}</td>
108  </tr>
109</table>
110-->
111
112<p>正如您将要在以下课程中要学习的，有Activity会在图 1 所示不同状态之间过渡的几种情况。
113但是，这些状态中只有三种可以是静态。
114也就是说，Activity只能在三种状态之一下存在很长时间。
115</p>
116<dl>
117  <dt>继续</dt>
118    <dd>在这种状态下，Activity处于前台，且用户可以与其交互。（有时也称为“运行”状态。）
119</dd>
120  <dt>暂停</dt>
121    <dd>在这种状态下，Activity被在前台中处于半透明状态或者未覆盖整个屏幕的另一个Activity&mdash;部分阻挡。
122暂停的Activity不会接收用户输入并且无法执行任何代码。
123
124  <dt>停止</dt>
125    <dd>在这种状态下，Activity被完全隐藏并且对用户不可见；它被视为处于后台。
126停止时，Activity实例及其诸如成员变量等所有状态信息将保留，但它无法执行任何代码。
127</dd>
128</dl>
129
130<p>其他状态（“创建”和“开始”）是瞬态，系统会通过调用下一个生命周期回调方法从这些状态快速移到下一个状态。
131也就是说，在系统调用
132{@link android.app.Activity#onCreate onCreate()} 之后，它会快速调用 {@link
133android.app.Activity#onStart()}，紧接着快速调用 {@link
134android.app.Activity#onResume()}。</p>
135
136<p>基本生命周期部分到此为止。现在，您将开始学习特定生命周期行为的一些知识。
137</p>
138
139
140
141<h2 id="launching-activity">指定您的应用的启动器Activity</h2>
142
143<p>当用户从主屏幕选择您的应用图标时，系统会为您已声明为“启动器”（ 或“主要”）Activity的应用中的 {@link android.app.Activity} 调用 {@link
144android.app.Activity#onCreate onCreate()} 方法。
145这是作为
146您的应用的用户界面主入口的Activity。</p>
147
148<p>您可以在 Android 宣示说明文件中 <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">{@code AndroidManifest.xml}</a> 定义哪个Activity用作主Activity，该说明文件位于您项目目录的根目录中。
149</p>
150
151<p>您的应用的主Activity必须使用 <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code
152&lt;intent-filter&gt;}</a>（包括 {@link
153android.content.Intent#ACTION_MAIN MAIN} 操作和
154{@link android.content.Intent#CATEGORY_LAUNCHER LAUNCHER} 类别）在宣示说明中声明。例如：</p>
155
156<pre>
157&lt;activity android:name=".MainActivity" android:label="&#64;string/app_name">
158    &lt;intent-filter>
159        &lt;action android:name="android.intent.action.MAIN" />
160        &lt;category android:name="android.intent.category.LAUNCHER" />
161    &lt;/intent-filter>
162&lt;/activity>
163</pre>
164
165<p class="note"><strong>注意：</strong>当您使用 Android SDK工具创建新 Android 项目时，默认的项目文件包括使用过滤器在宣示说明中声明的 {@link android.app.Activity} 类。
166
167</p>
168
169<p>如果未对您的Activity之一声明 {@link android.content.Intent#ACTION_MAIN MAIN} 操作或
170{@link android.content.Intent#CATEGORY_LAUNCHER LAUNCHER} 类别，那么您的应用图标将不会出现在应用的主屏幕列表中。
171</p>
172
173
174
175<h2 id="Create">创建一个新实例</h2>
176
177<p>大多数应用包含若干个不同的Activity，用户可通过这些Activity执行不同的操作。无论Activity是用户单击您的应用图标时创建的主Activity还是您的应用在响应用户操作时开始的其他Activity，系统都会通过调用其 {@link
178android.app.Activity#onCreate onCreate()} 方法创建 {@link android.app.Activity} 的每个新实例。
179
180
181</p>
182
183<p>您必须实现 {@link android.app.Activity#onCreate onCreate()} 方法执行只应在Activity整个生命周期出现一次的基本
184应用启动逻辑。例如，您的 {@link android.app.Activity#onCreate onCreate()} 的实现应定义用户界面并且可能实例化某些类范围变量。
185
186</p>
187
188<p>例如，{@link android.app.Activity#onCreate onCreate()}
189方法的以下示例显示执行Activity某些基本设置的一些代码，比如声明用户界面（在 XML 布局文件中定义）、定义成员变量，以及配置某些 UI。
190
191</p>
192
193<pre>
194TextView mTextView; // Member variable for text view in the layout
195
196&#64;Override
197public void onCreate(Bundle savedInstanceState) {
198    super.onCreate(savedInstanceState);
199
200    // Set the user interface layout for this Activity
201    // The layout file is defined in the project res/layout/main_activity.xml file
202    setContentView(R.layout.main_activity);
203
204    // Initialize member TextView so we can manipulate it later
205    mTextView = (TextView) findViewById(R.id.text_message);
206
207    // Make sure we're running on Honeycomb or higher to use ActionBar APIs
208    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
209        // For the main activity, make sure the app icon in the action bar
210        // does not behave as a button
211        ActionBar actionBar = getActionBar();
212        actionBar.setHomeButtonEnabled(false);
213    }
214}
215</pre>
216
217<p class="caution"><strong>注意：</strong>使用 {@link android.os.Build.VERSION#SDK_INT}
218可防止旧版系统以这种方式仅在 Android 2.0 （API 级别5）和更高级别执行新 API 工作。
219较旧版本会遇到运行时异常。</p>
220
221<p>一旦 {@link android.app.Activity#onCreate onCreate()} 完成执行操作，系统会相继调用 {@link android.app.Activity#onStart()} 和 {@link android.app.Activity#onResume()} 方法。
222
223您的Activity从不会驻留在“已创建”或“已开始”状态。在技术上，Activity会在 {@link android.app.Activity#onStart()} 被调用时变得可见，但紧接着是
224{@link android.app.Activity#onResume()}，且Activity保持“继续”状态，直到有事情发生使其发生变化，比如当接听来电时，用户导航至另一个Activity，或设备屏幕关闭。
225
226
227</p>
228
229<p>在接下来的其他课程中，您将看到其他Activity如何启动方法，当用于从“暂停”或“停止”状态继续Activity时，{@link
230android.app.Activity#onStart()} 和 {@link android.app.Activity#onResume()} 在您的Activity生命周期中特别有用。
231</p>
232
233<p class="note"><strong>注意：</strong>{@link android.app.Activity#onCreate onCreate()}
234方法包括一个称为 <code>savedInstanceState</code> 的参数，将在有关<a href="recreating.html">重新创建Activity</a>的后续课程中讨论该参数。
235</p>
236
237
238<img src="{@docRoot}images/training/basics/basic-lifecycle-create.png" />
239<p class="img-caption"><strong>图 2.</strong>Activity生命周期结构的另一个图示，其重点放在
240创建Activity的新实例时系统依次调用的三大回调上：{@link android.app.Activity#onCreate onCreate()}、{@link
241android.app.Activity#onStart()} 和 {@link android.app.Activity#onResume()}。
242一旦这一系列回调完成，Activity就进入“继续”状态，此时用户可与Activity进行交互，直至用户切换到其他Activity。
243
244</p>
245
246
247
248
249
250
251
252<h2 id="Destroy">销毁Activity</h2>
253
254<p>当Activity的第一个生命周期回调是 {@link android.app.Activity#onCreate
255onCreate()} 时，它最近的回调是 {@link android.app.Activity#onDestroy}。系统会对您的Activity调用此方法，作为您的Activity实例完全从系统内存删除的最终信号。
256
257</p>
258
259<p>大多数应用不需要实现此方法，因为本地类引用与Activity一同销毁，并且您的Activity应在 {@link
260android.app.Activity#onPause} 和 {@link android.app.Activity#onStop} 期间执行大多数清理操作。
261但是，如果您的Activity包含您在 {@link
262android.app.Activity#onCreate onCreate()} 期间创建的后台线程或其他如若未正确关闭可能导致内存泄露的长期运行资源，您应在  {@link
263android.app.Activity#onDestroy} 期间终止它们。
264
265</p>
266
267<pre>
268&#64;Override
269public void onDestroy() {
270    super.onDestroy();  // Always call the superclass
271
272    // Stop method tracing that the activity started during onCreate()
273    android.os.Debug.stopMethodTracing();
274}
275</pre>
276
277<p class="note"><strong>注意：</strong>在所有情况下，系统在调用 {@link android.app.Activity#onPause} 和 {@link
278android.app.Activity#onStop} 之后都会调用 {@link android.app.Activity#onDestroy}
279，只有一个例外：当您从 {@link android.app.Activity#onCreate onCreate()}
280 方法内调用 {@link
281android.app.Activity#finish()} 时。在有些情况下，比如当您的Activity作为临时决策工具运行以启动另一个Activity时，您可从 {@link
282android.app.Activity#onCreate onCreate()} 内调用 {@link android.app.Activity#finish()} 来销毁Activity。
283在这种情况下，系统会立刻调用 {@link android.app.Activity#onDestroy}，而不调用任何其他 生命周期方法。
284
285</p>
286