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

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框架普及后，用户的学习成本也会下降。