Android官方培训课程中文版(v0.9.7)

提供向上的导航

编写:Lin-H - 原文:http://developer.android.com/training/implementing-navigation/ancestral.html

所有不是从主屏幕("home"屏幕)进入app的,都应该给用户提供一种方法,通过点击action bar中的Up按钮。可以回到app的结构层次中逻辑父屏幕。本课程向你说明如何正确地实现这一操作。

Up Navigation 设计

Designing Effective Navigation和the Navigation design guide中描述了向上导航的概念和设计准则。

Figure 1. action bar中的Up按钮.

Figure 1. action bar中的Up按钮.

指定父Activity

要实现向上导航,第一步就是为每一个activity声明合适的父activity。这么做可以使系统简化导航模式,例如向上导航,因为系统可以从manifest文件中判断它的逻辑父(logical parent)activity。

从Android 4.1 (API level 16)开始,你可以通过指定<activity>元素中的android:parentActivityName属性来声明每一个activity的逻辑父activity。

如果你的app需要支持Android 4.0以下版本,在你的app中包含Support Library并添加<meta-data>元素到<activity>中。然后指定父activity的值为android.support.PARENT_ACTIVITY,并匹配android:parentActivityName的值。

例如:

<application ... >
    ...
    <!-- main/home activity (没有父activity) -->
    <activity
        android:name="com.example.myfirstapp.MainActivity" ...>
        ...
    </activity>
    <!-- 主activity的一个子activity -->
    <activity
        android:name="com.example.myfirstapp.DisplayMessageActivity"
        android:label="@string/title_activity_display_message"
        android:parentActivityName="com.example.myfirstapp.MainActivity" >
        <!-- 父activity的meta-data,用来支持4.0以下版本 -->
        <meta-data
            android:name="android.support.PARENT_ACTIVITY"
            android:value="com.example.myfirstapp.MainActivity" />
    </activity>
</application>

在父activity这样声明后,你可以使用NavUtils API进行向上导航操作,就像下一面这节。

添加向上操作(Up Action)

要使用action bar的app图标来完成向上导航,需要调用setDisplayHomeAsUpEnabled():

@Override
public void onCreate(Bundle savedInstanceState) {
    ...
    getActionBar().setDisplayHomeAsUpEnabled(true);
}

这样,在app旁添加了一个左向符号,并用作操作按钮。当用户点击它时,你的activity会接收一个对onOptionsItemSelected()的调用。操作的ID是android.R.id.home

向上导航至父activity

要在用户点击app图标时向上导航,你可以使用NavUtils类中的静态方法navigateUpFromSameTask()。当你调用这一方法时,系统会结束当前的activity并启动(或恢复)相应的父activity。如果目标activity在任务的后退栈中(back stack),则目标activity会像FLAG_ACTIVITY_CLEAR_TOP定义的那样,提到栈顶。提到栈顶的方式取决于父activity是否处理了对onNewIntent()的调用。

例如:

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
    // 对action bar的Up/Home按钮做出反应
    case android.R.id.home:
        NavUtils.navigateUpFromSameTask(this);
        return true;
    }
    return super.onOptionsItemSelected(item);
}

但是,只能是当你的app拥有当前任务(current task)(用户从你的app中发起这一任务)时navigateUpFromSameTask()才有用。如果你的activity是从别的app的任务中启动的话,向上导航操作就应该创建一个属于你的app的新任务,并需要你创建一个新的后退栈。

用新的后退栈来向上导航

如果你的activity提供了任何允许被别的app启动的intent filters,那么你应该实现onOptionsItemSelected()回调,在用户从别的app任务进入你的activity后,点击Up按钮,在向上导航之前你的app用相应的后退栈开启一个新的任务。

在这么做之前,你可以先调用shouldUpRecreateTask()来检查当前的activity实例是否在另一个不同的app任务中。如果返回true,就使用TaskStackBuilder创建一个新任务。或者,你可以向上面那样使用navigateUpFromSameTask()方法。

例如:

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
    // 对action bar的Up/Home按钮做出反应
    case android.R.id.home:
        Intent upIntent = NavUtils.getParentActivityIntent(this);
        if (NavUtils.shouldUpRecreateTask(this, upIntent)) {
            // 这个activity不是这个app任务的一部分, 所以当向上导航时创建
            // 用合成后退栈(synthesized back stack)创建一个新任务。
            TaskStackBuilder.create(this)
                    // 添加这个activity的所有父activity到后退栈中
                    .addNextIntentWithParentStack(upIntent)
                    // 向上导航到最近的一个父activity
                    .startActivities();
        } else {
            // 这个activity是这个app任务的一部分, 所以
            // 向上导航至逻辑父activity.
            NavUtils.navigateUpTo(this, upIntent);
        }
        return true;
    }
    return super.onOptionsItemSelected(item);
}

Note:为了能使addNextIntentWithParentStack()方法起作用,你必须像上面说的那样,在你的manifest文件中使用android:parentActivityName(和相应的<meta-data>元素)属性声明所有的activity的逻辑父activity。