/GLEXP-Team-KitkitSchool

Primary LanguageC++Apache License 2.0Apache-2.0

Kitkit School

Kitkit® School (phase 3) consists of 13 apps as following:

  1. Launcher
  • A home screen app, from where other apps are launched.
  1. Lock Screen
  • This app appears when the device wakes up.
  • The device will be unlocked by touching the Kitkit School icon in the middle.
  1. Library
  • A collection of videos and books for children to enjoy.
  • Video will play in place, while a separate book viewer will open to read a book.
  1. Book Viewer
  • Book viewer app, which reads aloud most of books. The app will also read each word when one is touched.
  1. Main App
  • Main learning app with tailored curriculum.
  1. Blackboard
  2. Drawing
  3. Drum
  4. Marimba
  5. Writing Board
  6. Sea World
  7. Voice Engine (for English only)
  8. gallery
  • Additional tools/toys as rewards

Most of the apps above share code from kitkitshcoollogger

  1. KitkitSchoolLogger
  • not a stand-alone app, but the code is shared among other apps

Book Viewer and MainApp are made upon cocos2d-x engine, while others are native Android apps written in Java

Build Environment

Android studio and Android NDK is necessary to build the APKs. Be sure to use the specified versions mentioned below, to avoid errors. Android studio will also ask to install the relavent SDKs and build tools that are missing - please install them along the way.

  1. Download Android Studio
  1. Download Android NDK (r14b, except for voice-engine which uses r16b)

Copy Resources/Engine Files

Download the relavent resources/3rd party files from the release assets (v1.3)

  • to build "mainapp", place the resources/3rd party files in the following folders

    • cocos2d ROOT/mainapp/cocos2d
    • common resources (mainapp_resources) ROOT/mainapp/Resources
    • language specific resources (pick only one)
      • mainapp_en_us (for English) ROOT/mainapp/Resources/localized/en-us
      • mainapp_sw_tz (for Swahili) ROOT/mainapp/Resources/localized/sw-tz
  • to build "seaworld", place the cocos files in the following folder

    • cocos2d ROOT/seaworld/cocos2d
  • to build "bookviewer", place the cocos files in the following folder

    • cocos2d ROOT/bookviewer/cocos2d
  • to build "library", pick (only) one of the language specific resource files in the following folder

    • library_en_us (for English) ROOT/library/localized/en-us
    • library_sw_tz (for Swahili) ROOT/library/localized/sw-tz

Build the APKs

Build with Android Studio

  • don't forget to set the NDK folder
  • set the appropriate 'Build Variant'
    • mainapp : generalDebug
    • launcher, library, bookviewer : swahiliDebug or englishUSDebug (or englishDebug)
    • others : debug
  • build variant of kitkitlogger will be set automatically (release)
  • from the top menu, choose Build > Build APK

The resulting APK will be generated in app/build/outputs/apk/[appname]-[language]-debug.apk

Install & Run the APKs

Install all the APKs, then start the Kitkit Launcher to explorer.

  • Please make sure there is enough storage on the device.
  • Most of the APKs will not show up in the android (default) launcher.

Trademarks

Kitkit School, name and logo, and Enuma are trademarks of Enuma, Inc. The Apache License 2.0 under which Kitkit School software is released does not grant any license or right to use the trademarks. Please see Guidelines for Trademarks to learn more about the terms.

Kitkit and Enuma are trademarks of Enuma, Inc., registered in the U.S. and other countries.

Questions?

Do you have questions about the code, content or data? Please reach out to the Global Learning XPRIZE Community.

Copyright 2018 Enuma, Inc

Licensed under the Apache License 2.0 and the Creative Commons Attribution International 4.0 License (the “Licenses”); you may not use these files except in compliance with the Licenses.