/Geocaching4Locus

A Locus simple add-on allows you to download and import caches directly from Geocaching.com si­te.

Primary LanguageKotlinGNU General Public License v3.0GPL-3.0

Geocaching4Locus - Android application

Geocaching4Locus is a Locus add-on allows you to download and import caches directly from Geocaching.com site.

The latest stable release is under master branch. In dev branch are committed new features and bugfixes for upcoming version.

How to compile

The App require to have correct Geocaching API key and secret for OAuth2 authorization. Unfortunately Grounspeak (Geocaching API author) prohibits to store testing or production keys in a source code repository. Thus please contact me I can provide testing keys for you if you want to participate on app development.

Anyway the app require to set this in your global gradle.properties file (the file is placed usually in ~/.gradle/gradle.properties or C:\Users\username\.gradle\gradle.properties):

geocachingApiKey=<production_api_key>
geocachingApiSecret=<production_api_secret>
geocachingApiStaging=false

The <production_api_key> and <production_api_secret> is provided via Groundspeak's Geocaching Authorized Developers program

The App can be easily build by Gradle:

gradlew assembleDebug - create a debug APK
gradlew assembleRelease - create a release APK

AssembleRelease task will try to sign APK with a private key. To sign it, create gradle.properties configuration in your user gradle directory (usually ~/.gradle/gradle.properties or C:\Users\username\.gradle\gradle.properties):

storeFile=file:///path/to/keystore.keys or file://c:/path/to/keystore.keys 
storePassword=mykeystorepassword
keyPassword=mykeypassword  

The key name in a keystore must be geocaching4locus (or modify application build.gradle script). If the configuration for signing is missing, Gradle build script use ADK debug private key for signing.

Dependencies

Developed by

Other links

Licenses

Source code

Copyright (C) 2012 Martin Sloup, arcao.com

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

Graphics