Skip to content
This is an opensource succesor of c:geo
Java Other
Find file
Pull request Compare This branch is 7837 commits behind cgeo:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
main
send2cgeo
tests
.gitignore
LICENSE
README.md

README.md

c:geo is a simple yet powerful unofficial geocaching client for Android devices. In contrast to other similar applications, c:geo doesn't require a web browser nor file exports. You can just go geocaching with your phone and without any home preparation or worries. Of course, you can go without paying - it's free.

Get the source

Fork the project source code on github:

git clone git://github.com/cgeo/c-geo-opensource.git

Set up Eclipse

Build

Prerequisites

  • Android SDK r14 including Google APIs V8
  • Ant 1.6.0+ for building c:geo on the command line (not necessary when using only Eclipse)
  • If you use Microsoft Windows, Google USB Driver to install the application on the smartphone

Structure

c:geo sources and executables are located in the main directory. Tests are located in the tests directory.

Known limitations

If the workspace directory name contains a space and leads to errors in the -dex Ant target, then you need to set the property "basedir" in your local.properties to the 8.3 name of the directory where this script is located on your disk.

Configuration

  1. copy ./main/templates/private.properties to ./main/
  2. edit private.properties (see comments in the file)
  3. copy ./main/templates/local.properties to ./main/
  4. copy ./main/templates/local.properties to ./tests/
  5. edit local.properties (see comments in the file)
  6. copy ./main/templates/mapsapikey.xml to ./main/res/values/
  7. edit ./main/res/values/mapsapikey.xml and insert your Maps API key (see comments in the file)

Building with Ant

Run one of the following commands in ./main

ant help
ant clean
ant debug
ant release

or use the Ant view of Eclipse

Debugging

  1. Add android:debuggable="true" in the application settings of AndroidManifest.xml
  2. In Eclipse, create a Debug Configuration for an Android Application using the menu Run->Debug Configurations

Testing

The Test classes can be found in the project cgeo-os-test. Test classes should be located in the same package as the class under test. Every class can be "Run As" (or "Debug As") an "Android JUnit Test" from Eclipse. To run all tests use the test suite in CgeoTestSuite in package cgeo.geocaching.test. Further information can be found at http://developer.android.com/guide/topics/testing/testing_android.html

Code coverage / Emma

A code coverage report can be generated with Emma. A little how-to (german) can be found at http://www.blafoo.de/blog/index.php#param=id_32

License

c:geo is distributed under Apache License, Version 2.0.

Contact

Something went wrong with that request. Please try again.