Component Diagram

The Sunbird Mobile app is the app-based interface for the Sunbird application stack. It provides an app(Android/Ios) through which all functionality of Sunbird can be accessed.

GitHub Repository

GitHub - Sunbird-Ed/SunbirdEd-mobile-app: Cordova Mobile Application for Sunbird software. Provide the interfaces on Android Application. Currently caters to use cases of both offline and online consumption of Sunbird resourcesGitHub

Architecture

Source Code

Sunbird Mobiles app follows a basic angular / Ionic code structure. The top level of the workspace contains workspace-wide configuration files, configuration files for the application, and test files.

All following primary folders are highlighted in the above screenshot

• plugins

• app

• directives

• pipes

• services

plugins

plugins folder contains all the plugins which provide JavaScript interface to native components (Android/ Ios)required by Sunbird Mobile App. They allow the app to use native device capabilities beyond what is available to pure web components.

List of plugins used in the Sunbird Mobile app

app

This folder contains all the modules and components. It contains the Sunbird Mobile app's logic and data.

Modules

As Modules are a great way to organize an application and extend it with capabilities from external libraries so, in the Sunbird-mobile-app, each functionality/page is configured as a Module. Some key modules are given in the below diagram.

• home

• qrcoderesult

• content-details

• enrolled-course-details

• collection-detail-etb

• discussion-forum

• my-groups

• download-manager

• manage-learn

. . . . . . . . . . . .

directives

This folder contains classes that can add new behavior to the elements in the template or modify existing behavior. These classes are used to maneuver the DOM by adding/ removing new elements to DOM and even changing the appearance of the DOM elements.

Following are a few key directives in the app

• custom-ion-select

• read-more

• hide-header-footer

. . . . . . . . . . .

pipes

This folder contains classes containing simple functions to use in template expressions to accept an input value and return a transformed value.

• category-key-translator

• date-ago

• file-size

• mime-type

• translate-html

• translate-json

. . . . . . . . . .

services

This folder contains classes with the @injectible decorator. This decorator tells angular that the class is a service and can be injected into components that need that service.

• android-permissions

• common-form-config-builders

• discussion

• download-pdf

• form-location-factory

• print-pdf

• user-groups

. . . . . . . . . . .

sunbird-mobile-sdk

sunbird-mobile-sdk is the heart of Sunbird-mobile-app which contains all the business logic starting from API access to offline data management.

Configurations required to setup Sunbird-mobile-app

These are the set of files required to set up Sunbird-mobile-app

• sunbird.properties

• google-service.json

Forms required to initialize Sunbird-mobile-app

The Form Configurations are a set of predefined forms that enable users to easily modify the UI without changing anything in the source code. Also, it allows users to quickly update any type of app attribute even if the app is already available in Play Store/app store without any app update.

List of forms available in Sunbird-Mobile-app