Table of Contents

andRoc Development

Content → Mobile Clients → andRoc


Do not translate this wiki page: for developers only.


The Android based wireless client for Rocrail.



Project details

Target Android 1.6+
Branch https://code.launchpad.net/~rocrail-project/rocrail/androc (lp:rocrail/androc)
Bug reporting https://bugs.launchpad.net/rocrail/androc
Commits http://bazaar.launchpad.net/~rocrail-project/rocrail/androc/changes
Translations https://translations.launchpad.net/rocrail/androc/+pots/androc



Translations

Android string.xml files are in the DocBook XML format.
The conversion between .xml and .pot/.po, to make it available in LaunchPad, is done with the xml2po utility.


Open issues

  • Reconnect after losing connection. (WIP)
  • Clear activity stack after a Rocrail server quit message.


ToDo

  1. Switching monitoring on/off at run time. → Needs new Rocrail request.
  2. Background color option for the LEDButton widget.


Nice to have

  1. SVG symbol support.
  2. Scaling layout with multi touch gestures. and/or with Zoom buttons
  3. Layout background color selection. Example dialog


Snapshot

For testers and developers.

  1. Download the latest snapshot of andRoc-revxxx.apk with the Android web browser. → snapshots.rocrail.net
  2. Touch the downloaded andRoc-revxxx.apk to install.
  3. Ready to run.


Building

Following tools are needed to build andRoc:

  • Eclipse
  • Ant
  • Android Eclipse plugin
  • Android SDK


Get the sources

bzr branch lp:rocrail/androc andRoc


Eclipse

  1. Import the Android as a project in Eclipse.
  2. Set Project → Build automatically
  3. Right-click the project in the Package Explorer and select Android tools → Export signed application package…
  4. The andRoc.apk package is found in the release directory of the project.


Ant

Create the build.xml file in the andRoc directory with the android tool: 

cd lp/andRoc
android update project --path . --target 2

Release the application: 

cd lp/andRoc
and clean release


Releasing

Export an unsigned .apk from Eclipse:

  • Right-click the project in the Package Explorer and select Android Tools → Export Unsigned Application Package.
keytool -genkey -v -keystore androc-release-key.keystore -alias androc -keyalg RSA -validity 10000
jarsigner -verbose -keystore ../lp/androc-release-key.keystore andRoc.apk androc
~/android-sdk-linux_86/tools/zipalign -v 4 andRoc.apk andRoc-rev91.apk



Visibility

The android:targetSdkVersion=“4” must also be set in the Manifest file to get visible for 1.6+ devices in the Market App.

Links


Personal Tools