The ActionBarSherlock
class is a helper designed to facilitate the use of
the action bar design pattern across all version of Android leveraging the best
APIs available.
The class will automatically use the native ActionBar implementation on Android 3.0 or later. For previous versions which do not include ActionBar, a custom action bar implementation can automatically be wrapped around the layout.
All interaction with these action bars is handled through the optional extension of static classes which should be implemented in each Activity as inner-classes.
Examples of third-party implementations can be found in the samples/
folder
of this repository.
ActionBarSherlock
is also 100% compatible with the Fragments API, both
natively and using the compatability package.
Two sample applications are included which demonstrate implementing custom
action bar handlers for GreenDroid* and Android-ActionBar. These are
located in the samples/
folder of this repository.
In order for these sample applications to properly work, the respective library that they depend on needs to be cloned in the same parent folder as this one.
This can be accomplished by executing one or both of the following commands in the parent directory.
git clone git://github.com/johannilsson/android-actionbar.git
git clone git://github.com/hameno/GreenDroid.git
You can also download pre-built .apks for each of these samples from the project download page for demonstration.
* NOTE: The GreenDroid implementation currently requires a fork of the official repository and NOT the official repository itself. This is because the current official GreenDroid library has API conflicts with Android 3.0. Until the changes implemented in the fork are merged upstream, this is the only way to achieve the GreenDroid implementation.
- Jake Wharton - jakewharton@gmail.com
Git repository located at github.com/JakeWharton/ActionBarSherlock.
Copyright 2011 Jake Wharton
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.