This repository contains a number of projects that will help you get up to speed with Google Maps v2 on Android with ActionBarSherlock 4.3.1
It contains the following folders
- GoogleMapsV2SkeletonV11 (Skeleton project targetted at API level 11 and higher)
- GoogleMapsV2SkeletonV8 (Skeleton project using Support Library targetted at API level 8 and higher)
- GoogleMapsV2WithActionBarSherlock (the complete sample application)
- ActionBarSherlock (The ActionBar we all love, available in this repository for your convenience.)
- google-play-services_lib (The Google Play Services lib, available in this repository for your convenience.)
Note : This project was created for Eclipse ADT so on the master branch you can checkout the projects, import them in Eclipse and you should be good to go. For people working with Android Studio, I've created a new branch called androidstudio_migration1
where you can checkout a Gradle enable version that you can import in Android Studio and get started immediately.
The tutorial guides can be found in the docs folder of this project. The sample application is part of a 6-part tutorial covering
- Setup a skeleton project
- Add the ActionBarSherlock and GooglePlayServices libs
- More
- Adding markers
- Highlighting markers
- Removing markers
- More
- Animate through a set of markers on the map
- More
- Some tips and tricks for migrating your old v1 apps to v2.
- A rundown of all the changes.
- More
- Use Google Places Autocomplete API
- Use Google Directions API
- Putting everything together.
- More
Important note:
In order to run this application on your phone you'll first need to get an API key.
Instructions on how to setup your API key can be found in the Setting up an Android Maps V2 Project article.
You'll need to paste the API key into your application manifest on the following line:
<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="INSERT_YOUR_API_KEY_HERE"/>
If you attempt to run an Android sample app with your own copy of ActionBarSherlock, you might run into the following issue:
Found 2 versions of android-support-v4.jar in the dependency list,
but not all the versions are identical (check is based on SHA-1 only at this time).
All versions of the libraries must be the same at this time.
Versions found are:
Path: C:\PROJECTS\Android\GoogleMapsV2WithActionBarSherlock\libs\android-support-v4.jar
Length: 484258
SHA-1: bd6479f5dd592790607e0504e66e0f31c2b4d308
Path: C:\PROJECTS\Android\ActionBarSherlock-4.3.1-0\actionbarsherlock\libs\android-support-v4.jar
Length: 271754
SHA-1: 53307dc2bd2b69fd5533458ee11885f55807de4b
Jar mismatch! Fix your dependencies
The reason being that 2 different Android Support Library v4 JAR files are present in the projects getting built. (one provided by ActionBarSherlock and one provided by your project). The solution is simple : Ensure that ActionBarSherlock is using the same version of the Android Support Library v4 JAR as the one your project is using.
In the enclosed ActionBarSherlock in this github repository the support JAR has already been replace. : https://github.com/ddewaele/GoogleMapsV2WithActionBarSherlock/tree/master/actionbarsherlock/libs