Download the SDK (iOS v3)

Download the SDK and add the SDK to your iOS project.


To add a player to your app, you must import the JWP SDK for iOS and then configure your project. To complete these tasks, review the table below and choose the approach that suits your implementation needs.

ApproachNotes
CocoaPodsβ€’ No SDK download is required.
β€’ Core and optional modules must be added to your app.
β€’ An existing app is required.
Localβ€’ JWP SDK for iOS must be downloaded and unzipped.
β€’ Core and optional modules must be imported.
β€’ An existing app is required.
Demoβ€’ JWP SDK for iOS Open Source Demo must be downloaded.
β€’ All modules are included. No modules need to be imported or set as dependencies.
β€’ An existing app is not required. The open source demo is a basic demonstration app that allows you to experiment with the SDK.

CocoaPods

In the following subsections, you will learn how to complete these tasks:

  1. Get required items.
  2. Add SDK to Xcode project.

If you have problems completing any of these tasks, log a support ticket for assistance.

Get the required CocoaPods items

Before you begin this approach to add the SDK to your project, you need the items in the table below from JWP.

ItemAcquisition process
Enterprise or Developer licenseJWP SDK for iOS requires an Enterprise or Developer license.
Xcode 12+Download and install Xcode.
License key1. From the Player Downloads & Keys page, scroll to the Downloads table.
2. Copy the LICENSE KEY for the JWP SDK for iOS.

Add SDK to an Xcode project

Now that you have the required items listed in the previous subsection, you can import the JWP SDK for iOS to your Xcode project.

Install CocoaPods and create a Podfile

  1. At the Terminal prompt enter $ gem install cocoapods to install CocoaPods.
  2. Enter $ cd <path-to-your-project>/<your-project>/ to navigate to your project directory.
  3. Enter $ pod init to create a file named Podfile. Podfile defines the dependencies for your project.

Edit the Podfile

  1. In a text editor, open Podfile.
  2. Set the iOS version to 11.0 or greater.
  3. If you are using Objective-C, you can comment out use_frameworks!.
  4. Add JWPlayer-SDK as a dependency. To add a specific version of the SDK, be sure to use the proper Podfile syntax.
  5. Save Podfile and close the text editor.
# Uncomment the next line to define a global platform for your project
platform :ios, '11.0'

target 'MyAwesomeProject' do
  # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
  use_frameworks!

  # Pods for MyAwesomeProject
  pod 'JWPlayer-SDK', 'SDK_VERSION'
end

Install the SDK

  1. At the terminal prompt of your project directory, enter $ pod install to install the JWP SDK for iOS.
  2. Open the .xcworkspace file for your project to launch Xcode.

You have retrieved your JWP license key and imported the JWP SDK for iOS into your project. You can now configure your project.

πŸ“˜

After setting up and testing your app, also be sure to remove x86_64 and i386 targets.



Local

In the following subsections, you will learn how to complete these tasks:

  1. Get required items.
  2. Add SDK to Xcode project.

If you have problems completing any of these tasks, log a support ticket for assistance.

Get required items

Before you begin this approach to add the SDK to your project, you need the items in the table below from JWP.

ItemAcquisition process
Enterprise or Developer licenseJWP SDK for iOS requires an Enterprise or Developer license.
Xcode 12+Download and install Xcode.
JWP SDK for iOS and license key1. From the Player Downloads & Keys page, scroll to the Downloads table.
2. Select a version from the VERSION drop-down menu
3. Click the icon in the DOWNLOAD column.
4. Copy the LICENSE KEY for the JWP SDK for iOS.
5. On your computer, unzip the JWP SDK for iOS .zip file.

Import the SDK into your project

Now that you have the required items listed in the previous subsection, you can add JWP SDK for iOS to your Xcode project.

  1. From within Xcode, select your project from the project navigator.
  2. Select the target in the left column of the project editor.
  3. Click General.
  4. In the Linked Frameworks and Libraries, click the plus sign (+).
  5. Click Add Other.
  6. Select JWPlayer_iOS_SDK.framework from the jwplayer-ios-sdk/Framework folder on your computer.
  7. Click Open.

You have retrieved your JWP license key and imported the JWP SDK for iOS into your project. You can now configure your project.



Demo

The JWP SDK for iOS Open Source Demo is a basic demonstration app. In the following subsection, you will learn how to get the required items that will enable you to experiment with the demo app.

If you have problems completing any of these tasks, log a support ticket for assistance.

Get the required items for the Demo

Before you can start experimenting with theΒ JWP SDK for iOS Open Source Demo,Β you need the items in the table below from JWP.

ItemAcquisition process
Enterprise or Developer licenseJWP Open Source Demo for iOS. requires an Enterprise or Developer license.
Xcode 12+Download and install Xcode.
JWP SDK for iOS Open Source Demo and license key1. Download the JWP Open Source Demo for iOS.
2. From the Player Downloads & Keys page, scroll to the Downloads table.
3. Copy the LICENSE KEY for the JWP SDK for iOS.

You have retrieved your JWP license key and downloaded the JWP SDK for iOS Open Source Demo. You can now configure your project.