Release Android 2.2.0

[bleege]

It's been just a week since the original 2.1.0 release, but we have all sorts of good stuff that we should get out into the world.

New Highlights

• New User Location Dot
• Support For Custom Images For Markers
• Default Marker
• OpenGL fixes to support Ice Cream Sandwich (API 15) and Jelly Bean (API 16, 17, 18) devices
• Follow User Location Dot
• Bulk Add Markers
• Satellite Streets Style

Full Change Log: https://github.com/mapbox/mapbox-gl-native/issues?q=is%3Aissue+milestone%3Aandroid-v2.2.0

Release Branch: https://github.com/mapbox/mapbox-gl-native/commits/release-android-v2.2.0

Here's the TODO list for making that happen:

• Change Version Name to 2.2.0
• Publish 2.2.0 artifact to Maven Central
• Updating Mapbox.com JavaDoc Documentation
• Tag android-v2.2.0 in GitHub
• Update version info in Twitter Fabric metadata file
• Move open issues to android-v2.3.0 Milestone in GitHub
• Close Milestone android-v2.2.0 in GitHub

/cc @mapbox/mobile @mapbox/support @twbell

[bleege]

FYI @ljbade @tobrun I've moved the milestone of tickets that were associated with commits that landed in master since the release branch commit 43dde0f on 27-Oct-2015. The commits are still in master, but the milestone was changed from android-v2.2.0 to android-v2.3.0 as they won't make this release. Below is a screenshot of the affected commits intermingled with other non Android commits:

[ljbade]

@bleege Since the switch over from Marker.setSprite(String) to Marker.setIcon(Sprite) is breaking, should we go to 3.0.0?

[bleege]

@ljbade Can you clarify by what you mean by "breaking"? Do you mean that setSprite() was renamed to setIcon()?

[ljbade]

@bleege It is not just a simple rename, we also have a new way of loading sprites. Instead of a string which points to the style specific sprite sheet (and was really just a temporary solution - iOS does not support this for a good reason), you now first load a Sprite via SpriteFactory.

[ljbade]

So code using the old setSprite will need to be changed, and the app developer will have to add a Bitmap resource with the icon they want. Whether it be from Maki, or their own design.

[bleege]

Thanks for clarifying @ljbade. Here's what I'm thinking:

It is not just a simple rename, we also have a new way of loading sprites.

This is to be understood and fine as this is the first release were the SDK will offer custom sprite loading. It's also the second overall release of the SDK (with the first one being just a week ago). Looking at the code the impact will be limited to MarkerOptions.icon() as Marker.setIcon() is not directly accessible to developers (and has a friendly JavaDoc note to not directly use this 😃 ). The end result is that to "upgrade" will require the following change (assuming a custom Style Sprite was even specified and not just using the default):

// 2.1.0
new MarkerOptions().sprite()

// 2.2.0
new MarkerOptions().icon()

Besides, this is one of the reasons why we have have example code in MapboxGLAndroidSDKTestApp (aka "the Test App") so that people can see how things work. ;-)

In short, this is still the very early days of the SDK and API changes are to be expected. This one isn't large enough to warrant going up a full semver.

[bleege]

Just finished publishing 2.2.0 to Maven Central. It'll take a few hours for it to show up in http://search.maven.org/ though.

[bleege]

Tagged as android-v2.2.0 and pushed. Here's the commit tree for this tag:

https://github.com/mapbox/mapbox-gl-native/commits/android-v2.2.0

[bleege]

Finally landed in Maven Central --> https://repo1.maven.org/maven2/com/mapbox/mapboxsdk/mapbox-android-sdk/2.2.0/

[bleege]

Confirmed that 2.2.0 from Maven Central works as expected by loading into local copy of Android Demo App.

[bleege]

Just published the JavaDoc updates to https://www.mapbox.com/android-sdk/. Waiting for it to regenerate which should just take a few minutes.

[bleege]

JavaDocs are live!

Time to close this milestone and call it!

🍻

[Mansi26]

Hi..i am trying to center the Info window when the map is zoomed.
But ..i could not find any listener for zoom event.
Can anyone help..regarding how to do this...?
Could not find any projection class in 2.2.
Please help