Integrating SDK with App

Notes

• Integrations created earlier will not work with 3.0+ because they are not entitled to the scopes required by 3.0+. You can either raise a support request to enable these scopes for your appId or you could create a new Integration that's meant to be used for v3. This does not affect Guest Issuer JWT token-based sign-in.
• FedRAMP(Federal Risk and Authorization Management Program) support is from 3.1 onwards.
• Currently all resource ids that are exposed from the SDK are barebones GUIDs. You cannot directly use these ids to make calls to webexapis.com. You'll need to call Webex.base64Encode(type: ResourceType, resource: String, handler: CompletionHandler<String>) to get a base64 encoded resource. However, you're free to interchange between base64 encoded resource ids and barebones GUID while providing them as input to the SDK APIs.
• You can add android:extractNativeLibs="true" inside your <application> tag in your Manifest file to reduce the generated apk size.
• You can split the application APKs based on architecture for individual distribution. To get details of each architecture library and sample application sizes please visit here
• The Webex.initialize method should be called before invoking any other api.

Integration

Option 1

1. Put AAR file in libs folder of your Android project

2. Open the project level Gradle file and add the following lines under the repositories tag, which is nested under allprojects.

   allprojects {
     repositories {
         flatDir { dirs 'aars'} //add this line
     }
   }
   

3. Add the following dependency in module level Gradle file and press sync-now

   • For Full SDK

       implementation files('libs/WebexSDK.aar')
     

   • For Meeting SDK

       implementation files('libs/WebexSDK-Meeting.aar')
     

   • For WebexCalling SDK

       implementation files('libs/WebexSDK-Wxc.aar')
     

Option 2

1. Add the following repository to your top-level build.gradle file:

   allprojects {
       repositories {
           maven {
               url 'https://devhub.cisco.com/artifactory/webexsdk/'
           }
       }
   }
   

2. Add the webex-android-sdk library as a dependency for your app in the build.gradle file:

   • For Full SDK

     dependencies {
         implementation 'com.ciscowebex:webexsdk:3.10.0'
     }
     

   • For Meeting SDK

     dependencies {
     implementation 'com.ciscowebex:webexsdk-meeting:3.10.0'
     }
     

   • For WebexCalling SDK

     dependencies {
     implementation 'com.ciscowebex:webexsdk-wxc:3.10.0'
     }