Android ActionBar Compact 介绍和使用

Question

自 Action Bar 设计概念在 Android 3.0（API 11）中被 Google 引入以后，在 4.0 版本之后更是被 Google 纳入设计规范中，从 Google 的各大 App 中都可以看到这种设计。

但 Action Bar 虽好，它出现之初 Android 官方版本的 ActionBar 只支持 Android 3.0 (API 11) 及以后的系统版本。而由于 Android 众所周知的碎片化问题，当开发者试图在 minSdkVersion 小于 11 的系统上使用 Action Bar 时只好使用大名鼎鼎的 JakeWharton 发布的 ActionBarSherlock 。

还好，在 Google I/O 2013 后，官方版本的兼容 Android 2.1（API 7）及其以后版本的 ActionBarCompat 终于发布了 （包含在 Support Library v7 r18 中）。原本使用 ActionBarSherlock 的一众应用们也开始了升级至 ActionBarCompat 的工作。这篇博客就来分享下如何使用 ActionBarCompat 实现 Action Bar。

首先确认了开发环境中 Android SDK 已经安装了 Support Library r18 或以上，目前最新的是 19, 接下来，开始实际建立一个 ActionBar 的开发实例。实现一个含有 Action Bar Icon, Title, Action Item 以及 Action Overflow 的 ActionBar Hello World 应用。

Eclipse+Android ADT 环境下:

1. Create a blank Android Project

创建一个空的 Android 项目，这里具体就不再赘述。

2. 将 Support V7 appcompat Library 添加至工程

a. 导入 ActionBarCompat 工程（这个工程是个 Library)

ActionBarCompat 的 source code 位置是:`<Android SDK 目录>/extras/android/support/v7/appcompat`

这样我们就得到一个名叫 android-support-v7-appcompat 的 library project

b. 接着在自己新建的 project 点击右键->选择 Properties->选择 Android 选项，点 Add，然后选择 android-support-v7-appcompat ，点击 OK 搞定。

3. Update Style Resources

刚才说了 ActionBarCompat 在使用中会调用一些资源文件，尤其是基于 Theme.AppCompat 的主题（Theme）用来规范 Action Bar 的显示。如果使用 Action Bar 的 Activity 没有使用基于 Theme.AppCompat 的主题，程序就不知道该如何配置 Action Bar 的显示，就会报错导致程序退出。

在 AndroidManifest 中讲 Application 的 android:theme 属性设置为 Theme.AppCompat 系列 Theme。

<application
    android:label="@string/app_name"
    android:icon="@drawable/ic_launcher"
    android:theme="@style/Theme.AppCompat.Light">

如果你在使用自定义的 Theme，则该 Theme 的 parent 应设置为 Theme.AppCompat 系列 Theme.

<!-- Application theme. -->
<style name="AppTheme" parent="@style/Theme.AppCompat.Light">
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowBackground">@color/global_main_bg</item>
</style>

4. Extend ActionBarActivity

当要在 Activity 中使用 ActionBar，并要求兼容 Android 2.1~3.0 之间的系统时，我们不能像往常那样 extend Activity，而应 extend ActionBarActivity（原因如上所属，Android 3.0 以前的系统中 Activity API 里是没有 ActionBar 接口的 自然也就无法调用。为了向下兼容，必须使用 ActionBarActivity）。

import android.os.Bundle;
import android.support.v7.app.ActionBar;
import android.support.v7.app.ActionBarActivity;
import android.view.Menu;

public class MainActivity extends ActionBarActivity {

    private ActionBar actionBar;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        actionBar=getSupportActionBar();
        //actionBar operation
        actionBar.setTitle("ActionBar");
        //....
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }
}

5. 修改 menu/main.xml (也就是 Action Bar 中的 Action Items)

你的 project 中会有一个默认的 main.xml，为了向 Action Bar 中添加几个功能按钮（也就是 Action Items)，我们需要对 menu/main.xml 进行些修改：

• 在 root element 中添加一个 attribute
• 添加新的 item 项

<menu
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:id="@+id/action_settings"
        android:title="@string/action_settings"
        android:orderInCategory="100"
        app:showAsAction="always" />
    <item android:id="@+id/action_search"
        android:title="@string/action_search"
        android:orderInCategory="1"
        android:icon="@drawable/action_search"
        app:showAsAction="always" />
</menu>

Action Items 广泛使用的一些 icon，你可以从 Download the Action Bar Icon Pack 下载到。

最后，如果需要在程序中对 ActionBar 进行操作，可以通过 getSupportActionBar() 来实现。

actionBar = getSupportActionBar();
//actionBar operation
actionBar.setTitle("ActionBar");