mendhak/gpslogger


satellite Lightweight GPS Logging Application For Android. Available on the Android Market as "GPSLogger for Android"

http://code.mendhak.com/gpslogger/

License: GPL-2.0

Language: Java

Keywords: android, android-sdk, dropbox, gps, gpslogger, intellij, java, logging, satellite


GPSLogger Build Status

GPSLogger is an Android app that logs GPS information to GPX, KML or text files and has options for annotating and sharing.

Read about GPSLogger's features here

Download

You can download it from Google Play.

You can download the APK directly from the releases.

The oldest Android 2.x release is here.

Contribute

You can help with translations

You can also submit pull requests for bug fixes and new features.

I'm not very good at UIs, so any work with the layouts would be appreciated!

License and policy

Licensed under GPL v2 | Third party licenses | Privacy policy

Donate

Bitcoin | Paypal

Verifying

It's good practice to verify downloads. In recent releases, a PGP signature and an SHA256 checksum will accompany each .apk.

Import PGP Public Key from Keybase.io or just gpg --recv-key 6989CF77490369CFFDCBCD8995E7D75C76CBE9A9

To verify the integrity and signature:

$ gpg --verify ~/Downloads/gpslogger-71.apk.asc

To verify checksum:

$ sha256sum -c ~/Downloads/gpslogger-71.apk.SHA256

Setting up the code

The project is based on the Android build system plugin for Gradle. Feel free to adopt and document your own OS and IDEs. These instructions are for Ubuntu Linux with IntelliJ IDEA.

Set up your Android Development Environment

Follow the instructions on the Android Developer Website to set up your computer for development.

On Ubuntu 64bit, you may also need ia32-libs, follow these instructions. I did not need this for Ubuntu 14.04.

intellij

Download and install IntelliJ IDEA Community Edition, which is free. Note that the Android build system version 0.9 does not work well with anything earlier than IntelliJ 13.1.2.

Get the Android SDK extra repositories

This project uses certain Google libraries, you will need to add them. Run

<AndroidSDK>/tools/android

Which brings up the Android SDK manager. In here, choose

  • Tools > Android SDK build tools
  • Extras > Android Support Repository
  • Extras > Android Support Library
  • Extras > Google Play services
  • Extras > Google Repository

Clone the GPSLogger repository

git clone git://github.com/mendhak/gpslogger.git

Create local.properties

IntelliJ/Android Studio may not detect your ANDROID_HOME environment variable, so create a file called local.properties, pointing at your Android SDK directory.

cd gpslogger
echo "sdk.dir=/home/mendhak/Programs/Android" > local.properties

Import the project

Open up IntelliJ and choose to import a project. Select the topmost build.gradle file under GPSLogger.

If you get an Import dialog, choose to Import project from external model

import

On the next screen, choose the defaults and proceed (default gradle wrapper)

import

Give it a minute and IntelliJ/Gradle will configure the projects and download the various libraries.

IntelliJ may not know where your Android SDK is. You can find this under File > Project Structure... where you should set the Project SDK. You will want to use Java 1.6 with Android 4 or above.

OpenStreetMap Setup (Optional)

Sign up for an account with OpenStreetMap and log in.

Click on 'oauth settings'

Click on 'Register your application'

Fill in the form with these details

Oauth settings

After registering the application, you will receive a 'Consumer Key' and a 'Consumer Secret'.
Place the keys in your ~/.gradle/gradle.properties like this:

GPSLOGGER_OSM_CONSUMERKEY=abcdefgh
GPSLOGGER_OSM_CONSUMERSECRET=1234123456

Dropbox Setup (Optional)

Sign up for an account with Dropbox.com

Go to the Dropbox Developers page and click on 'Create an App'

Use these settings, but choose a unique name

Dropbox settings

After creating the app, you will receive an app key and secret (the ones in the screenshot are fake)

Dropbox settings

Place the keys in your ~/.gradle/gradle.properties like this:

