Install the SDK

Download the SDK

  1. Go to the Knox Partner Portal.
  2. Sign in to your Samsung Account.
    • If you're not already a member of the Knox Partner Portal, click Become a Partner and provide your details.
  3. On your personal dashboard, click SDKs & toolsSDKs download.
  4. On the SDKs download page click Download for the SDK you want.
  5. Review the SDK Agreement. If you agree to the terms, select the checkbox and click Accept. The browser saves the SDK package into your downloads folder.
  6. Extract the SDK .zip contents.
  7. Copy the extracted addon_xxx folder to your IDE's add-ons folder. For:
    • Android Studio—AppData\Local\Android\sdk\add-ons
    • Eclipse—eclipse\plugins

Create your Android Project

  1. Open Android Studio.
  2. Create a new project. Click File > New Project.
  3. Fill out the fields:
    1. Application name: your app name.
    2. Company domain: the qualifier for your app package name.
    3. Package name: this is the combination of the company domain and application name, which must be unique across all packages in the Android environment. Android generates this from the application name and company domain values.
    4. Project Location: the directory where your app is stored. You can use the default or specify another location, if desired.
  4. Click Next.
  5. Select Phone and Tablet as your platform.
  6. Select the API level you want to target.>
    • For details about which Android version maps to Knox SDK versions, see Knox version mapping.
    • If you target API level 26 or lower, you must later include the Knox supportlib.jar. This is for backwards compatibility, as earlier Knox platforms don't support the namespaces in the Knox SDK v3.x.
  7. Select your activity type and click Next. For the purpose of this tutorial, select Empty Activity. For more information on Activities, see Android Activities.
  8. Choose an Activity Name and Layout Name. Click Finish. For the purpose of this tutorial, use the default values – MainActivity and activity_main.

For more information on creating an Android project, see Google's Create an Android project.

Add Knox libraries to a project

  1. Open the project in Android Studio.
  2. Use a file browser to navigate to the location that the library files are stored.
  3. Select the knoxsdk.jar and copy it. 
    • If you targetted API level 26 or lower, you must also include the supportlib.jar. This is for backwards compatibility, as earlier Knox platforms don't support the namespaces in the Knox SDK v3.x.
  4. Switch to your Android Studio project, select the libs directory, and paste the libraries into your project. If you do not see the libs directory, ensure your file browser is using 'Project' view rather than 'Android' view. You may have to create this folder yourself

    This displays a copy dialog.
  5. Click OK to complete copying the libraries into the project.

    This displays the libraries in your project under the libs directory
  6. Select the library, right-click, and select Add As Library...
  7. Select the module to add the library to, and click OK. If your app contains several modules, you must ensure that you add the library to the appropriate module. For the purpose of this tutorial, select the app module.

Your project now includes the Knox SDK.