White Labeling the WSO2 EMM Android Agent

Prerequisites 

1. Download and install Android Studio.

   For more information, see installing Android Studio.

2. Replace the android.jar file that is in the <ANDROID_STUDIO>/<SDK location>/platforms/android-<CURRENT_API_LEVEL>
   directory with the android.jar file found here.

   Why is this needed?

   The WSO2 Android agent requires access to hidden APIs (APIs are available at runtime). Therefore, you need to replace the anrdoid.jar file as mentioned in this step.

3. WSO2 EMM supports API levels 16 to 22. Therefore, install the Android API levels 16 to 22 on Android Studio.
   1. Open Android Studio.
   2. Click SDK Manager.
      
   3. Click the SDK Platform tab and select the 16 and 22 API levels.
      
   4. Click Apply.

Changing Android Agent related logos and icons

1. Clone the product-emm repository. The folder will be referred to as <EMM_SOURCE_HOME> throughout the documentation.

   git clone https://github.com/wso2/product-emm.git

2. Navigate to the <EMM_AGENT_ANDROID>/res directory.

   <EMM_AGENT_ANDROID> refers to the <EMM_SOURCE_HOME>/modules/mobile-agents/android/client/client/src/main file path.

   1. Navigate to the drawable-xxhdpi/ folder and change the following:
      • Change the ic_launcher.png (144px X 144px) file in order to change the icon. For more information, go to the Android icon guide. 
        

   1. •  Change the following file logos in order to change the header logos:  

        ic_logo.png  ( 240px X 72px )
        ic_logo_darker.png  ( 240px X 72px)
        repeat_bg.png   ( 277px X 125px )

   2. Navigate to the drawable-xhdpi/ folder.
      • Change the ic_launcher.png (96px X 96px) file to change the icon.
      • Change the ic_logo.png (160px X 48px), ic_logo_darker.png  (160px X 48px) and repeat_bg.png (222px X 100px) file in order to change the logos.
   3. Navigate to the drawable-hdpi/ folder.
      
      • Change the ic_launcher.png (72px X 72px) file in order to change the icon.
      • Change the ic_logo.png (120px X 36px), ic_logo_darker.png  (120px X 36px) and repeat_bg.png (122px X 55px) files in order to change the logos.
   4. Navigate to the drawable-mdpi/ folder.
      
      • Change the ic_launcher.png (48px X 48px) file to change the icon.
      • Change the ic_logo.png (80px X 24px) and ic_logo_darker.png  (80px X 24px) files in order to change the logos.

3. Optionally, if you have the Android system service application integrated with WSO2 EMM, change the permanent device lock screen logo.

   1. Navigate to the <EMM_SYSTEM_SERVICE>/res/drawable-hdpi directory.

      <EMM_SYSTEM_SERVICE> refers to the <EMM_SOURCE_HOME>/modules/mobile-agents/android/system-service/app/src/main file path.

   2. Replace  the  id_logo_dark.png  file to change the icon.

   

4. Open the client folder that is in the <EMM_SOURCE_HOME>/modules/mobile-agent/android directory via Android Studio.

5. Build the project to create a new APK with the changes.

6. Rename the created.apk file to android-agent.apk.
7. Copy the renamed file and replace it instead of the existing android-agent.apk. file that is in the <EMM_HOME>/repository/deployment/server/jaggeryapps/emm-web-agent/units/asset-download-agent-android/public/asset directory.