Skip to main content

Setup

What's included​

The library package includes the following:

  • Requirements
  • Link frameworks manually
    • Debug (xcframework)
    • Release (xcframework)
  • Link frameworks through cocopads

Requirements​

  • Xcode 14.0+
  • Swift 5.1

Framework linking​

This section describes how to link frameworks manually or through CocoaPods.

Manual dependency​

The libraries are distributed as xcframework and must be embedded and signed with the client app.

Use the following links to download frameworks manually:

Release frameworks: https://firstlight.jfrog.io/artifactory/fl-ios-sdk-local Debug frameworks : https://firstlight.jfrog.io/artifactory/fl-ios-sdk-debug-local

Build settings​

For Xcode 14, the libraries are archived with bitcode disabled for iOS and enabled for tvOS. Add the build setting ENABLE_BITCODE=NO for iOS targets in your client app.

Through CocoaPods​

This section describes how to install and use the iOS library with CocoaPods.

Prerequisites​

Complete these steps before installing the library:

  1. Install the cocoapods-art plugin:

    gem install cocoapods-art

  2. Create a .netrc file in your home directory with your JFrog credentials. Note that the password is the API key.

    machine firstlight.jfrog.io
    login <USERNAME>
    password <PASSWORD>

  3. Add an Artifactory repository to your local machine:

    pod repo-art add fl-ios-sdk-local "https://firstlight.jfrog.io/artifactory/api/pods/fl-ios-sdk-local"

  4. Add the following snippet to the top of your Podfile:

    plugin 'cocoapods-art', :sources => [
        'fl-ios-sdk-local'
    ]

    pod 'Firstlight/FLFoundation'
    pod 'Firstlight/FLPlayerInterface'
    pod 'Firstlight/FLPlatformCore'
    pod 'Firstlight/FLContentAuthorizer'
    pod 'Firstlight/FLPlayer'
    pod 'Firstlight/FLPlatformPlayer'

Resolve dependencies​

Run the following command to install dependencies:

pod install

Synchronize the cocoapods-art plugin's repositories with Artifactory​

The cocoapods-art plugin doesn't automatically update its index when you run client commands such as pod install. To keep your plugin's index synchronized with your CocoaPods repository, run the following command:

pod repo-art update fl-ios-sdk-local

You can consume the latest library version only after updating the index.

Additional dependencies (as required)​

Include the following dependencies in your Podfile as required for your customized solution.

  1. Yospace SSAI player
pod 'Firstlight/FLAdvertisingYospace'
  1. GoogleIMA CSAI/SSAI player
pod 'Firstlight/FLAdvertisingGoogleIMA'
  1. Bookmark integration
pod 'Firstlight/FLBookmarks'
  1. Heartbeat integration
pod 'Firstlight/FLHeartbeat'
  1. StreamConcurrency integration
pod 'Firstlight/FLStreamConcurrency
  1. Favorites integration
pod 'Firstlight/FLFavorites'
  1. AdvertisingGooglePAL
pod 'Firstlight/FLAdvertisingGooglePAL'
  1. Analytics integration
pod 'Firstlight/FLAnalytics'
  1. StreamTimeline integration
pod 'Firstlight/FLStreamTimeline'

Add dependencies to debug the framework​

To debug the framework, complete the following steps:

  1. Add an Artifactory repository to your local machine:

    pod repo-art add fl-ios-sdk-debug-local "https://firstlight.jfrog.io/artifactory/api/pods/fl-ios-sdk-debug-local"

  2. Add the following snippet to the top of your Podfile:

    plugin 'cocoapods-art', :sources => [
        'fl-ios-sdk-debug-local'
    ]

    pod 'Firstlight_debug/FLFoundation'
    pod 'Firstlight_debug/FLPlayerInterface'
    pod 'Firstlight_debug/FLPlatformCore'
    pod 'Firstlight_debug/FLContentAuthorizer'
    pod 'Firstlight_debug/FLPlayer'
    pod 'Firstlight_debug/FLPlatformPlayer'

You can add additional dependencies to the Podfile in the same way.