-
Notifications
You must be signed in to change notification settings - Fork 367
Developer Guide
GPSTest is open-source, and therefore you can build it from code yourself!
First, you'll need a JDK installed. I recommend JDK 1.6.
Next, I suggest you use Eclipse for an IDE (The "EE" version is suggested). You'll also need the Android SDK and Android Plugin for Eclipse.
The GPSTest is versioned using Git, so you can use your favorite Git client or the Eclipse Git Plugin "EGit" to clone the repository
Here's the Github repo:
https://github.com/barbeau/gpstest.git
If you plan on submitting improvements, I suggest you fork this project (instead of cloning this repo directly) and work off of your forked repo so you can commit to your own GPSTest repository and use Github's Pull Request feature to submit improvements for review.
Then, in Eclipse do File->Import->Android->Existing Android Code Into Workspace, and point to the directory where you cloned the repo.
Since ActionBarSherlock (ABS) is used to support the Action Bar on older Android devices, you'll also need to import the ABS project included in the repo - so, again do File->Import->Android->Existing Android Code Into Workspace and point to the ActionBarSherlock folder within the main project.
And, the Google Play Services SDK is used for the Android Maps API v2, you'll also need to import this project include in the repo - so, do File->Import->Android->Existing Android Code Into Workspace again and this time point to google-play-services_lib folder within the main project.
At this point its a good idea to clean all the projects. Then, build the ActionBarSherlock project. Then, build the Google Play Services SDK project. Finally, build GPSTest.
Then, run the Android project on your device or an Android emulator.
NOTE - To run GPSTest when using the Google Play services SDK and Google Maps API v2, you must use either:
- A compatible Android device that runs Android 2.2 or higher and includes Google Play Store.
- The Android emulator with an AVD that runs the Google APIs platform based on Android 4.2.2 or higher.
To see map tiles when using the Google Maps v2 API under debug mode, you'll need to get your own Maps v2 API key via the Google API console and configure it for your debug key - see these instructions. You can replace the current key with your own key in the AndroidManifest.xml file.
If the projects won't compile, check the Properties->Android tab for the GPSTest project, and make sure the two library projects (ActionBarSherlock and Google Play Services) are included as library references. If they aren't, remove whatever projects are listed there and re-add these two projects. Then, clean all the projects and rebuild them as stated above.
Have questions about GPSTest? See our Frequently Asked Questions (FAQ) page to see if they've been answered there.
Please feel free to ask questions on the GPSTest Google Group: https://groups.google.com/forum/#!forum/gpstest_android