Activity

 创建一个Activity

onCreate()

onPause()

实现用户界面：

一个活动的用户界面由派生的层级视图对象从类提供。每个视图控制一个特定的矩形空间活动窗口内，可以响应用户的交互作用。例如，一个视图可能是启动一个行动当用户触摸一个按钮。

Android提供了一些现成的视图，你可以使用和组织你的布局设计。”小部件”的观点提供了一个可视化（互动）的界面元素，如按钮，文本字段，复选框，或只是一个形象。”布局”来自ViewGroup，提供其子视图的独特布局视图模型，如线性规划，网格布局，或相对布局。你也可以子类化View和ViewGroup类（或现有的子类）来创建自己的小部件和布局，并把它们应用到你的活动布局。

使用视图来定义一个布局最常用的方法是使用XML布局文件保存在您的应用程序的资源。这种方式，你可以保持你的用户界面的设计，分别从定义了活动的源代码的行为。你可以设置你的活动布局与setcontentview()界面，通过对布局的资源ID。然而，您还可以创建新的视图在活动代码和插入新视图ViewGroup层次建立一个视图，然后使用这种布局传递根ViewGroup到setcontentview()。

有关创建用户界面的信息，请参阅用户接口文档。

Declaring the activity in the manifest

你必须声明你的activity在manifest文件中以它是进入系统。声明你的activity，打开你的manifest文件并添加一个<活动>元素的<application>元素的子元素。比如：

<manifest ... >
  <application ... >
      <activity android:name=".ExampleActivity" />
      ...
  </application ... >
  ...
</manifest >

还有其他几个属性，你可以在这个元素，定义属性如标签活动，该活动的一个图标，或一个主题式活动的用户界面。安卓：name属性是唯一必需的属性指定的活动类的名称。一旦你发布你的应用，你不能改变这个名称，因为如果你这样做，你可能会破坏某些功能，如应用程序的快捷方式（阅读博客文章，不能改变的东西）。

看到关于在清单中声明你的活动的更多信息，参考> <活性元素。

Using intent filters

一个<活动>元素也可以指定不同的意图过滤器使用<意图过滤器>元为了说明其它的应用程序组件可以激活它。

当你创建一个使用Android SDK工具的新的应用程序，存根的活动，会自动为您创建包含意图过滤器声明活动响应“主要的”行为，应放在“发射”的范畴。intent过滤器看起来像这样：

<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>

<动作>元素指定这是应用程序的主入口点。<类别>元素指定此活动应在系统应用程序启动上市（允许用户启动这项活动）。

如果你打算要独立，不允许其他应用程序激活它的活动你的应用，那么你不需要任何其他的intent过滤器。只有一个活动应该有“主”作用和“发射”的范畴，如前面的例子。活动，你不想让其他的应用程序应该没有意图过滤器，你可以开始他们自己使用明确的意图（在下一节讨论）。

然而，如果你想你的活动响应的隐式意图是从其他应用程序（和你自己），那么你必须为你的活动定义额外的意图过滤器。对于每种类型的意图，你想回应，你必须包含一个意图过滤器>，<包括<动作>元和，任选地，一个<类别>元素和/或<数据>元。这些元素指定类型的意图，你的活动可以响应。

为更多的信息关于你的活动可以响应的意图，参考意图和意图过滤器文件。

Starting an Activity

你可以通过调用startactivity()启动另一个活动，它传递一个意图，描述你想启动的活动。目的指定确切的活动你想开始或描述你想执行的操作类型（和系统选择合适的活动给你，它甚至可以从一个不同的应用）。一个意图也可以进行少量的数据可以被启动的活动使用的。

当工作在您自己的应用程序，你需要经常地推出一个已知的活动。你可以通过创建一个意图，明确定义了你想启动的活动，使用类名称。例如，这里有一个活动启动另一个活动命名signinactivity：

Intent intent = new Intent(this, SignInActivity.class);
startActivity(intent);

