Update your app

This section shows you the steps required to migrate the app in Android Studio.

Import the new libraries

1. Go to your Knox Developer account and download supportlib.jar file.

   If you are a VPN provider, looking to migrate your solution to Knox 3.4 or higher, see VPN namespace changes.

2. In your IDE, add the JAR files. In Android Studio, you right-click the libs folder and click Paste.

   

3. Delete the old Knox JAR files from your project.

   

4. Edit build.gradle to prevent Android Studio from including the JAR files during compile and run-time:

   

5. Edit build.gradle to remove references to the old JAR files.

   

6. Edit the build.gradle file to include supportlib.jar at run-time and knoxsdk.jar at compile-time:

   

7. Delete the corresponding XML files from your project.

   

Update the package names

1. After trying a build, the IDE will highlight unresolved packages that were in the deleted JAR files. Find these.

   

2. Replace old package names with the new ones. To find the new name, use any of these methods:

• Use your IDE’s quick fix feature. In Android Studio, delete all the import statements for the old Samsung Knox packages. Then highlight an unresolved class name and press [Alt] + [Enter] (for Windows/Linux) or [Option] + [Enter] (for Mac) to add its required import statement.

  

• If that doesn’t work, use your IDE’s find class feature. In Android Studio, select the class name and press [Ctrl]-[n] (for Windows/Linux) or [Command]-[o] (for Mac) to see its new package name:

  

To find new namespace, you can also:

• Enter the class name in the API reference Search tool, which shows the class’ full package name.

• Look up the new package name in the API reference Package index

• Check the list of new package names for the API class.

Update the class names

In a few cases, the package name cannot be resolved because the class name has changed with the new Samsung Knox SDK, for better clarity or consistency:

In these cases, look up the API method name in the new Knox SDK API reference and update its class name as well as the package name.

Update the API method names

A few API methods were also renamed for better clarity and consistency. Update these names as well.

Update the permissions

Permissions allow you to specify what Knox SDK features your app can access.

If you have…

• Not yet declared permissions
• Already declared permissions

<?xml version-"1.0" encoding-"utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.samsung.knoxsdksample">
<!-- Declare the Knox permissions used by this app -->

<uses-permission android:name="com.samsung.android.knox.permission.KNOX_HW_CONTROL"/>
<uses-permission android:name="com.samsung.android.knox.permission.CUSTOM_SETTING"/>

<!-- Declare the Android permissions used by this app -->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

<application
...
<!-- Enable selective Knox permissions -->
<meta-data android:name="com.samsung.knoxlicense.permissions" android:value="true">
...
</application>
</manifest>