You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
280 lines
12 KiB
280 lines
12 KiB
13 years ago
|
Change Log
|
||
|
===============================================================================
|
||
|
|
||
|
Version 3.3.0 *(2011-10-11)*
|
||
|
----------------------------
|
||
|
|
||
|
* Tabs are now displayed below the action bar on all medium-screen devices and
|
||
|
portrait large-screen devices.
|
||
|
* Fix: Dialog fragments no longer throw an `IllegalStateException` when being
|
||
|
used as a regular fragment (i.e., not as a popup). See
|
||
|
[StackOverflow](http://stackoverflow.com/questions/5637894/dialogfragments-with-devices-api-level-11/7560686#7560686)
|
||
|
for more information.
|
||
|
* Fix: Popping a fragment off of the back stack now properly assigns its parent
|
||
|
activity.
|
||
|
* Fix: An activity result no longer causes a `NullPointerException` when the
|
||
|
target fragment no longer exists.
|
||
|
* Fix: Action item dividers are now properly initially hidden when their
|
||
|
associated action items are as well.
|
||
|
|
||
|
|
||
|
Version 3.2.3 *(2011-09-16)*
|
||
|
----------------------------
|
||
|
|
||
|
* Fix: Fragments in a `ViewPager` that contributed items to the options menu
|
||
|
were caught in a race condition causing inconsistent results when a new page
|
||
|
was selected. This regression was introduced in version 3.2.2.
|
||
|
|
||
|
|
||
|
Version 3.2.2 *(2011-09-15)*
|
||
|
----------------------------
|
||
|
|
||
|
* Fix: Side-effects related to using `FragmentMapActivity` due to how it was
|
||
|
referencing resources from the main library.
|
||
|
* Fix: Fragments adjacent to the currently selected fragment in a `ViewPager`
|
||
|
no longer receive context menu events.
|
||
|
* Fix: Eliminate exception when inflating context menus on 3.0+ when using
|
||
|
`getMenuInflater()`.
|
||
|
* Fix: `ViewPager` now determines whether or not an activity menu invalidation
|
||
|
is required independently of whether or not fragments were created or
|
||
|
destroyed. This should fix an edge case where an activity with a `ViewPager`
|
||
|
containing only two fragments would not get its menu properly invalidated.
|
||
|
|
||
|
|
||
|
Version 3.2.1 *(2011-09-12)*
|
||
|
----------------------------
|
||
|
|
||
|
* Fix: Action mode API incorrectly using the native `Menu` and `MenuItem`
|
||
|
classes causing an easy pitfall for `ClassCastExceptions`.
|
||
|
* Fix: Large action bar backgrounds increasing the size beyond that alloted in
|
||
|
the theme.
|
||
|
|
||
|
|
||
|
Version 3.2.0 *(2011-09-05)*
|
||
|
----------------------------
|
||
|
|
||
|
* Added support for `MapView` and the Google APIs through the use of
|
||
|
`FragmentMapActivity`. If you are using a map within a fragment you must
|
||
|
ensure it is always attached to an activity which extends from this new base
|
||
|
class.
|
||
|
|
||
|
Since supporting maps requires compiling against the Google APIs, this
|
||
|
functionality is implemented in the form of a plugin which is to be used
|
||
|
alongside the normal library. You can choose to add it as an additional
|
||
|
library project or by including it as a `.jar`. Maven users may simply
|
||
|
include the additional dependency (artifactId: `plugin-maps`).
|
||
|
* Fix: Fragments adjacent to the currently selected fragment in a `ViewPager`
|
||
|
no longer contribute to the activity menu.
|
||
|
* `ActionBar.Tab` has been changed from an interface to an abstract class to
|
||
|
mirror its native counterpart.
|
||
|
|
||
|
|
||
|
Version 3.1.3 *(2011-08-14)*
|
||
|
----------------------------
|
||
|
|
||
|
* Renamed all resources to be prefixed with `abs__` to avoid conflicts when
|
||
|
including in your project.
|
||
|
* Fix: Action bar background being set on two views causing artifacts to remain
|
||
|
on screen when the action bar was hidden.
|
||
|
* Fix: Incorrect sub-menu item being selected by default when the sub-menu was
|
||
|
triggered from the native options menu on pre-3.0.
|
||
|
* Fix: `MenuItem.setVisible` now properly updates the associated action item and
|
||
|
native menu item visible state.
|
||
|
* Fix: Adding items to a menu now honors its ordering and category.
|
||
|
* Fix: Fragment options item selected callback now uses the proper version of
|
||
|
`MenuItem`.
|
||
|
|
||
|
|
||
|
Version 3.1.2 *(2011-08-07)*
|
||
|
----------------------------
|
||
|
|
||
|
* Fix: `MenuItem.getMenuInfo()` was throwing runtime exception. Will now just
|
||
|
return `null`.
|
||
|
* Fix: Dragging over a `WebView` contained in a `ViewPager` would not register.
|
||
|
* Fix: Inflation of context menu incorrectly being handled by the custom menu
|
||
|
inflater for the library.
|
||
|
|
||
|
|
||
|
Version 3.1.1 *(2011-07-31)*
|
||
|
----------------------------
|
||
|
|
||
|
* Fix: `MenuItem.getSubMenu` now returns a support instance rather than a
|
||
|
native instance.
|
||
|
* Fix: Fragment methods `onAttach` and `onInflate` incorrectly regressed to use
|
||
|
`Activity` instead of a `FragmentActivity` in their method signatures.
|
||
|
* Fix: Retained fragments not being re-attached on pre-3.0 when attached to
|
||
|
`android.R.id.content` upon activity recreation.
|
||
|
* Fix: `onPrepareOptionsMenu` not dispatched to fragments. This still will only
|
||
|
occur if the activity method returns true (which is the default).
|
||
|
* Fix: `Menu.findItem` not returning `null` when the item was not found on
|
||
|
Android 3.0+.
|
||
|
|
||
|
|
||
|
Version 3.1.0 *(2011-07-22)*
|
||
|
----------------------------
|
||
|
|
||
|
Due to shortcomings in the Android theming system, a small change must be made
|
||
|
in how this library handles themes. If you were using a custom style for
|
||
|
`actionBarStyle` you must now specify its attributes in the root of the theme
|
||
|
and prefix them with 'ab'.
|
||
|
|
||
|
You can see an example of this in the `SherlockCustom` theme in
|
||
|
`samples/demos/res/values/styles.xml`.
|
||
|
|
||
|
* Library now uses the `r3` version of the compatibility library for its base.
|
||
|
* `actionBarStyle` is no longer a valid theme attribute (see note above).
|
||
|
* Added the demo project included with the new compatibility library under
|
||
|
`samples/demos/` and merged in the old 'featuredemo'.
|
||
|
* Dividers are now shown on pre-3.0 devices between all action items.
|
||
|
* `Window.FEATURE_ACTION_BAR_OVERLAY` is now honored on pre-3.0 devices.
|
||
|
* Inflation of XML menu resources will now honor `android:actionLayout` and
|
||
|
`android:actionViewClass` attributes.
|
||
|
* Buttons for displaying the determinate and indeterminate progress bars have
|
||
|
been added to the feature toggle demo.
|
||
|
* Added support for indeterminate progress bar. Due to the `final` modifier on
|
||
|
the native type, you must use `setIndeterminateProgressBarVisibility(Boolean)`
|
||
|
and pass `Boolean.TRUE` or `Boolean.FALSE`.
|
||
|
* Fix: `MenuBuilder#removeItem(int)` and `MenuBuilder#findItem(int)` throwing
|
||
|
`IndexOutOfBoundsException`s when the item was not found.
|
||
|
* Fix: Theme attributes for home item data (e.g., icon, logo) will not be
|
||
|
overwritten by the special `MenuItem` instance for home.
|
||
|
* Fix: Native strings can now be specified for an XML menu `<item>` in
|
||
|
`android:title` and `android:titleCondensed`.
|
||
|
* `Window.FEATURE_ENABLE_ACTION_BAR_WATSON_TEXT` is now
|
||
|
`Window.FEATURE_ACTION_BAR_ITEM_TEXT`.
|
||
|
* `Widget.Sherlock.Spinner.DropDown.ActionBar` and
|
||
|
`Widget.Sherlock.Light.Spinner.DropDown.ActionBar` styles are now
|
||
|
`Widget.Sherlock.Spinner` and `Widget.Sherlock.Light.Spinner`, respectively.
|
||
|
* `Widget.Sherlock.ActionBarView_TabXXX` styles are now
|
||
|
`Widget.Sherlock.ActionBar.TabXXX`.
|
||
|
|
||
|
|
||
|
Version 3.0.3 *(2011-07-17)*
|
||
|
----------------------------
|
||
|
|
||
|
This version is a hotfix for incompatibilities introduced with the SDKs for
|
||
|
3.1 r2 and 3.2 r1. Due to unavoidable changes in the underlying SDK, the library
|
||
|
must now be compiled against API level 13.
|
||
|
|
||
|
* `actionModeStyle` and `actionModePopupWindowStyle` are no longer valid theme
|
||
|
attributes.
|
||
|
|
||
|
|
||
|
Version 3.0.2 *(2011-06-23)*
|
||
|
----------------------------
|
||
|
|
||
|
* Sub-menus for action items are now shown in a list dialog.
|
||
|
* Moved certain classes to the `com.actionbarsherlock.internal` package which
|
||
|
were not meant for public consumption. Despite being given `public` scope in
|
||
|
this new package, these classes should **NOT** be used under any circumstances
|
||
|
as their API can be considered highly volatile and is subject to change often
|
||
|
and without warning.
|
||
|
|
||
|
|
||
|
Version 3.0.1 *(2011-06-08)*
|
||
|
----------------------------
|
||
|
|
||
|
* Fix: `onOptionsItemSelected()` not being called in fragments if the activity
|
||
|
version returns `false`.
|
||
|
* Fix: `onCreateOptionsMenu()` not being called in fragments on Android 3.0+.
|
||
|
* New: Enable action item text display on pre-Android 3.0 by calling
|
||
|
`requestWindowFeature` with `Window.FEATURE_ENABLE_ACTION_BAR_WATSON_TEXT`.
|
||
|
* Fix: `setCustomView()` no longer automatically enables the custom view on
|
||
|
pre-3.0. You must call `setDisplayShowCustomEnabled()` in order to display
|
||
|
the view.
|
||
|
|
||
|
|
||
|
Version 3.0.0 *(2011-06-05)*
|
||
|
----------------------------
|
||
|
|
||
|
The API has been rewritten to mimic that of the native action bar. As a result,
|
||
|
usage now only requires changing a few imports to use the support versions
|
||
|
of classes and calling `getSupportActionBar()`. See the README for more info.
|
||
|
|
||
|
The rewrite necessitated tight interaction with the
|
||
|
[compatibility library](http://android-developers.blogspot.com/2011/03/fragments-for-all.html)
|
||
|
to the point where its sources are now included. You are no longer required to
|
||
|
have the standalone `.jar` file.
|
||
|
|
||
|
Also included is a default custom action bar for use by default on pre-3.0
|
||
|
devices. This custom implementation is based off of Johan Nilsson's
|
||
|
[Android-ActionBar](https://github.com/johannilsson/android-actionbar) and the
|
||
|
[work that I have done](https://github.com/johannilsson/android-actionbar/pull/25)
|
||
|
on it.
|
||
|
|
||
|
More details are available at http://actionbarsherlock.com
|
||
|
|
||
|
|
||
|
Version 2.1.1 *(2011-03-21)*
|
||
|
----------------------------
|
||
|
|
||
|
**No changes to library code.**
|
||
|
|
||
|
* Moved library to the root of the repository.
|
||
|
* Added `samples/dependencies.py` script to automatically download the needed
|
||
|
dependencies for the sample projects.
|
||
|
|
||
|
|
||
|
Version 2.1.0 *(2011-03-21)*
|
||
|
----------------------------
|
||
|
|
||
|
**WARNING**: The
|
||
|
[Android Compatibility Library (v4)](http://android-developers.blogspot.com/2011/03/fragments-for-all.html)
|
||
|
is now required.
|
||
|
|
||
|
* Added `ActionBarSherlock.Activity`, `ActionBarSherlock.FragmentActivity`,
|
||
|
and `ActionBarSherlock.ListActivity` for extension by implementing
|
||
|
activities, the latter of which is deprecated. This affords a much tighter
|
||
|
integration and allows for the use of other new features listed below.
|
||
|
* New API method: `layout(Fragment)` will use the fragment argument as the
|
||
|
content to the activity.
|
||
|
* New API method: `menu(int)` allows for the inflation of menu XMLs from a
|
||
|
resource. For the non-native implementation, the XML can be inflated to a
|
||
|
custom Menu which can then be applied appropriately to the third-party
|
||
|
action bar. Sub-menus are also supported. Third-party action bar handlers
|
||
|
should implement `ActionBarSherlock.HasMenu` for this functionality. *This
|
||
|
feature requires that activities extend from one of the provided activity
|
||
|
base classes.*
|
||
|
* New API method: `homeAsUp(boolean)`. This mimics the native method
|
||
|
`setDisplayHomeAsUpEnalbed` on the native action bar. Third-party action bar
|
||
|
handlers should implement `ActionBarSherlock.HasHomeAsUp` for this
|
||
|
functionality.
|
||
|
* New API method: `useLogo(boolean)` will trigger the action bar to hide the
|
||
|
application icon/home button and title and show a larger logo representing
|
||
|
the application. Third-party action bar handlers should implement
|
||
|
`ActionBarSherlock.HasLogo` for this functionality.
|
||
|
* New API method: `listNavigation(SpinnerAdapter, OnNavigationListener)`. Tells
|
||
|
the action bar to use drop-down style navigation with the specified list of
|
||
|
items and callback listener. Third-party action bar handlers should
|
||
|
implement `ActionBarSherlock.HasListNavigation` for this functionality.
|
||
|
* Javadocs are now available at
|
||
|
[jakewharton.github.com/ActionBarSherlock](http://jakewharton.github.com/ActionBarSherlock/).
|
||
|
* A standalone JAR is now available via the
|
||
|
[GitHub downloads page](https://github.com/JakeWharton/ActionBarSherlock/downloads)
|
||
|
or in my
|
||
|
[personal maven repository](http://r.jakewharton.com/maven/)
|
||
|
as `com.jakewharton:android-actionbarsherlock:2.1.0`.
|
||
|
|
||
|
|
||
|
Version 2.0.1 *(2011-03-11)*
|
||
|
----------------------------
|
||
|
|
||
|
* Use `Class.forName()` for detection of native action bar. This provides
|
||
|
compatability all the way back to Android 1.5.
|
||
|
|
||
|
|
||
|
Version 2.0.0 *(2011-03-09)*
|
||
|
----------------------------
|
||
|
Complete rewrite!
|
||
|
|
||
|
* New and better API.
|
||
|
* More sane logic and attachment to activity.
|
||
|
* Extensible via generics. Implement any ActionBar or roll your own with
|
||
|
minimal effort.
|
||
|
* Now a library project for easy inclusion in applications.
|
||
|
|
||
|
|
||
|
Version 1.0.0 *(2011-03-07)*
|
||
|
----------------------------
|
||
|
Initial release.
|