安卓开发文档学习笔记之ActionBar的使用与适配

526 查看

ActionBar

自从Android3.0(API 11)把ActionBar加入到android sdk后,其在安卓UI布局中的地位便一路上升。通过安卓的官方文档可以看出,ActionBar的出现旨在为用户提供一个更加简洁和友好的UI框架。同时开发者通过采用ActionBar也可以获得诸多好处(比如APP在高版本安卓系统中更好的稳定性)。

ActionBar的使用

对于Andorid3.0(API11)及以上的系统,使用ActionBar只需要设置两个地方即可

AndroidManifest.xml

<manifest ... >
    <uses-sdk android:minSdkVersion="11" ... />
    ...
</manifest>

以及

<activity android:theme="@style/Theme.Holo" ... >

但是在平时的开发中,一般都要考虑APP的低版本适配问题,那么在Android3.0(API11)以下的的sdk中,该如何使用ActionBar呢?好在安卓为我们提供了支持包Android Support Library,该支持包可以通过Android SDK Manager下载

下载完成后在sdk安装路径下可以看到/extras/android/v7/appcompat这个项目,它就是低版本sdk使用ActionBar的支持包。(Andorid Support Library详细的使用说明请查看谷歌说明文档)。
安装完appcompat后,下面就是要在项目的代码中使用它了。
1.任何需要使用ActionBar的activity都要继承ActionBarActivity这个类

public class YourActivity extends ActionBarActivity {...}

2.activity(或者application)的主题都要继承Theme.AppCompat

<activity android:theme="@style/Theme.AppCompat.Light" ... >

3.APP版本兼容至(最低)Android2.1(API7)

<manifest ... >
    <uses-sdk android:minSdkVersion="7"  android:targetSdkVersion="19" />
    ...
</manifest>

至此,项目就已经使用ActionBar了,接下来就是如何定义ActionBar的功能按钮。
首先来看下一个标准的ActionBar长什么样

通过图片可以看出,一个ActionBar大致可以分成两部分,左侧的图标和Activity标签,右侧是一些可以自定义的功能按钮。其中修改左侧的图标和标签比较简单,只要在AndroidManifest.xml文件里修改即可。下面就来看看如何修改右侧的功能按钮,从而把我们想要的操作加到ActionBar上面。
1.在/res/menu文件夹里新建一个菜单定义文件,比如

/res/menu/main_activity_actions.xml

<menu xmlns:android="http://schemas.android.com/apk/res/android" >
    <!-- Search, should appear as action button -->
    <item android:id="@+id/action_search"
          android:icon="@drawable/ic_action_search"
          android:title="@string/action_search"
          android:showAsAction="ifRoom" />
    <!-- Settings, should always be in the overflow -->
    <item android:id="@+id/action_settings"
          android:title="@string/action_settings"
          android:showAsAction="never" />
</menu>

在上面的文件中,我们定义了一个搜索和一个设置共两个菜单项。在定义文件中,如果一个菜单项设置了android:icon属性,那么在ActionBar中就会显示该属性指向的drawable资源,如果android:icon属性没有被设置,那么默认就会显示android:title指向的字符串。对于android:showAsAction属性(该属性有五个可以设定的值——ifRoom,withText,never,always,collapseActionView,详细说明请戳这里),如果设置为ifRoom,那么系统在显示该菜单项时做个判断,判断ActionBar右侧是否有足够的空间放置这个按钮,如果设置为never,那么这里会因系统版本不同而导致显示的方式有所差异。在高版本系统(测试版本为4.3)中,ActionBar的最右侧会自动添加一个按钮overflow,也就是上面图片中竖排的三个点。通过点击overflow按钮,android:showAsAction属性设置为never的菜单项就会以下拉的方式显示出来。但在低版本系统(测试版本为2.2)中,系统是没有添加这个overflow按钮的。

所以项目中对低版本的适配需要注意到这一点

2.在Activity中调用onCreateOptionsMenu(Menu menu)方法解析menu文件

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // Inflate the menu items for use in the action bar
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.main_activity_actions, menu);
    return super.onCreateOptionsMenu(menu);
}

3.定义各个菜单项的动作

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    // Handle presses on the action bar items
    switch (item.getItemId()) {
        case R.id.action_search:
            openSearch();
            return true;
        case R.id.action_settings:
            openSettings();
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

ActionBar与Activities的树形结构

在微信5.2安卓客户端中,大家在使用时应该都注意到了一个特性,那就是不管当前活动界面是在哪个Activity上面,通过点击左上角的图标或者标签就可以返回到上一层的Activity。这一特性就是ActionBar带来的。那么如何实现呢?
1.在AndroidManifest.xml文件中声明Activity的android:parentActivityName属性

<application ... >
    ...
    <!-- The main/home activity (it has no parent activity) -->
    <activity
        android:name="com.example.myfirstapp.MainActivity" ...>
        ...
    </activity>
    <!-- A child of the main activity -->
    <activity
        android:name="com.example.myfirstapp.DisplayMessageActivity"
        android:label="@string/title_activity_display_message"
        android:parentActivityName="com.example.myfirstapp.MainActivity" >
        <!-- Parent activity meta-data to support 4.0 and lower -->
        <meta-data
            android:name="android.support.PARENT_ACTIVITY"
            android:value="com.example.myfirstapp.MainActivity" />
    </activity>
</application>

android:parentActivtyName属性声明的值就是点击ActionBar左侧图标所返回的Activity同时,为了支持4.0以下的版本需要多添加一些数据

<!-- Parent activity meta-data to support 4.0 and lower -->
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value="com.example.myfirstapp.MainActivity" />

2.在activity的onCreate(Bundle savedInstanceState)方法调用setDisplayHomeAsUpEnabled()方法

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_displaymessage);

    getSupportActionBar().setDisplayHomeAsUpEnabled(true);
    // 如果不需要支持Android3.0(API11)以下的版本,则可以调用
    // getActionBar().setDisplayHomeAsUpEnabled(true);
}

通过ActionBar和Activities的树状结构相结合,APP内的Activities结合的更加紧密。其实这也是ActionBar的最大的魅力所在。对于开发者来说,至少可以省掉一个后退按钮。对于用户来说,实时的显示Activities标签可以帮助用户定位当前APP运行的位置,以及ActionBar这个UI框架普及后,用户的学习成本也会降低。