然而，你的应用程序可能还需要执行一些动作，如发送电子邮件，文本消息，或状态更新，使用来自你的活动的数据。在这种情况下，你的应用程序可能没有执行该动作的活动，所以你可以不是利用设备上的其它应用程序提供的活动，它能为你执行的动作。这是哪里的意图是真正有价值的你可以创建一个意图，描述你想执行动作的系统从另一个应用程序启动适当的活动。如果有多个可以处理意图的活动，然后用户可以选择使用哪一个。例如，如果你想让用户发送电子邮件，您可以创建以下的意图：

Intent intent = new Intent(Intent.ACTION_SEND);
intent.putExtra(Intent.EXTRA_EMAIL, recipientArray);
startActivity(intent);

该extra_email额外添加到意图是一个字符串数组的邮件地址，发送电子邮件应。当一个电子邮件应用程序响应这个意图，它读取额外提供的字符串数组，并将它们放在“”的电子邮件表字段。在这种情况下，电子邮件应用程序的活动开始，当用户完成，你的活动恢复。

Starting an activity for a result

有时，你可能想从你开始活动得到的结果。在这种情况下，通过调用startactivityforresult()启动活动（而不是startactivity()）。然后接收来自后续活动的结果，实现onactivityresult()回调方法。当随后活动完成，它返回在意向你onactivityresult()方法的结果。

例如，你可能想让用户选择一个联系人，那么你的活动可以在接触信息做某事。这里是你如何可以创造这样的意图和处理结果：

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...
        }
    }
}

这个例子表明，你应该用你的onactivityresult()方法以处理活动的结果的基本逻辑。第一个条件检查请求是否成功，如果是，那么ResultCode将result_ok-and是否请求的响应结果是已知在这种情况下，requestCode匹配发送startactivityforresult()第二个参数。从那里，代码处理活动的结果通过查询数据的意图返回（数据参数）。

所发生的是，一个ContentResolver执行对内容提供商的查询，并返回一个指针，允许读取被查询的数据。有关更多信息，请参见内容提供者文档。

关于使用意图的更多信息，请参见意图和意图过滤器文件。

Shutting Down an Activity

你可以关闭一个活动通过调用它的finish()方法。你也可以关闭一个单独的活动，你以前开始通过调用finishactivity()。

注意：在大多数情况下，你不应该明确完成活动的使用这些方法。在下一节讨论关于活动的生命周期，Android系统为你管理一个活动的生命，所以你不需要完成自己的活动。调用这些方法可能产生不利影响的预期的用户体验，应该只用于当你绝对不希望用户返回到该活动实例的。

Managing the Activity Lifecycle

通过实现回调方法管理你的活动的生命周期是至关重要的发展一个强大的和灵活的应用。一个活动的生命周期是由直接影响与其关联的其他活动，其任务和后退堆栈。

一个活动可以在本质上存在着三种状态：

Resumed（重新开始）

活动是在屏幕的前景和用户焦点。（这个状态有时也被称为“run”。）

Paused

Stopped

Implementing the lifecycle callbacks（实施的生命周期回调）

public class ExampleActivity extends Activity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // The activity is being created.
    }
    @Override
    protected void onStart() {
        super.onStart();
        // The activity is about to become visible.
    }
    @Override
    protected void onResume() {
        super.onResume();
        // The activity has become visible (it is now "resumed").
    }
    @Override
    protected void onPause() {
        super.onPause();
        // Another activity is taking focus (this activity is about to be "paused").
    }
    @Override
    protected void onStop() {
        super.onStop();
        // The activity is no longer visible (it is now "stopped")
    }
    @Override
    protected void onDestroy() {
        super.onDestroy();
        // The activity is about to be destroyed.
    }
}

表1。活动的生命周期回调方法综述。

