Installing ODK-X Basic Tools

These instructions describe the steps to install the ODK-X basic tools on a tablet.

Prerequisites

You must have an Android tablet with an operating system version 4.4 or higher.

Before installing any of the ODK-X tools, you will need the following third party app:

Required

There are no other ODK-X Android tools that are prerequisites to installing ODK-X Services. However, this tool is a prerequisite for all the other ODK-X Android tools.

Installing Services

  1. From your device's Settings, choose Security.

  • Make sure Unknown Sources is checked.

  • (On older versions of Android, this setting is in Applications rather than Security)

  1. Open a web browser on your phone.

  2. Navigate to https://github.com/odk-x/services/releases/latest and download the latest ODK-X Services APK.

  3. In the download window, you will see ODK_Services_vN.N.N.apk. - Select it to download the file.

  • On older devices, the APK will automatically install after you approve the security settings.

  • On newer devices, you must go to the download list, rename the file to restore the .apk extension (the extension will have been renamed to .man during the download process), then click on it to install it.

Note

You can also download the ODK-X Services APK to your computer and load it on your device via adb or another tool like AirDroid.

Tip

You can also install ODK-X Services on an Android emulator. However, this can be slow and is only recommended for developers actively working on Services.

Installing the ODK-X Survey App

  1. From your device's Settings, choose Security.

  • Make sure Unknown Sources is checked.

  • (On older versions of Android, this setting is in Applications rather than Security)

  1. Open a web browser on your phone.

  2. Navigate to https://github.com/odk-x/survey/releases/latest and download the latest ODK-X Survey APK.

  3. In the download window, you will see ODK_Survey.N.N.apk. - Select it to download the file.

  • On older devices, the APK will automatically install after you approve the security settings.

  • On newer devices, you must go to the download list, rename the file to restore the .apk extension (the extension will have been renamed to .man during the download process), then click on it to install it.

Note

You can also download the ODK-X Survey APK to your computer and load it on your device via adb or another tool like AirDroid.

Tip

You can also install ODK-X Survey on an Android emulator. However, this can be slow and is only recommended for developers actively working on Survey.

Installing the ODK-X Tables App

  1. From your device's Settings, choose Security.

  • Make sure Unknown Sources is checked.

  • (On older versions of Android, this setting is in Applications rather than Security)

  1. Open a web browser on your phone.

  2. Navigate to https://github.com/odk-x/tables/releases/latest and download the latest ODK-X Tables APK.

  3. In the download window, you will see ODK_Tables.N.N.apk. - Select it to download the file.

  • On older devices, the APK will automatically install after you approve the security settings.

  • On newer devices, you must go to the download list, rename the file to restore the .apk extension (the extension will have been renamed to .man during the download process), then click on it to install it.

Note

You can also download the ODK-X Tables APK to your computer and load it on your device via adb or another tool like AirDroid.

Tip

You can also install ODK-X Tables on an Android emulator. However, this can be slow and is only recommended for developers actively working on Tables.