发现当前Android的资料不是很多,而且对于Activity的介绍也很少,所以把官方文档的android.app.Activity的介绍翻译了一下,加入了一些自己的理解。各位如果觉得我自己理解的不对,请无视。欢迎邮件讨论。
android.app
public class
java.lang.Object
android.content.Context
android.app.ApplicationContext ViewInflate.Factory
android.app.Activity KeyEvent.Callback Window.Callback
Activity 是用户唯一可以看得到的东西。几乎所有的activity都与用户进行交互,所以Activity主要负责的就是创建显示窗口,你可以在这些窗口里使用setContentView(View)来显示你自己的UI。activity展现在用户面前的经常是全屏窗口,你也可以将activity作为浮动窗口来使用(使用设置了windowIsFloating的主题),或者嵌入到其他的activity(使用ActivityGroup)中。下面是两个几乎所有Activity的子类都实现了的方法。
如果要使用 Context.startActivity()来启动activity, activity都必须在启动者应用包的AndroidManifest.xml
文件中
有对应的
Activity类是 application's overall lifecycle 的一个重要部分。
这里涉及到的主题:
系统中的Activity可以通过一个activity栈来进行管理。当一个新的activity启动的时候,它首先会被放置在activity栈顶部并成为running状态的activity —— 之前的activity也在activity栈中,但总是被保存在它的下边,只有当这个新的activity退出以后之前的activity才能重新回到前景界面。
所有的activity本质上有四种状态:
下面的图表是Activity的状态图,直角矩形代表了callback方法,你可以实现这些方法从而使Activity在改变状态的时候执行你制定的操作。带颜色的椭圆形是Activity的主要状态。
这里有三个比较关键的生命周期。
下面的Activity方法定义了activity完整的生命周期。他们全都是hook方法,你可以重载这些方法从而使activity在状态改变时执行你所期望的操作。所有activity都应该实现自己的onCreate(Bundle)方法来进行初始化设置;大部分还应该实现onPause()方法提交数据的修改并且准备终止与用户的交互。尽管我们计划在系统中添加更多的工具来管理应用,现在大多activity仍需要实现onFreeze()并且在onCreate(Bundle)中执行对应的状态恢复。其他的方法可以在需要时进行实现,当实现这些方法的时候需要注意的是一定要调用父类中的对应方法。
public class Activity extends ApplicationContext {
protected void onCreate(Bundle icicle);
protected void onStart();
protected void onRestart();
protected void onResume();
protected void onFreeze(Bundle outIcicle);
protected void onPause();
protected void onStop();
protected void onDestroy();
}
一般来说activity的生命周期变化看起来比较象下面的表格:
(此处译者进行了大块的修改,请参考原文阅读下面表格)
方法 |
描述 |
Killable? |
下一方法 |
||
onCreate() |
Activity初次创建时被调用,你应该在这里进行一般的静态设置:创建view、将数据绑定到list等等。如果activity之前存在冻结状态,那么此状态将在Bundle中提供。 如果activity首次创建,本方法后将会调用onStart(),如果activity是停止后重新显示,则将调用onRestart()。 |
No |
|
||
|
onStart() |
当activity对用户即将可见的时候调用。 其后调用onRestart()或onResume()(框架是否进行选择性调用onResume()仅仅是猜测) |
No |
|
|
onRestart() |
当activity从停止状态重新启动时调用。其后调用onResume()。 |
No |
|
||
|
onResume() |
当activity将要与用户交互时调用此方法,此时activity在activity栈的栈顶,用户输入已经可以传递给它。 如果其他的activity在它的上方恢复显示,则将调用onFreeze()。 |
No |
|
|
onFreeze() |
当你的activity被暂停而其他的activity恢复与用户交互的时候这个方法会被调用(在其他activity显示之前),你可以使用这个方法保存你当前的用户状态(一般来说是当前实例的用户状态)。暂停之后,为了回收资源供给前景activity,系统会在需要的时间停止(或者kill)你的应用。以后如果你的activity启动一个新的实例重新与用户进行交互,你保存在这里的状态都将通过onCreate()方法传递给新的实例。 其后总是调用onPause()方法。 |
No |
|
||
onPause() |
当系统要启动一个其他的activity时调用(其他的activity显示之前),这个方法被用来提交那些持久数据的改变、停止动画、和其他占用CPU资源的东西。由于下一个activity在这个方法返回之前不会resumed,所以实现这个方法时代码执行要尽可能快。 如果activity重新回到前景时将调用onResume(), 如果对用户彻底不可见则会调用onStop()。 |
Yes |
|
||
onStop() |
当另外一个activity恢复并遮盖住此activity,导致其对用户不再可见时调用。一个新activity启动、其它activity被切换至前景、当前activity被销毁时都会发生这种场景。 当activity重新回到前景与用户交互时调用onRestart(),如果activity将退出则调用onDestory()。 |
Yes |
|
||
onDestroy() |
在你的activity被销毁前所调用的最后一个方法,当进程终止时会出现这种情况(对activity直接调用finish()方法或者系统为了节省空间而临时销毁此activity的实例,你可以通过isFinishing()的返回值来区分这两种情况)。 |
Yes |
nothing |
①: 这个表格本人觉得还有些值得商榷的地方,建议作为参考阅读,不管是原文还是译文。
注意上表中“Killable”这一列 —— 对于那些标记killable的方法,当这些方法结束后,activity的进程可能在任何时间被系统kill而不再执行activity中的任何代码。因此你应该利用onFreeze()(保存你当前UI的状态)和onPause()(将所有的修改写回持久存储),这样activity才能在被kill的时候正确的保存当前的状态。如果需要了解一个进程的生命周期与他所执行的activity之间的关系 参见进程生命周期 部分。
对于那些标记killable的方法,从这些方法启动开始直到返回之前,activity的进程都不回被系统kill。举个例子,一个activity在onPause()方法返回后处于killable的状态,这种状态会一直持续到onResume()方法开始执行。
如果设备的配置(在Resources.Configuration中进行了定义)发生改变,那么所有用户界面上的东西都需要进行更新,以适应新的配置。因为Activity是与用户交互的最主要的机制,它包含了处理配置改变的专门支持。
除非你特殊指定,否则当配置发生改变(比如屏幕方向、语言、输入设备等等的改变)时你当前的activity都将被销毁,这销毁是通过一个正常的activity生命周期过程(onFreeze(Bundle),onPause(), onStop(), 和 onDestroy())进行的。如果activity之前正在前景画面,当这个实例的onDestroy()调用完成后将会启动这个activity的一个新的实例,并将前面那个实例中onFreeze(Bundle)所保存的内容传递给新的实例。
因为任何的应用资源(包括layout文件)都有可能由于任何配置值而改变。因此处理配置改变的唯一安全的方法就是重新获取所有的资源,包括layout、绘图资源(原文drawables)、字符串资源。由于activity已经如何保存自己的状态并从这些状态中重建自身,所以activity重新启动自身来获得新的配置将是一个非常便利的途径。
在一些特殊的情况中,你可能希望当一种或者多种配置改变时避免重新启动你的activity。你可以通过在manifest中设置android:configChanges属性来实现这点。你可以在这里声明activity可以处理的任何配置改变,当这些配置改变时不会重新启动activity,而会调用activity的onConfigurationChanged(Resources.Configuration)方法。如果改变的配置中包含了你所无法处理的配置(在android:configChanges并未声明),你的activity仍然要被重新启动,而onConfigurationChanged(Resources.Configuration)将不会被调用。
startActivity(Intent)方法可以用来启动一个新的activity,这个activity将被放置在activity栈的栈顶。这个方法只有一个参数Intent,这个参数描述了将被执行的activity。
有时候你希望在一个activity结束时得到它返回的结果。举个例子,你可能启动一个activity来让用户从通讯簿中选择一个人;当它结束的时候将会返回这个所选择的人。为了得到这个返回的信息,你可以使用startSubActivity(Intent, int)这个方法来启动新的activity,第二个整形参数将会作为这次调用的识别标记。这个activity返回的结果你可以通过onActivityResult(int, int, String, Bundle)方法来获得,此方法的第一个参数就是之前调用所使用的识别标记。
当activity退出的时候,它可以调用setResult(int)来将数据返回给他的父进程。这个方法必须提供一个结果码,这个结果码可以使标准结果RESULT_CANCELED, RESULT_OK,也可以是其他任何从RESULT_FIRST_USER开始的自定义值。此外,它还可以返回一段字符串(经常是一段数据的URL地址),一个包含它所有希望值的Bundle。这些信息都会在父activity的回调函数Activity.onActivityResult()
中出现,并连同最初提供的识别标记一起(此处有些拗口,意思其实就是子activity返回的内容、返回码、识别标记都将作为参数,按照不同的返回情况来调用父activity的Activity.onActivityResult()方法,以实现出现各种返回时父activity做出响应的处理)。
如果子activity由于某种情况发生失败(例如crashing),父activity将会收到RESULT_CANCELED结果码。
这里是一个例子,说明了如何启动一个新的activity并处理结果。
public class MyActivity extends Activity {
...
static final int PICK_CONTACT_REQUEST = 0;
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) {
// When the user center presses, let them pick a contact.
startSubActivity(
new Intent(Intent.PICK_ACTION,
Uri.parse("content://contacts")),
PICK_CONTACT_REQUEST);
return true;
}
return false;
}
protected void onActivityResult(int requestCode, int resultCode,
String data, Bundle extras) {
if (requestCode == PICK_CONTACT_REQUEST) {
if (resultCode == RESULT_OK) {
// A contact was picked. Here we will just display it
// to the user.
startActivity(new Intent(Intent.VIEW_ACTION,
Uri.parse(data)));
}
}
}
}
当一个按键被按下时onKeyDown()启动一个新的activity。当新的activity结束后onActivityResult()会被调用。
一般来说有两类持久状态需要activity来处理:类似于文档的共享数据(一般使用content provider存储在SQLite数据库中)和就像用户参数设定一样的内部状态。
对于content provider的数据,我们建议activity使用“编辑即发生”用户模型。就是说,用户所做的任何编辑都将立即生效而不要求任何进一步的确认。下面两条规则可以使支持这种模型成为一件简单的事情。
这个模型是为了避免用户在activity之间切换时数据丢失而设计的,同时允许系统在activity处于paused状态后任何时间都可以安全的kill这个activity(因为其它地方可能需要系统资源)。注意这隐含着一个含义,即用户点击你activity的BACK键并不意味着“取消”——它意味着保存他当前的内容并离开你的activity。Activity中取消编辑必须通过其他机制来提供,例如显式的提供"revert"或 "undo"选项。
如果需要了解更多关于content providers的信息,参见content package。这是不同的activity之间如何调用和彼此之间传递数据的关键。
Activity同时提供了API来管理与activity相关联的内部持久状态。这可以用来记忆用户日历的首选初始显示(日期视图或者周视图)或者用户web浏览器的缺省主页这类信息。
Activity持久状态使用getPreferences(int)方法来管理,允许你取得和修改一系列与activity相关联的名称/取值对。如果要在应用的多个组件(activities,recivers,services,providers)之间共享参数,你可以使用底层方法Context.getSharedPreferences()来获得存储在一个特定名称下的参数对象。(注意:在application packages之间不能共享设置数据 —— 如果要这么做的话你需要使用content provider)。
这里摘录了一段日历activity中的代码,用来在永久设定中保存用户首选的视图模式。
public class CalendarActivity extends Activity {
...
static final int DAY_VIEW_MODE = 0;
static final int WEEK_VIEW_MODE = 1;
private SharedPreferences mPrefs;
private int mCurViewMode;
protected void onCreate(Bundle icicle) {
super.onCreate(icicle);
SharedPreferences mPrefs = getSharedPreferences();
mCurViewMode = mPrefs.getInt("view_mode" DAY_VIEW_MODE);
}
protected void onPause() {
super.onPause();
SharedPreferences.Editor ed = mPrefs.edit();
ed.putInt("view_mode", mCurViewMode);
ed.commit();
}
}
你可以通过在Activity所属应用的manifest文件中对应的
如果需要了解更多有关于一般安全机制和许可方面的信息可以参考Security Model。
Android系统会尽量久的保留应用进程。但是当内存降低时最终还是要移除旧的进程。就像Activity 生命周期 中描述的一样,移除哪个进程还是要取决于关联的用户与之交互的程度。一般来说,进程可以基于其中运行的activity所处的生命周期而分成四种状态,下面将这些状态根据重要程度排列。系统会在kill更重要的进程(第一个)之前首先kill那些不那么重要的进程(最后一个)。
1. 前景activity(处于屏幕最上方,用户与之交互的activity)被认为是最重要的。如果设备上的内存无法满足它的使用,Kill此进程只能作为最后的手段。一般来说这个时候设备处于内存paging状态,为了使用户界面保持响应才会发出这个kill请求。
2. 可见activity(一个对用户可见,但是不在前景的activity,比如处在浮动对话框后)被认为是非常重要的,除非为了保证前景activity运行,否则不会被kill。
3. 后台activity(一个对用户不可见,并处于paused状态的activity)就不再重要了,所以当需要为其它前景的或者可见的activity运行而回收内存时系统可以很安全的kill它们。
4. 空进程是一个没有运行activity或者其他应用组件(比如Service或者IntentReceiver类)的进程。当内存开始降低时系统很快就会kill掉这些进程。因此当你要在activity外运行任何的后台操作时,必须在IntentReceiver或Service的上下文环境中运行,这样系统才知道需要将你的进程保留而不是kill。
有些时候Activity可能需要长时间运行一个操作,且它并不依赖于activity的生命周期而存在。例如一个照相机应用可能允许你将照片上传到web站点。上传可能需要很长时间,在上传过程中应该允许用户离开这个应用。为了做到这一点,你的activity应该在上传时启动一个Service来执行此工作。这将使系统在你的进程上传数据的过程中能够恰当的区分它的优先级(认为此进程比其他不可见应用更重要),不管原来的activity的状态是paused、stopped还是finished。