OpenTrainApp

This is the android app for the Open Train project of the Public Information Workshop.

For more information, please visit:

http://wiki.hasadna.org.il/index.php?title=%D7%A8%D7%9B%D7%91%D7%AA_%D7%A4%D7%AA%D7%95%D7%97%D7%94

Building

./gradlew build
./gradlew installRelease

Signing

In order to sign the APK, you will want to create a 'gradle.properties' file. The content should look like the following except it should contain your key signing information:

StoreFile=<path to file>
StorePassword=<password>
KeyAlias=<key alias>
KeyPassword=<password>
GoogleAPIKey=<optional: your Google Maps API key>
MozAPIKey=test

To obtain a free Google API key:

1. Create an account on https://cloud.google.com/console.
2. Browse to the APIs & auth > APIs menu.
3. Enable the API name "Google Maps Android API v2". You do not need any of the other Google Maps API keys.
4. TODO: add instructions for registering your app certificate with Google's API console.*

To generate a signing key, search the internet for details. This command is probably what you want:

keytool -genkey -v -keystore my-release-key.keystore -alias mozstumbler -keyalg RSA -keysize 2048 -validity 10000

To verify the apk has been signed, you can run this command:

jarsigner -verify -verbose -certs build/apk/MozStumbler*

Releasing

This release process ought to be automated.

1. MOZSTUMBLER_VERSION=x.y.z
2. git checkout -b v$MOZSTUMBLER_VERSION
3. echo $MOZSTUMBLER_VERSION > VERSION
4. Increment android:versionCode and android:versionName in the AndroidManifest.xml.in file.
5. git commit -m "MozStumbler v$MOZSTUMBLER_VERSION" AndroidManifest.xml.in VERSION
6. Push the new version branch to GitHub and file a new pull requests so Travis can start building it.
7. ./gradlew build
8. mv build/apk/MozStumbler-release.apk build/apk/MozStumbler-$MOZSTUMBLER_VERSION.apk
9. Browse to https://github.com/dougt/MozStumbler/releases.
10. "Draft a new release" with the release title "MozStumbler v$MOZSTUMBLER_VERSION" and tag version "v$MOZSTUMBLER_VERSION".
11. Add some release notes and give @credit to contributors!
12. Drag and drop the new MozStumbler-v$MOZSTUMBLER_VERSION.apk to the "Attach binaries for this release by dropping them here." box.
13. Check "This is a pre-release" because perpetual beta.
14. Save draft. Do not "Publish release" yet because master does not have the new VERSION file!
15. Merge the new version pull request. NB: There is a race condition between steps 13 and 14! It is mostly harmless, but be quick about it.
16. Now go back to the draft release and Publish release.
17. Email a release announcment to the dev-geolocation mailing list with release notes giving @credit to contributors and a link to the release's page https://github.com/dougt/MozStumbler/releases/tag/v$MOZSTUMBLER_VERSION.
18. Good work!