Version 8 (modified by Fran Boon, 6 years ago) ( diff )


Development Environment

Table of Contents

    Eden Mobile is built on the Apache Cordova platform (sometimes known as Adobe PhoneGap).

    1. Cordova runs on NodeJS. If your OS distribution does not provide a NodeJS bundle, you can get one from here:
    1. Use the NodeJS package manager npm to install Cordova:
    npm install -g cordova 

    See also:

    1. If you want to build and test EdenMobile, you also need
      • Java JDK
      • an SDK for the target platform, e.g.: Android SDK
        • Configure as per
        • Ensure the SDK tools are in your PATH, e.g. for Windows 10:
          • %USERPROFILE%\AppData\local\android\sdk\platform-tools
          • %USERPROFILE%\AppData\local\android\sdk\tools
        • Ensure that ANDROID_HOME environment variable is set, e.g. for Windows 10:
          • %USERPROFILE%\AppData\local\android\sdk
    1. You can fork/clone EdenMobile from here:
    1. Run the application
    • You canot run in the 'browser' platform as it doesn't support the local database
    • It is easier to run on a real device than the emulator
    • to run on a real device, you need to enable 'Developer Options' by tapping 7 times on the 'Build Number' in the About section ( and then open the new Developer Options panel & enable USB Debugging
    • to run on emulator you need to create an avd: android avd
      cd eden_mobile
      npm install q-io
      cordova platform add android
      adb uninstall org.sahanafoundation.eden_mobile # Shouldn't be required but can be for some systems
      cordova run android # Builds apk & adb install platforms\android\build\outputs\apk\android-debug.apk
    1. Build for Release
      • Configure the default server, if-required: www/config/settings.js
        'url': {
                type: 'url',
                defaultValue: '',
                writable: false,
      • @ToDo: Branding
      • create the non-debug APK
        cd eden_mobile
        cordova build --release android
      • File available as: platforms/android/build/outputs/apk/android-release-unsigned.apk
      • Sign the app:
          # Generate Private Key (just once, outside the eden_mobile folder)
          # keytool comes with your JRE, so may need to ensure it's bin directory is in your PATH
          keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias
          # Optimise (zipalign comes with Android SDK build-tools, so may need to ensure it's in your PATH, e.g. %USERPROFILE%\AppData\local\android\sdk\build-tools\25.0.2)
          zipalign -v -p 4 android-release-unsigned.apk android-release-unsigned-aligned.apk
          # Sign (apksigner comes with Android SDK build-tools too)
          apksigner sign --ks my-release-key.jks --out android-release.apk android-release-unsigned-aligned.apk

    Attachments (1)

    Download all attachments as: .zip

    Note: See TracWiki for help on using the wiki.