Skip to content
Branch: master
Clone or download
Latest commit bef02a8 Dec 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
services_app Upgrade gradle, libraries, and version (#109) Sep 26, 2018
.gitignore remove google-servieces.json from gitignore Sep 6, 2018
gradlew update to android plugin 2.3.1 and gradle 3.3 Apr 7, 2017
gradlew.bat update to android plugin 2.3.1 and gradle 3.3 Apr 7, 2017
settings.gradle Version bump Dec 13, 2018


This project is actively maintained

It is part of the ODK 2.0 Android tools suite.
Prior to rev 200, this repo was the core repo.

It is an APK that provides services (database, content providers, local webserver) used by all the other ODK 2.0 tools.

The developer wiki (including release notes) and issues tracker are located under the opendatakit project.

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

Install Android Studio and the SDK.

This project depends on the ODK androidlibrary project; its binaries will be downloaded automatically fom our maven repository during the build phase. If you wish to modify that project yourself, you must clone it into the same parent directory as services. You directory stucture should resemble the following:

    |-- odk

        |-- services

        |-- androidlibrary
  • Note that this only applies if you are modifying androidlibrary. If you use the maven dependencies (the default option), the project will not show up in your directory.

Now you should be ready to build.

Building the project

Open the Services project in Android Studio. Select `Build->Make Project' to build the app.


If the project builds properly, it should be able to run on an Android device without any other prerequisites.

Source tree information

Quick description of the content in the root folder:

|-- services_app     -- Source tree for Java components

    |-- src

        |-- main

            |-- res     -- Source tree for Android resources

            |-- java

                |-- org

                    |-- opendatakit  -- The most relevant Java code lives here

        |-- androidTest     -- Source tree for Android implementation tests
        |-- test            -- Source tree for Java JUnit tests
You can’t perform that action at this time.