# Sunbird ED Mobile

### Steps to setup jenkins slave for mobile build

* Create a seperate jenkins slave and attatch it with master jenkins.
* Login to jenkins slave vm and execute below script to install dependencies.

```
https://github.com/project-sunbird/sunbird-devops/blob/release-5.1.0/deploy/jenkins/jenkins-mobile-slave-setup.sh
```

* Update mobile build jenkins job to execute on jenkins slave vm.

**Dependencies:**\
NPM Version - above 6\
Node JS Version - above 10

**1. Ionic-Android build Setup**\
\- [Install java](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\
\- [Install Gradle](https://gradle.org/install/)\
\- [Install Android Studio](https://developer.android.com/studio/)\
\- After Android studio installation, install SDK\
\- Open Android studio and goto `settings/appearance and behavior/system settings/Android SDK`\
\- Install appropriate Android sdk platform package.\
\- Add environment variables in `~/.bashrc` or `~/.bash_profile` as follows\
`export ANDROID_SDK_ROOT=path_to_sdk`\
`export PATH=$PATH:$ANDROID_SDK_ROOT/tools/bin`\
`export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools`\
\- Reference: <https://ionicframework.com/docs/installation/android>

```
CLI Setup    
- `npm install -g ionic`   
- `npm install -g cordova`   
```

**2. Project Setup**\
\- git clone the repo(<https://github.com/Sunbird-Ed/SunbirdEd-mobile-app>).\
\- Rename `sunbird.properties.example` file to `sunbird.properties` and put all the valid credentials and api endpoint.\
\- Go to project folder and run npm i\
\- Run `./build.sh`

**3. How to build apk**\
\- To check attached devices do `adb devices`\
\- `npm run ionic-build` (Make sure you have attached device)\
\- `ionic cordova run android --prod`\
\- Apk location `project_folder/platforms/android/app/build/outputs/apk/staging/debug/apk_name.apk`

**4. How to debug apk**\
\- Open chrome and enter `chrome://inspect`\
\- Select app

***

## IOS Development setup

### Prerequisites

```
1. Node js version 10.18.1
2. Ionic 5.4.16 using `npm i ionic@5.4.16 -g`
3. Cordova 9.0.0  using `npm i cordova@9.0.0 -g`
4. cordova-res 0.15.3 - using `npm install -g cordova-res`
5. ios-deploy  1.11.4 - using `brew install ios-deploy`
all of the above should be installed globally
Xcode 12.4 Build version 12D4e or above
```

### Steps

```
1. Checkout sunbird-sdk repo from https://github.com/shikshalokam/sunbird-mobile-sdk with branch release-3.9.0-ios
2. cd to <sunbird-mobile-sdk> && npm i && npm run build:prod
3. Checkout sunbird-mobile-app repo from https://github.com/shikshalokam/SunbirdEd-mobile-app with branch release-3.9.0-ios
4. Add `GoogleService-Info.plist` file
5. cd to <sunbird-mobile-app> local path
6. RUN npm i <sunbird-sdk repo local path>/dist
7. RUN npm i
8. RUN ./build-ios.sh
9. RUN cordova emulate ios
```

### Possible Errors

1. error: Value for SWIFT\_VERSION cannot be empty. (in target 'Sunbird' from project 'Sunbird') or Duplicate GoogleService-Info.plist file error

#### Solution

```
open platforms/ios/Sunbird.xcworkspace 
Select Sunbird 
Build setting Project, targets
update Swift language version to 4 
Inside Tagets -> Build phases -> Copy Bundle Resources -> remove duplicate GoogleService-Info.plist if present
and close Xcode then rerun the **cordova emulate ios**
```