ActionBarSherlock核心类解析：ActionBarSherlock.java完全指南-优快云博客

ActionBarSherlock核心类解析：ActionBarSherlock.java完全指南

【免费下载链接】ActionBarSherlock [DEPRECATED] Action bar implementation which uses the native action bar on Android 4.0+ and a custom implementation on pre-4.0 through a single API and theme. 项目地址: https://gitcode.com/gh_mirrors/ac/ActionBarSherlock

概述

ActionBarSherlock是一个已过时但重要的Android库，它提供了跨版本的操作栏（Action Bar）实现。该库在Android 4.0及以上版本使用原生操作栏，在4.0以下版本使用自定义实现，通过统一的API和主题实现跨版本兼容。本文将深入解析其核心类ActionBarSherlock.java，帮助开发者理解其内部工作原理和使用方法。

类结构与核心功能

类定义与构造函数

ActionBarSherlock是一个抽象类，位于actionbarsherlock/src/com/actionbarsherlock/ActionBarSherlock.java。它的构造函数接收一个Activity实例和标志位，初始化关键成员变量：

protected ActionBarSherlock(Activity activity, int flags) {
    if (DEBUG) Log.d(TAG, "[<ctor>] activity: " + activity + ", flags: " + flags);

    mActivity = activity;
    mIsDelegate = (flags & FLAG_DELEGATE) != 0;
}

其中，mActivity是持有该ActionBarSherlock实例的Activity，mIsDelegate标识是否由Activity委托处理事件。

实现注册与选择机制

ActionBarSherlock使用静态代码块注册两种实现：

static {
    //Register our two built-in implementations
    registerImplementation(ActionBarSherlockCompat.class);
    registerImplementation(ActionBarSherlockNative.class);
}

registerImplementation方法将实现类与@Implementation注解信息关联存储在IMPLEMENTATIONS哈希表中。当调用wrap方法时，系统会根据设备的API级别和DPI特性选择最合适的实现：

public static ActionBarSherlock wrap(Activity activity, int flags) {
    // ... 实现选择逻辑 ...
    Class<? extends ActionBarSherlock> impl = impls.values().iterator().next();
    // ... 通过反射创建实例 ...
}

这种机制确保了在不同Android版本和设备上都能提供最佳的操作栏体验。

核心方法解析

获取操作栏实例

getActionBar是一个抽象方法，用于获取操作栏实例：

public abstract ActionBar getActionBar();

具体实现由子类ActionBarSherlockCompat和ActionBarSherlockNative提供，分别对应兼容模式和原生模式。

生命周期方法调度

ActionBarSherlock提供了一系列以"dispatch"开头的方法，用于将Activity生命周期事件调度到操作栏实现：

dispatchConfigurationChanged: 处理配置变化事件
dispatchPostResume: 在Activity恢复后通知操作栏
dispatchPause: 在Activity暂停前通知操作栏
dispatchStop: 在Activity停止前通知操作栏
dispatchDestroy: 在Activity销毁前通知操作栏

这些方法确保操作栏能够正确响应Activity的生命周期变化，例如：

public void dispatchDestroy() {}

菜单处理

ActionBarSherlock提供了菜单创建、准备和选择的回调机制：

protected final boolean callbackCreateOptionsMenu(Menu menu) {
    // ... 调用Activity的菜单创建回调 ...
}

protected final boolean callbackPrepareOptionsMenu(Menu menu) {
    // ... 调用Activity的菜单准备回调 ...
}

protected final boolean callbackOptionsItemSelected(MenuItem item) {
    // ... 调用Activity的菜单项选择回调 ...
}

这些方法将菜单事件从操作栏实现转发到关联的Activity。

关键接口与监听器

ActionBarSherlock定义了一系列接口，用于与Activity通信：

OnCreatePanelMenuListener: 面板菜单创建回调
OnCreateOptionsMenuListener: 选项菜单创建回调
OnMenuItemSelectedListener: 菜单项选择回调
OnOptionsItemSelectedListener: 选项菜单项选择回调
OnPreparePanelListener: 面板准备回调
OnPrepareOptionsMenuListener: 选项菜单准备回调
OnActionModeFinishedListener: 操作模式结束回调
OnActionModeStartedListener: 操作模式开始回调

Activity通过实现这些接口，可以响应操作栏的各种事件。

实现类与版本适配

ActionBarSherlock有两个主要实现类：

ActionBarSherlockNative: 用于Android 4.0及以上版本，使用原生操作栏
ActionBarSherlockCompat: 用于Android 4.0以下版本，提供自定义操作栏实现

这两个类分别位于：

系统会根据运行时的API级别自动选择合适的实现，确保在不同版本的Android系统上都能提供一致的操作栏体验。

使用示例

基本初始化

在Activity中使用ActionBarSherlock的基本步骤如下：

public class MyActivity extends SherlockActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 获取ActionBar实例
        ActionBar actionBar = getSupportActionBar();
        // 设置标题
        actionBar.setTitle("My Action Bar");
        // 设置显示返回按钮
        actionBar.setDisplayHomeAsUpEnabled(true);
    }
    
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // 填充菜单
        getSupportMenuInflater().inflate(R.menu.my_menu, menu);
        return true;
    }
    
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        // 处理菜单项点击
        switch (item.getItemId()) {
            case android.R.id.home:
                finish();
                return true;
            case R.id.action_settings:
                // 打开设置
                return true;
            default:
                return super.onOptionsItemSelected(item);
        }
    }
}

自定义操作栏样式

ActionBarSherlock支持通过主题自定义操作栏样式。在AndroidManifest.xml中为Activity指定主题：

<activity
    android:name=".MyActivity"
    android:theme="@style/Theme.Sherlock.Light.DarkActionBar" />

可以在res/values/styles.xml中自定义主题：

<style name="MyCustomTheme" parent="Theme.Sherlock">
    <item name="actionBarStyle">@style/MyActionBar</item>
    <item name="android:actionBarStyle">@style/MyActionBar</item>
</style>

<style name="MyActionBar" parent="Widget.Sherlock.ActionBar">
    <item name="background">@drawable/action_bar_bg</item>
    <item name="titleTextStyle">@style/MyActionBar.TitleTextStyle</item>
</style>

总结与注意事项

ActionBarSherlock虽然已过时，但它的设计思想和实现方式对理解Android兼容性开发有重要参考价值。使用时需要注意以下几点：

该库已不再维护，对于新项目，建议使用Android官方的AppCompat库
ActionBarSherlock需要配合特定的Activity类使用，如SherlockActivity、SherlockFragmentActivity等
在使用前确保正确配置主题和资源，以保证在不同Android版本上的一致性

通过理解ActionBarSherlock.java的实现，开发者可以更好地掌握Android操作栏的工作原理，以及跨版本兼容性的解决方案。

ActionBarSherlock核心类解析：ActionBarSherlock.java完全指南