Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
apk
May 5, 2015
app
May 5, 2015
doc
May 5, 2015
May 5, 2015
May 5, 2015

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.

About

No description, website, or topics provided.

Resources

License

Releases

No releases published

Packages

No packages published

Languages