Sunbird Mobile

Introduction

The Sunbird Mobile app provides mobility to its feature-rich learning platform. It provides learners with the flexibility to learn anywhere, anytime.

Prerequisites

To set up the Sunbird Mobile app, ensure you have installed the following:
- NPM version: 6+
- Node JS version: 8+
- Cordova version: 8+
- Ionic version: 4.11.2
Generate the key and secret for the mobile app user using the JWT token of the mobile admin user. Run the OnboardConsumers Jenkins Job and take the JWT token (JWT token for mobile_admin) from Jenkins output.

Generating Secret: Execute the listed API to generate the key and secret for the mobile app:

curl -X POST \ <your-sunbird-base-url>/api/api-manager/v1/consumer/mobile_app/credential/register \ -H ‘authorization: Bearer <mobile_admin_jwt_token_from_jenkins_job_output>’ \ -H ‘content-type: application/json’ \ -d ‘{ “request”: { “key”: “<implementation-name>-mobile-app- <version-number>” } }’

Response body:

{“result”:{“key”:”<implementation-name>-mobile-app-<version-number>”,”secret”:”<secret>”}}

Use the key and secret from the response given for MOBILE_APP_KEY and MOBILE_APP_SECRET configuration in respective environments in the gradle.properties file. Example:

dev_mobile_app_key = “<implementation-name>-mobile-app-<version-number>” dev_mobile_app_secret = “<secret>“

Producer Key

Replace the producer id PRODUCER_ID for respective environments in sunbird.properties.

Fabric credentials:

Replace release_fabric_api_key in sunbird.properties with your fabric API Key. Create an account in fabric.io and register in the app to get the API key.

Set up mobile app workspace from Git Repository

Sunbird mobile app can be built from the main source code, which is available at SunbirdEd-mobile-app.

Clone the SunbirdEd-mobile-app repo
Customising App Configuration - sample.sunbird.properties file is located inside the SunbirdEd-mobile-app > buildConfig folder. The file must be renamed to sunbird.properties, and appropriate values should be provided.
Package the framework and form data.
go to the project folder and run ./build.sh

Customising App Configuration

Instance admin of Sunbird adopters can configure various aspects of the Sunbird mobile app based on the requirements of the organization. The admins are able to configure various aspects, such as:

App name
App logo
Login/Guest page to new users
Sign in footer card on the app
Onboarding cards
Categories in the profile page

S NO.

VARIABLE NAME

DESCRIPTION

PURPOSE

DEFAULT VALUE

dev_app_id/staging_app_id/production_app_id

The app ID in the SunbirdEd-mobile-app/buildConfig/sunbird.properties file with the implementation-specific application ID

To change the app ID

appId: “org.sunbird.app”

app name

Navigate to the SunbirdEd-mobile-app/config.xml file and enter the required app name

To change the app name

app logo

Navigate to SunbirdEd-mobile-app/resources/android/icon

Replace the ic_launcher.png image with your desired logo in all the mipmap and drawable folders. The logo name should be drawable-ldpi-icon.png

To change the app logo

splash image

Navigate to SunbirdEd-mobile-app/resources/android/splash

Replace the drawable-ldpi-icon.png, drawable-hdpi-icon.png, drawable-xhdpi-icon.png image with your desired image.

To change the splash image

app

Set the configuration variable in the SunbirdEd-mobile-app repo file in the buildConfig folder

app version code

Version code for the app release

To customize the end points in the app

Replace redirect base url REDIRECT_BASE_URL and all other base urls with your respective domain name in sunbird.properties

deep link schema

This plugin handles deeplinks on iOS and Android for both custom URL scheme links and Universal App Links. Deep link schema can be changed from sunbird.properties

Change the “dev_deeplink_base_url = dev.open-sunbird.org” to the required name

display_onboarding_page

set the configuration variable inside the SunbirdEd-mobile-app repo inside buildConfig folder

to display the onboarding page

false

display_signin_footer_card_in_course_tab_for_teacher

set the display_signin_footer_card_in_course_tab_for_teachervariable as true in sunbird.properties file

to show the sign-in footer in the course tab for teachers

false

display_signin_footer_card_in_library_tab_for_teacher

