From 2b8ff68842876acc6c150e06a9d108b6ee9fdbe6 Mon Sep 17 00:00:00 2001 From: Ceyhun Ozgoc Date: Fri, 13 Nov 2026 08:00:34 +0000 Subject: [PATCH 1/2] Add the OptiView Player CocoaPods spec repo source to the connector install instructions Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- Code/Comscore/README.md | 17 +++++++++++++---- Code/Conviva/README.md | 17 +++++++++++++---- Code/Nielsen/README.md | 18 ++++++++++++++---- Code/Sideloaded-TextTracks/README.md | 17 +++++++++++++---- Code/Uplynk/README.md | 17 +++++++++++++---- Code/Yospace/README.md | 16 +++++++++++++--- Readme.md | 9 ++++++++- 7 files changed, 87 insertions(+), 24 deletions(-) diff --git a/Code/Comscore/README.md b/Code/Comscore/README.md index 6dd9ab61..7d1e8f99 100644 --- a/Code/Comscore/README.md +++ b/Code/Comscore/README.md @@ -4,12 +4,21 @@ THEOplayer-Connector-Comscore provides an integration between the THEOplayerSDK ## Installation -### [Cocoapods](https://guides.cocoapods.org/using/getting-started.html#getting-started) +### [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 1. Create a Podfile if you don't already have one. From the root of your project directory, run the following command: `pod init` -2. To your Podfile, add links to the registry of Cocoapods: `source 'https://cdn.cocoapods.org/'`. If this fails, bypass their CDN by using `source 'https://github.com/CocoaPods/Specs.git'` -3. To your Podfile, add the connector pods that you want to use in your app: `pod 'THEOplayer-Connector-Comscore'` -4. Install the pods using `pod install` , then open your `.xcworkspace` file to see the project in Xcode. +2. Add the sources and connector pod to your Podfile, including [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/): + + ```ruby + source 'https://github.com/THEOplayer/cocoapods-specs' + source 'https://cdn.cocoapods.org/' + + target 'MyApp' do + pod 'THEOplayer-Connector-Comscore' + end + ``` + +3. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. To support custom feature builds of THEOplayerSDK perform the following steps: diff --git a/Code/Conviva/README.md b/Code/Conviva/README.md index cffd79d5..8429cc67 100644 --- a/Code/Conviva/README.md +++ b/Code/Conviva/README.md @@ -22,12 +22,22 @@ To support custom feature builds of THEOplayerSDK perform the following steps: 1. Choose `File` > `Packages` > `Reset Package Caches` from the menu bar. 2. If it is still not working, make sure to remove any `THEOplayerSDK.xcframework` inclusions that you manually installed before installing this THEOplayer-Connector-Conviva package. -### [Cocoapods](https://guides.cocoapods.org/using/getting-started.html#getting-started) +### [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 1. Create a Podfile if you don't already have one. From the root of your project directory, run the following command: `pod init` -2. To your Podfile, add the Conviva connector pods that you want to use in your app: `pod 'THEOplayer-Connector-Conviva'` +2. Add the sources and connector pod to your Podfile, including [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/): + + ```ruby + source 'https://github.com/THEOplayer/cocoapods-specs' + source 'https://cdn.cocoapods.org/' + + target 'MyApp' do + pod 'THEOplayer-Connector-Conviva' + end + ``` + - When using THEOads, also add the THEOads subspec so that failed THEOads ad breaks (e.g. an empty VAST response) are reported to Conviva: `pod 'THEOplayer-Connector-Conviva/THEOads'` -3. Install the pods using `pod install` , then open your `.xcworkspace` file to see the project in Xcode. +3. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. To support custom feature builds of THEOplayerSDK perform the following steps: @@ -80,4 +90,3 @@ connector.setContentInfo(contentInfo) ## Lifecycle Hold a reference to your connector. Once the connector is released from memory it will clean up itself and stop reporting to Conviva. - diff --git a/Code/Nielsen/README.md b/Code/Nielsen/README.md index b383063c..338f2003 100644 --- a/Code/Nielsen/README.md +++ b/Code/Nielsen/README.md @@ -20,12 +20,22 @@ To support custom feature builds of THEOplayerSDK perform the following steps: 1. Choose `File` > `Packages` > `Reset Package Caches` from the menu bar. 2. If it is still not working, make sure to remove any `THEOplayerSDK.xcframework` inclusions that you manually installed before installing this connector package. -### [Cocoapods](https://guides.cocoapods.org/using/getting-started.html#getting-started) +### [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 1. Create a Podfile if you don't already have one. From the root of your project directory, run the following command: `pod init` -2. To your Podfile, add links to the registries of Cocoapods and Nielsen: `source 'https://cdn.cocoapods.org/'` and `source 'https://github.com/NielsenDigitalSDK/nielsenappsdk-ios-specs-dynamic.git'` -3. To your Podfile, add the connector pods that you want to use in your app: `pod 'THEOplayer-Connector-Nielsen'` -4. Install the pods using `pod install` , then open your `.xcworkspace` file to see the project in Xcode. +2. Add the sources and connector pod to your Podfile, including [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/): + + ```ruby + source 'https://github.com/THEOplayer/cocoapods-specs' + source 'https://cdn.cocoapods.org/' + source 'https://github.com/NielsenDigitalSDK/nielsenappsdk-ios-specs-dynamic.git' + + target 'MyApp' do + pod 'THEOplayer-Connector-Nielsen' + end + ``` + +3. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. To support custom feature builds of THEOplayerSDK perform the following steps: diff --git a/Code/Sideloaded-TextTracks/README.md b/Code/Sideloaded-TextTracks/README.md index 1f554654..bb2582cb 100644 --- a/Code/Sideloaded-TextTracks/README.md +++ b/Code/Sideloaded-TextTracks/README.md @@ -10,12 +10,21 @@ This connector is intended to be used for subtitle text tracks specific with the ## Installation -### [Cocoapods](https://guides.cocoapods.org/using/getting-started.html#getting-started) +### [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 1. Create a Podfile if you don't already have one. From the root of your project directory, run the following command: `pod init` -2. To your Podfile, add links to the registry of Cocoapods: `source 'https://cdn.cocoapods.org/'`. If this fails, bypass their CDN by using `source 'https://github.com/CocoaPods/Specs.git'` -3. To your Podfile, add the connector pods that you want to use in your app: `pod 'THEOplayer-Connector-SideloadedSubtitle'` -4. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. +2. Add the sources and connector pod to your Podfile, including [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/): + + ```ruby + source 'https://github.com/THEOplayer/cocoapods-specs' + source 'https://cdn.cocoapods.org/' + + target 'MyApp' do + pod 'THEOplayer-Connector-SideloadedSubtitle' + end + ``` + +3. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. ## Usage diff --git a/Code/Uplynk/README.md b/Code/Uplynk/README.md index aeca3431..8b1301b3 100644 --- a/Code/Uplynk/README.md +++ b/Code/Uplynk/README.md @@ -24,11 +24,21 @@ To support custom feature builds of THEOplayerSDK perform the following steps: 1. Choose `File` > `Packages` > `Reset Package Caches` from the menu bar. 2. If it is still not working, make sure to remove any `THEOplayerSDK.xcframework` inclusions that you manually installed before installing this THEOplayer-Connector-Uplynk package. -### [Cocoapods](https://guides.cocoapods.org/using/getting-started.html#getting-started) +### [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 1. Create a Podfile if you don't already have one. From the root of your project directory, run the following command: `pod init` -2. To your Podfile, add the Uplynk connector pods that you want to use in your app: `pod 'THEOplayer-Connector-Uplynk'` -3. Install the pods using `pod install` , then open your `.xcworkspace` file to see the project in Xcode. +2. Add the sources and connector pod to your Podfile, including [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/): + + ```ruby + source 'https://github.com/THEOplayer/cocoapods-specs' + source 'https://cdn.cocoapods.org/' + + target 'MyApp' do + pod 'THEOplayer-Connector-Uplynk' + end + ``` + +3. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. To support custom feature builds of THEOplayerSDK perform the following steps: @@ -44,4 +54,3 @@ Learn more about Uplynk and how to use the connector in the following list of ar - [Preplay](./docs/preplay.md): this article provides information on how to configure a Uplynk source. - [Ads](./docs/ads.md): this article provides information on which APIs can be leveraged to track and enhance the ad-viewing experience. - [Ping](./docs/ping.md): this article provides information on how to leverage the Ping service and which THEOplayer APIs you should use. - diff --git a/Code/Yospace/README.md b/Code/Yospace/README.md index 27761b6f..317a2ac0 100644 --- a/Code/Yospace/README.md +++ b/Code/Yospace/README.md @@ -20,10 +20,20 @@ To support custom feature builds of THEOplayerSDK perform the following steps: 1. Choose `File` > `Packages` > `Reset Package Caches` from the menu bar. 2. If it is still not working, make sure to remove any `THEOplayerSDK.xcframework` inclusions that you manually installed before installing this connector package. -### [Cocoapods](https://guides.cocoapods.org/using/getting-started.html#getting-started) +### [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 1. Create a Podfile if you don't already have one. From the root of your project directory, run the following command: `pod init` -2. To your Podfile, add the Yospace connector pod that you want to use in your app: `pod 'THEOplayer-Connector-Yospace'` +2. Add the sources and connector pod to your Podfile, including [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/): + + ```ruby + source 'https://github.com/THEOplayer/cocoapods-specs' + source 'https://cdn.cocoapods.org/' + + target 'MyApp' do + pod 'THEOplayer-Connector-Yospace' + end + ``` + 3. Add the following post-install hook in your Podfile: ```ruby post_install do |installer| @@ -40,7 +50,7 @@ post_install do |installer| end ``` Check the Dependencies section below to get information on how to obtain the `YOAdManagement.xcframework` as a pod. -4. Install the pods using `pod install` , then open your `.xcworkspace` file to see the project in Xcode. +4. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. To support custom feature builds of THEOplayerSDK perform the following steps: diff --git a/Readme.md b/Readme.md index e8b170d0..bce1b6bd 100644 --- a/Readme.md +++ b/Readme.md @@ -32,9 +32,16 @@ Notes: In your `Podfile` add one or more of the OptiView Player iOS SDK Connectors, for example: ```ruby -pod 'THEOplayer-Connector-Conviva' +source 'https://github.com/THEOplayer/cocoapods-specs' +source 'https://cdn.cocoapods.org/' + +target 'MyApp' do + pod 'THEOplayer-Connector-Conviva' +end ``` +See [our CocoaPods spec repo](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/cocoapods-spec-repo/) for more information. + ### Swift Package Manager In Xcode, go to **File > Add Package Dependencies...** and add: From 8dd6cc9ef26484e0a33b4a0e2573008e7738f4ec Mon Sep 17 00:00:00 2001 From: Ceyhun Ozgoc Date: Fri, 13 Nov 2026 08:01:20 +0000 Subject: [PATCH 2/2] Indent the Yospace post-install hook so the install steps render as one list Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- Code/Yospace/README.md | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/Code/Yospace/README.md b/Code/Yospace/README.md index 317a2ac0..4b835a66 100644 --- a/Code/Yospace/README.md +++ b/Code/Yospace/README.md @@ -35,21 +35,23 @@ To support custom feature builds of THEOplayerSDK perform the following steps: ``` 3. Add the following post-install hook in your Podfile: -```ruby -post_install do |installer| - custom_framework_path = "#{installer.sandbox.root}/YOAdManagement-Release/YOAdManagement.xcframework" - - installer.pods_project.targets.each do |target| - if target.name == 'THEOplayer-Connector-Yospace' - framework_build_phase = target.frameworks_build_phase - file_ref = installer.pods_project.new_file(custom_framework_path) - - framework_build_phase.add_file_reference(file_ref) - end - end -end -``` -Check the Dependencies section below to get information on how to obtain the `YOAdManagement.xcframework` as a pod. + + ```ruby + post_install do |installer| + custom_framework_path = "#{installer.sandbox.root}/YOAdManagement-Release/YOAdManagement.xcframework" + + installer.pods_project.targets.each do |target| + if target.name == 'THEOplayer-Connector-Yospace' + framework_build_phase = target.frameworks_build_phase + file_ref = installer.pods_project.new_file(custom_framework_path) + + framework_build_phase.add_file_reference(file_ref) + end + end + end + ``` + Check the Dependencies section below to get information on how to obtain the `YOAdManagement.xcframework` as a pod. + 4. Install the pods using `pod install`, then open your `.xcworkspace` file to see the project in Xcode. To support custom feature builds of THEOplayerSDK perform the following steps: