This project is actively maintained
It is part of the ODK 2.0 Android tools suite.
ODK Tables is a program that allows you to visualize and edit data, revisiting existing data and syncing it with an ODK Aggregate instance in the cloud.
Instructions on how to use Tables can be found here.
The Google group for software engineering questions is: opendatakit-developers@
Setting up your environment
General instructions for setting up an ODK 2.0 environment can be found at our DevEnv Setup wiki page
This project depends on ODK's androidlibrary and androidcommon projects; their binaries will be downloaded automatically fom our maven repository during the build phase. If you wish to modify them yourself, you must clone them into the same parent directory as tables. You directory stucture should resemble the following:
|-- odk |-- androidcommon |-- androidlibrary |-- tables
- Note that this only applies if you are modifying the library projects. If you use the maven dependencies (the default option), the projects will not show up in your directory.
Now you should be ready to build.
Building the project
Open the Tables project in Android Studio. Select
Build->Make Project to build the app.
Be sure to install ODK Services onto your device before attempting to run Tables.
When running tests from Android Studio, execute
adb shell pm grant org.opendatakit.tables android.permission.SET_ANIMATION_SCALE in the terminal first.
Source tree information
Quick description of the content in the root folder:
|-- tables_app -- Source tree for Java components |-- src |-- main |-- res -- Source tree for Android resources |-- java |-- org |-- opendatakit |-- tables -- The most relevant Java code lives here |-- androidTest -- Source tree for Android implementation tests