Set the display_signin_footer_card_in_library_tab_for_teacher variable true in sunbird.properties file

to show the sign-in footer in the library tab for teachers

false

display_signin_footer_card_in_profile_tab_for_teacher

Set the display_signin_footer_card_in_profile_tab_for_teacheras true in sunbird.properties file

to show the sign-in footer in the profile tab for teachers

false

display_signin_footer_card_in_profile_tab_for_student

Set the display_signin_footer_card_in_profile_tab_for_studentas true in sunbird.properties file

to show the sign-in footer in the profile tab for students

false

display_signin_footer_card_in_library_tab_for_student

Set the display_signin_footer_card_in_library_tab_for_studentas true in sunbird.properties file

to show the sign-in footer in the profile tab for students

false

display_onboarding_card

set the display__onboarding_cards as true in sunbird.properties file

to display the guest/login page

false

display_framework_categories_in_profile

set the display_framework_categories_in_profile variable as true in sunbird.properties file

to display categories in the guest/login page

false

track_user_telemetry

Variable used to track user telemetry.

Used to track telemetry that is missing at the device level so as to generate greater usage context within the instance. Set the variable as true in the sunbird.properties file to enable tracking.

false

content_streaming_enabled

Variable used to enable content streaming

Used to enable content streaming. Set the variable as true in the sunbird.properties file to enable content streaming

false

open_rapdiscovery_enabled

Variable used to enable OPENRAP discovery

Used to enable OPENRAP discovery. Set the variable as true in the sunbird.properties file to enable OPENRAP discovery

false

display_onboarding_category_page

Variable used to enable onboarding category selection page

Used to onboarding category selection page in the onboarding process. Set the variable as true in the sunbird.properties file to enable onboarding category selection page.

false

display_onboarding_scan_page

Variable used to enable onboarding scan page.

Used to enable onboarding scan page in the onboarding process. Set the variable as true in the sunbird.properties file to onboarding scan page

false

support_email

Variable used to set

Used to set the support email id. Set the variable as <valid_email_id> in the sunbird.properties file to set support email id

<valid_email_id>

dev_custom_scheme/staging_custom_scheme/production_custom_scheme

Scheme used to redrirect chrome custom tab back to mobile app

“org.sunbird.app”

Packaging Framework and Form Data

Sunbird mobile app supports configuration of the app framework to enable offline usage of the app. To configure the app framework, adopter needs to package the channel for the respective framework. Details of the file naming convention and folder location are given below:

S NO.

FOLDER

FILE NAME

PURPOSE

buildConfig/data/framework

framework-<FRAMEWORK_IDENTIFIER<.json

To package the channel for the respective framework. Same framework must be listed in the channel’s suggestedFramework list

buildConfig/data/channel

channel-<CHANNEL_IDENTIFIER>.json

To package the channel. To support offline usage custodianOrgId channel must be included in the bundle

buildConfig/data/form

pageassemble_course_filter.json

Page assemble filter for course

buildConfig/data/form

pageassemble_library_filter.json

Page assemble filter for library

buildConfig/data/system

<system-setting-custodianOrgId>.json

custodianOrgId channelid for the mobile app

buildConfig/data/system

system-setting-courseFrameworkId.json

courseFrameworkId for the TPD workflow

buildConfig/data/notificationconfig

local_notofocation_config.json

Configuration for local Notification setup in mobile

Installing the Mobile Application

To install the Sunbird Mobile app, follow the steps below:

Create a workspace (Folder Hierarchy) and clone the Git repositories into this folder
Execute the instructions mentioned for each cloned repository
Open terminal and change the directory to “SunbirdEd-mobile-app”
Add one device to the system
Run the command - $ ionic cordova run android

Generate Multiple Sunbird Apps

Sunbird instance owners should be able to generate multiple apps for multiple environments (dev/qa/production) so that user can use all the apps simultaneously. For each app, user should be able to have different content stores (on the local device), fire telemetry from separate app identifiers and upload to the play store (if need be).

Configuration

Instance admin of Sunbird adopters can configure the appId in the following way to acheive the functionality

dev_app_id = org.sample.app.dev
staging_app_id = org.sample.app.staging
production_app_id = org.sample.app

Last updated 10 months ago