GPSLOGGER_DROPBOX_APPKEY=abcdefgh
GPSLOGGER_DROPBOX_APPSECRET=1234123456

Replace the Dropbox app key to your AndroidManifest.xml file

<!-- Change this to be db- followed by your app key -->
<data android:scheme="db-12341234"/>

Google Docs/Drive Setup (Optional)

Go to the Google APIs Console and create a new project.

After registering a project, click on API Access and click the 'Create another Client ID' button

Choose "Installed Application" and then under Installed Application Type, choose "Android". Follow the instructions under Learn More to specify the package name and the SHA1 fingerprint of your debug certificate.

GAPI Console

The Google Docs feature requires the Google Play Services Framework, so ensure that the emulator you are using is Android 4.2.2 (API level 17) or greater if you want to use this feature.

AVD

You can also debug directly against your phone - all phones Android 2.2 and above should have this framework installed.

Overview

GPSLogger is composed of a few main components;

design

Event Bus

The Event Bus is where all the cross communication happens. Various components raise their events on the Event Bus, and other parts of the application listen for those events. The most important one is when a location is obtained, it is placed on the event bus and consumed by many fragments.

GPS Logging Service

GPSLoggingService is where all the work happens. This service talks to the location providers (network and satellite). It sets up timers and alarms for the next GPS point to be requested. It passes location info to the various loggers so that they can write files. It also invokes the auto-uploaders so that they may send their files to Dropbox, etc.

It also passes information to the Event Bus.

GPS Main Activity

This is the main visible form in the app. It consists of several 'fragments' - the simple view, detailed view and big view.

It takes care of the main screen, the menus and toolbars.

The fragments listen to the Event Bus for location changes and display it in their own way.

Session and AppSettings

Floating about are two other objects. Session contains various pieces of information related to the current GPSLogger run, such as current file name, the last known location, satellite count, and any other information which isn't static but is needed for the current run of GPSLogger.

AppSettings is a representation of the user's preferences.

These objects are visible throughout the application and can be accessed directly by any class, service, activity or fragment.

Project Statistics

Sourcerank 9
Repository Size 19.6 MB
Stars 868
Forks 401
Watchers 106
Open issues 55
Dependencies 3
Contributors 18
Tags 60
Created
Last updated
Last pushed

Top Contributors See all

mendhak Bernhard Froehler dlichtistw Francisco Reynoso tsteven4 Jeroen van Wilgenburg Maribel D gusr Xinxin Jin Fi156 Szymon Sobik Jonas Schmid Philip Manavopoulos ciakpey cwarren-qc JJ Ford Clyde Balneaves Gastón I. Silva

Recent Tags See all

v101 March 03, 2019
v100 March 03, 2019
v99 December 13, 2018
v98 December 12, 2018
v97 September 30, 2018
v96 September 01, 2018
v95 May 27, 2018
v94 March 26, 2018
v93 March 10, 2018
v92 February 11, 2018
v91 January 11, 2018
v90 November 08, 2017
v89 August 20, 2017
v88 June 10, 2017
v87 May 01, 2017

Interesting Forks See all

achtgrad/gpslogger
Lightweight GPS Logging Application For Android. Available on the Android Market as "GPSLogger fo...
Java - Updated - 2 stars - 1 forks
minjaef1003/gpslogger
satellite Lightweight GPS Logging Application For Android. Available on the Android Market as "...
Java - GPL-2.0 - Updated - 1 stars
beaugrantham/gpslogger
📡 Lightweight GPS Logging Application For Android
Java - GPL-2.0 - Last pushed - 1 stars
lnora/gpslogger
Lightweight GPS Logging Application For Android. Available on the Android Market as "GPSLogger fo...
This repository is no longer available - 1 stars
qm0937/gpslogger
Lightweight GPS Logging Application For Android. Available on the Android Market as "GPSLogger fo...
Java - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2017-01-01 08:20:57 UTC

Login to resync this repository