Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning

This section is still WIP!

Table of Contents
maxLevel3
minLevel3

Prerequisites 

  1. Download and install Android Studio.

    Info

    For more information, see installing Android Studio.

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

Changing Android app catalog related logos and icons

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

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

    Info

    <EMM_AGENT_ANDROID> refers to the <PRODUCT_MDM>/modules/mobile-agents/android/client 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.
      • Change the following file logos in order to change the header logos:  

        ic_logo.png  ( 240px X 72px )
        repeat_bg.png   ( 277px X 125px )
    1. 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.
    2. 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.
    3. 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. Open the client folder that is in the <EMM_SOURCE_HOME>/modules/mobile-agent/android directory via Android Studio.
  4. Build the project to create a new APK with the changes.

    Info
    Expand
    titleClick here for more information on building the project.
    Note

    Support for the Android Developer Tools (ADT) in Eclipse is ending. Therefore, you should migrate the app development projects to Android Studio. For more information on transitioning to Android Studio, see Migrating to Android Studio.

    1. Get a GIT clone of the Android Agent application from GitHub.

    2. Update the Android Software Development Kit with the following:

      • SDK Versions 23 and 16. 

      • Build Tools Version 22.0.1.

      • Install or update Android Support Library.

      • Install or update Google Play Services.

      • Install Google USB Driver, if you are on a Windows platform.

    3. By default, the Android agent communicates with the server through http. For production, this needs to be changed to https, by configuring the following parameters in the Java class named Constants.java, which is in the org.wso2.EMM.agent.utils package: SERVER_PORT and SERVER_PROTOCOL.

      Anchor
      step3
      step3

      Panel

      For more information see below:

      Expand
      titleGenerating a BKS File

      Include Page
      Generating a BKS File for Android
      Generating a BKS File for Android

    4. Import the project on Android Studio, clean and build the project.

    5. Run the project on a device.

      Info

      The .apk file can be found in the < EMM_HOME>/repository/deployment/server/jaggeryapps/emm-web-agent/units/asset-download-agent-android/public/asset  directory.

  5. Rename the created.apk file to android-agent.apk.
  6. 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.