方法	类型	杀死后？	下一步
onCreate()	当活动首次创建。这就是你应该做你所有的正常的静态设置创建视图，将数据绑定到列表，等等。这种方法是通过一个包含活动的先前状态的对象，如果国家被抓获（见保存活动状态，后）。 总是跟着onstart()。	NO	onStart()
onRestart()	活动结束后已停止称，之前它被重新开始。 总是跟着onstart()	NO	onStart()
onStart()	就在活动变得可见的用户称为。 其次是onresume()如果活动来到前台，或onstop()如果成为隐藏。	No	onResume()  or onStop(
onResume()	在活动开始的与用户的交互，称为。在这一点上的活动是在活动堆栈的顶部，与用户输入的要它。 总是跟着onpause()。	No	onPause()
onPause()	当系统开始恢复另一个活动。这种方法通常用于提交未保存的更改的持久化数据，停止动画和可能消耗CPU的其他东西，等等。它应该非常快，因为接下来的活动将不会恢复到它的回报。 其次onresume()如果活动返回到前面，或onstop()如果它变得对用户不可见。	Yes	onResume()  or onStop()
onStop()	当活动不再是可见的用户。这可能是因为它被破坏，或者因为另一个活动（无论是现有的或新的）已经恢复，覆盖。 其次onrestart()若活动来与用户交互，或通过ondestroy()如果走的是这种活动。	Yes	onRestart() or onDestroy()
onDestory()	称为前活动被销毁。这是活动收到最后的电话。它可以被称为是因为活动完成（有人叫finish()上），或者因为系统暂时破坏该活动实例的节省空间。你能区分这两种情况的isfinishing()方法。	No	nothing

列标记为“杀的吗？”指示系统是否可以杀死进程在该方法返回任何主办的活动，但不执行活动代码的其他行。三种方法被标记为“是”：（onpause()，onstop()，和ondestroy()）。因为onpause()是三个第一，一旦活动被创建，onpause()是最后的方法，可以保证在过程可以如果系统必须紧急恢复记忆被称为，然后onstop()和ondestroy()可能不被调用。因此，你应该使用onpause()把关键的持久化数据（如用户编辑）来存储。然而，你应该对什么样的信息选择必须保留在onpause()，因为任何阻挡在该方法中的程序块到下一个活动的迁移和缓慢的用户体验。

方法被标记为“不”在杀死柱保护被杀的那一刻，它们被称为主机的活动的过程。因此，一个活动是杀死从onpause()返回时间onresume()叫做时间。它将不再可以被杀死，直到onpause()再次被调用和返回。

注：一个活动，不是技术上的”这个定义在表1被杀死”可能仍然是被系统杀死这只会在极端情况下，当没有其他选择。当一项活动可能会被杀死了更多的进程和线程文档。

Saving activity state

对管理活动生命周期的简要介绍中提到，当活动被暂停或停止时，活动的状态被保留。这是因为活动对象仍然保留在内存中时，它被暂停或停止其成员和当前状态的所有信息都是还活着。因此，任何的变化，在活动的用户保留这样的活动返回到前台（当它“简历”），这些变化仍然存在。

然而，当系统销毁活动以恢复记忆，活动对象被破坏，所以系统不能简单的恢复它原有的状态。相反，系统必须重新创建活动对象，如果用户导航回到它。然而，用户不知道系统销毁活动并重新创建它，因此，可能希望活动得像。在这种情况下，你可以确保关于活动状态的重要信息是通过执行一个附加的方法，允许你保存你的活动的状态信息保存：onsaveinstancestate()。

系统调用onsaveinstancestate()之前的活动受到破坏。该系统通过此方法一束，你能保存活动的状态信息作为名称值对，使用方法，如putstring()和putint()。然后，如果系统杀死你的应用程序和用户导航回到你的活动，系统会重新创建活动，通过对oncreate()和onrestoreinstancestate()束。使用这些方法，您可以从束提取你保存的状态和恢复活动状态。如果没有状态信息恢复，然后束传递给你是空的（这种情况时，活动是在第一次创建）。

 

图2。这两种方法在这项活动中，返回用户集中的完好状态：要么活动被销毁，然后创建和活动必须恢复以前保存的状态，或者停止活动，然后恢复和活动状态保持不变。

注：有没有保证onsaveinstancestate()将在你的活动被称为，因为在这种情况下，它不会是必要的保存状态（例如，当用户离开你的活动使用后退按钮，因为用户显式关闭活动）。如果系统调用onsaveinstancestate()，它能在onstop()可能之前onpause()。

然而，即使你什么都不做，不执行onsaveinstancestate()，某些活动状态是由onsaveinstancestate()活动类的默认实现恢复。具体来说，默认实现调用布局中的每个视图对应的onsaveinstancestate()方法，允许每个视图提供关于自身的信息应保存。在Android框架几乎每一个部件实现这个适当的方法，使得对用户界面的任何可见的变化进行自动保存和恢复你的活动被重新创建。例如，EditText小部件保存任何文本由用户和复选框控件保存它是否被进入。你唯一需要的工作是提供一个独特的ID（与Android：id属性）为每个控件你想保存其状态。如果插件没有ID，然后系统将不能保存它的状态。

虽然onsaveinstancestate()默认实现节省你的Activity的UI有用的信息，你可能需要重写它节省额外的信息。例如，您可能需要保存成员值改变活动的生活中（这可能与在UI，恢复值但成员持有这些UI值没有恢复，默认情况下）。

因为onsaveinstancestate()默认的实现有助于节省用户界面的状态，如果重写的方法，节省额外的状态信息，你应该总是做任何工作之前调用父类的实现onsaveinstancestate()。同样的，你也应该如果重写它调用父类的实现onrestoreinstancestate()，所以默认实现可以还原视图状态。

你也可以显式地停在你的布局从通过设置Android保存其状态：saveenabled属性为“假”或通过调用setsaveenabled()方法。通常，你不应该禁用这个，但你也许如果你想恢复活动状态不同的用户界面。

注：因为onsaveinstancestate()不能保证被调用，你应该只使用它来记录活动的瞬态（UI的状态）-你不应该使用它来存储数据持久性。相反，你应该使用onpause()存储持久性数据（如数据应保存到数据库）当用户离开活动。

测试你的应用程序恢复状态的能力的是简单的旋转装置使屏幕方向变化的好方法。当屏幕的方向改变时，系统销毁并重新创建活动以应用替代资源，可用于新的屏幕配置。仅仅出于这个原因，它是非常重要的，你的活动完全恢复状态时，它是重现，因为用户在使用应用程序定期旋转屏幕。

Handling configuration changes（处理配置的变化）

一些设备配置在运行时可以改变（比如屏幕方向，键盘的可用性，和语言）。当发生这样的变化，Android重新运行的活动（系统调用ondestroy()，然后立即打电话oncreate()）。此行为是设计来帮助您的应用程序的自动装载的替代资源，你提供的应用的适应新的配置（如不同的屏幕方向和大小不同的布局）。

如果你正确地设计您的活动手柄重新启动由于屏幕方向改变，如上面所描述的恢复活动状态，你的申请将在活动周期的其他突发性事件，更具弹性的。

最好的办法来处理这样的重新启动是保存和恢复你的活动和使用onsaveinstancestate() onrestoreinstancestate()国家（或oncreate()），如在上一节讨论。

大约在运行时配置发生改变，更多的信息和如何处理它们，读来处理运行时改变的指引。

Coordinating activities（协调活动）

当一个活动启动另一个，他们都体验生命周期转换。第一个活动暂停和停止（虽然，它不会如果仍然可见在后台停止），而其他的活动了。如果这些活动共享的数据保存到磁盘或其他地方，第一个知道活动并没有完全停止之前，第二个是很重要的。相反，开始第二个重叠的停止第一个过程。

生命周期回调的顺序是明确的，特别是当两个活动是相同的过程和一个启动另。这是发生时，活动A开始活动B的操作顺序：

1、活动的onpause()方法执行。

2、活动B的oncreate()，onstart()，和onresume()方法执行的顺序。（活动B有用户焦点。）

3、然后，如果活动不再是显示在屏幕上，它的onstop()方法执行。

这个预先指定的顺序，允许你管理信息从一个活动到另一个。例如，如果你要写一个数据库时，第一个活动停止，下面的活动可以读它，然后你应该写入数据库onpause()代替时，onstop()。