Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit 8f4f46b Aug 13, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
apk Merging code May 5, 2015
app Merging code May 5, 2015
doc Merging code May 5, 2015
gradle/wrapper Merging code May 5, 2015
.gitignore Merging code May 5, 2015
ARMM_Android.iml Merging code May 5, 2015
README.md Update organization URLs Aug 13, 2017
build.gradle Merging code May 5, 2015
gradle.properties Merging code May 5, 2015
gradlew Merging code May 5, 2015
gradlew.bat Merging code May 5, 2015
keystore.jks Merging code May 5, 2015
license.txt Create license.txt Dec 22, 2015
settings.gradle Merging code May 5, 2015

README.md

Mobile Android Survey App

Mobile Android Survey App is a mobile application to download web surveys, allow offline entry and upload collected submissions to a Drupal Survey Platform https://github.com/symph-team/open-survey-platform

Android Version

The app supports devices running Android 4.0 (API 14) and higher.

Android Permissions

The app uses the following Android features:

  • com.google.android.maps
  • android.hardware.camera
  • android.hardware.camera.autofocus

The app requires the following Android permissions:

  • android.permission.CAMERA
  • android.permission.INTERNET
  • android.permission.READ_CONTACTS
  • android.permission.WRITE_SETTINGS
  • android.permission.READ_EXTERNAL_STORAGE
  • android.permission.WRITE_EXTERNAL_STORAGE
  • android.permission.CHANGE_WIFI_STATE
  • android.permission.ACCESS_WIFI_STATE
  • android.permission.ACCESS_NETWORK_STATE
  • android.permission.ACCESS_FINE_LOCATION
  • android.permission.ACCESS_COARSE_LOCATION

These permissions and features are defined in project's AndroidManifest.xml file.

Login Tab

Before the user can begin collecting surveys, they are required to login to the app using their OpenEd account credentials.

login

If the user needs to create an OpenEd account or forgots their password, they can visit /user/login.

Survey Tab

The Survey tab lists the available surveys that the user can input results for.

surveys

Pulling down on the Survey list or clicking the Refresh button in the action bar will download new or modified surveys from the server.

Incomplete Tab

The Incomplete tab lists all the surveys not currently completed.

incomplete

Note, surveys in the Incomplete list can not be submitted until all the required questions have been answered.

Completed Tab

The Completed tab lists all surveys that have been completed but not yet submitted or have been submitted.

completed

Question Types

The app supports the following question types:

textfield - plain text

textfield

textarea - multiline text

textarea

number - numerical input

number

email - email address input

email

select - single choice select

select

grid - collection of single choice select

grid

date - date in format yyyy-MM-dd

date

time - time in format HH:mm:ss

time

markup - read only HTML message

textarea

geofield - location detection

geofield

file - upload of photos

file

fieldset - collection of sub questions

fieldset

Secondary Menu

Each question type has a secondary menu to provide contextual help, for example changing the keyboard type or clearing the current result.

fieldset

Required Questions

Surveys with questions marked as required, will require the user to provide an answer before they can continue moving to the next question of the survey.

fieldset

Surveys with required questions will not be allowed to be submitted until all the required questions have a valid answer.

Survey Details

You can view collected survey results by clicking an item in the Incomplete or Complete tab.

fieldset

App Logout

The app currently only supports single user usage. For another user to use the app, the current user must first logout, by clicking Logout from the secondary menu in the action bar. Note, this will delete the current items from the database as well as remove any user information, requiring login again.

Style Resources

The style resources are defined in the styles.xml file. You can customize these styles following the Android style resource conventions.

String Resources

The string resources are defined in the strings.xml file. You can change these string values following the Android string resource conventions. To add translations to the app, please following the Android Supporting Different Languages guidelines.

Color Resources

The color resources are defined in the colors.xml file. These colors can be customized by changing the hexcode values following the Android color resource conventions.

ActiveAndroid Database

The app uses ActiveAndroid library has a database ORM, learn more at https://github.com/pardom/ActiveAndroid.

Fabric Crashlytics

Fabric Crashlytics is a free error reporting service developed by the team at Twitter. The API key is specified under com.crashlytics.ApiKey in the AndroidManifest.xml file.

Google Maps API

The app uses Google Maps Android API v2, which requires an API key from Google. The API key is specified under com.google.android.maps.v2.API_KEY in the AndroidManifest.xml file.

Library Dependencies

The app requires the following external libraries:

  • com.android.support:support-v4:21.0.3
  • com.android.support:support-v13:21.0.2
  • com.android.support:appcompat-v7:21.0.3
  • com.android.support:recyclerview-v7:21.0.2
  • com.android.support:cardview-v7:21.0.2

The app requires the following local libariries:

  • libs/ActiveAndroid.jar
  • libs/httpcore-4.3.3.jar
  • libs/httpmime-4.3.6.jar

Note, both the external and local libraries are defined in the build.gradle file.

For additional questions about this and project and other Open Government Projects, please visit: https://github.com/symph-team.

You can’t perform that action at this time.