INSTALL-STANDALONE.md

Building RoboTutor

Last updated: May 6, 2019

Overview

The installation steps mentioned below will allow you to set up RoboTutor as a standalone application without installing the RoboLauncher and RoboTransfer applications.

Note:

1. The installation instructions work for both Windows 7 and newer and macOS X (Mavericks or newer).
2. Terminal in macOS X is referred to as Command Prompt in Windows OS.
3. Use batch scripts (.bat files) for Windows OS and shell scripts (.sh files) for macOS X.

Requirements

1. Ensure you have adb installed on your computer. To do this, follow the steps in this helpful guide.
2. Connect your device to the computer via USB.

1. Device preparation

Enable developer mode on your device

1. Go to Settings --> About tablet.
2. Tap Build Number 7 times until it displays "You are now a developer".

Enable USB Debugging on your device

1. Go to Settings --> Developer options.
2. Tap Enable USB debugging.
3. Tap OK when prompted with a disclaimer.
4. You should see a dialog with your computer's "RSA key fingerprint".
5. Tap Always allow from this computer.
6. Tap OK.

2. Assets preparation

Preparing the assets for the English version

1. Clone the EnglishAssets repository:

    git clone https://github.com/XPRIZE/GLEXP-Team-RoboTutor-EnglishAssets.git
   

2. Execute the following scripts to push English assets to your Android device:

   • PUSH_English_StoriesAudio.bat (or PUSH_English_StoriesAudio.sh)
   • PUSH_English_TutorAudio.bat (or PUSH_English_TutorAudio.sh)

Preparing the assets for the Swahili version

1. Clone the SwahiliAssets repository:

    git clone https://github.com/XPRIZE/GLEXP-Team-RoboTutor-SwahiliAssets.git
   

2. Execute the following scripts to push Swahili assets to your Android device:

   • PUSH_CodeDrop1_LitAudio_SW.sh
   • PUSH_CodeDrop1_NumberStories_SW.sh
   • PUSH_CodeDrop1_NumberStories_SW.sh
   • PUSH_CodeDrop1_Songs_SW.sh
   • PUSH_CodeDrop2_DemoVideos.sh
   • PUSH_CodeDrop2_Icons.sh
   • PUSH_CodeDrop2_MathStories.sh
   • PUSH_CodeDrop2_Original_SW.sh
   • PUSH_CodeDrop2_PuncStories.sh
   • PUSH_CodeDrop2_ReadingStories_SW.sh
   • PUSH_CodeDrop2_Tutors_SW.sh

3. Pushing configuration file

Pushing the configuration file for the English version

1. Clone the RoboTutor repository:

    git clone https://github.com/XPRIZE/GLEXP-Team-RoboTutor-RoboTutor.git
   

2. To push the configuration file, execute the configure_english.sh script.

Pushing the configuration file for the Swahili version

1. Clone the SystemBuild repository:

    git clone https://github.com/XPRIZE/GLEXP-Team-RoboTutor-SystemBuild.git
   

2. To push the configuration file, execute the following command from Terminal:

    adb push config_sw/config.json /sdcard/Download
   

Note: The configuration file needs to be stored in the Download folder on sdcard since the application searches for it in Download folder.

4. Building and installing the RoboTutor app

1. Ensure that you have installed Android Studio.

2. Open Android Studio and import the RoboTutor project.

3. Install the different versions of the Build Tools and Android SDKs as prompted by Android Studio.

4. Go to Run and select the Run 'app' option. This will install the RoboTutor application onto your Android device.
   Alternatively, you can build the APK by selecting Build and then Make Project. Copy the APK generated in app/build/outputs/apk folder to your Android device and install it.

5. Launch the RoboTutor app from the app drawer.