<img src="https://img.shields.io/badge/%20-ENTERPRISE-%23B10031" style="float:left"/>

<br />

To add JWP's video experience to your app, you must import the JWP Android SDK and then configure your project.

You can download the SDK using the Gradle or Local approaches listed below.

ApproachNotes
**[Gradle](πŸ”—ο»Ώ)**<br />_(Recommended)_<ul><li>Gradle will download the SDK’s core and optional modules for you.</li><li>ProGuard is automatically configured.</li><li>An existing app is required.</li></ul>
**[Local](πŸ”—ο»Ώ)**<ul><li>The JWP Android SDK must be downloaded and unzipped.</li><li>Core and optional modules must be imported manually.</li><li>ProGuard must be configured.</li><li>An existing app is required.</li></ul>

ο»Ώ

If you have any problems completing any of these tasks and have a valid JWP license, please <a href="https://support.jwplayer.com/hc/en-us/requests/new" target="_blank">log a support ticket</a> for assistance.

<br /> <hr />

## Gradle

Import the Android SDK into your project with Gradle.

  1. From within Android Studio, open your app.

  2. In the _project_ **build.gradle** file, add the JWP Maven repository.

    ο»Ώ

<br />

  1. In the _app_ **build.gradle** file:

    • Add the dependencies. When prompted by Android Studio, update the dependency versions.

    • Configure `compileOptions` to support Java 8 language support.

    ο»Ώ

    <br />

    ο»Ώ

<br />

  1. In the **gradle.properties** file, set `android.useAndroidX` and `android.enableJetifier` to `true`. These plugin files <a href="https://developer.android.com/jetpack/androidx#using_androidx_libraries_in_your_project" target="_blank">enable you to use androidx-namespaced libraries in your project</a>.

    ο»Ώ

    If you are using a current version of Android Studio, the <strong>gradle.properties</strong> file should already contain these settings.

    <br />

    ο»Ώ

<br />

  1. Sync Gradle.

<br />

You have imported the JWP Android SDK into your project. You can now [configure ProGuard](πŸ”—ο»Ώ) and [configure the manifest](πŸ”—ο»Ώ).

<br /> <hr />

## Local

### Download the SDK .zip file

  1. On your <a href="https://dashboard.jwplayer.com/p/players" target="_blank"><strong>Players</strong></a> page under **Android SDK**, click **Downloads**. The **Android SDK Downloads** panel opens.

    ο»Ώ

    If you have more than one property in your account, select the property from the dropdown menu at the top of the page. Each property has a unique set of license keys.

<br />

  1. Click the download icon for the version of the Android SDK that you want to download.

  2. On your computer, unzip the SDK **.zip** file.

<br /> <br />

### Add the SDK dependencies

  1. From within Android Studio, open your app.

  2. Create a new directory in your **app** directory named **libs**.

  3. Copy and paste **jwplayer-core-x.x.x.aar** into the **libs** folder.

  4. Copy and paste **jwplayer-common-x.x.x.aar** into the **libs** folder.

<br /> <br />

### Complete app and project configurations

  1. In the _app_ **build.gradle** file:

    • Add the dependencies. When prompted by Android Studio, update the dependency versions.

      ο»Ώ
    • Configure `compileOptions` to support Java 8 language support.

      ο»Ώ

<br />

  1. In the **gradle.properties** file, set `android.useAndroidX` and `android.enableJetifier` to `true`. These plugin files <a href="https://developer.android.com/jetpack/androidx#using_androidx_libraries_in_your_project" target="_blank">enable you to use androidx-namespaced libraries in your project</a>.

    ο»Ώ

    If you are using a current version of Android Studio, the <strong>gradle.properties</strong> file should already contain these settings. <br />

    ο»Ώ

<br />

  1. Sync Gradle.

You have imported the JWP Android SDK into your project. You can now [configure ProGuard](πŸ”—ο»Ώ) and [configure the manifest](πŸ”—ο»Ώ).

<br />