Merge pull request #203 from teads/adapters-spm

SPM support for TeadsAdMobAdapter and TeadsAppLovinAdapter

Author: github-paul-nicolas

MediationAdapters/TeadsAdMobAdapter/Exports.txt renamed to MediationAdapters/TeadsAdMobAdapter/Exports.swift

@@ -36,6 +36,43 @@ pod 'TeadsAdMobAdapter', '~> 5.0'
 3. Follow the [Define Custom Event](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation#defining_a_custom_event) step to finish the integration.
 4. You’re done.
 
+### Swift Package Manager
+
+[SPM](https://swift.org/package-manager/) is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
+
+#### Installing from Xcode
+
+1. Add a package by selecting `File` → `Add Packages…` in Xcode’s menu bar.
+2. Search for the Teads iOS SDK using the repo's URL:
+```console
+https://github.com/teads/TeadsSDK-iOS
+```
+3. Next, set the **Dependency Rule** to be `Up to Next Major Version` and keep `5.0.0 < 6.0.0`.
+4. Choose the Teads product that you want to be installed in your app: `TeadsAdMobAdapter`
+5. Follow the [Define Custom Event](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation#defining_a_custom_event) step to finish the integration.
+
+#### Alternatively, add Teads to your Package.swift manifest
+1. Add it to the `dependencies` of your `Package.swift`:
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/teads/TeadsSDK-iOS", .upToNextMajor(from: "5.0.0"))
+]
+```
+
+2. in any target that depends on a Teads product, add it to the `dependencies` array of that target:
+
+```swift
+.target(
+  name: "MyTargetName",
+  dependencies: [
+    .product(name: "TeadsAdMobAdapter", package: "Teads"),
+  ]
+),
+```
+
+3. Follow the [Define Custom Event](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation#defining_a_custom_event) step to finish the integration.
+
 ## Integration Documentation
 
 Integration instructions are available on [Teads SDK Documentation](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation).

MediationAdapters/TeadsAdMobAdapter/README.md

@@ -36,6 +36,43 @@ pod 'TeadsAppLovinAdapter', '~> 5.0'
 3. Follow the [Create a custom Network](https://support.teads.tv/support/solutions/articles/36000357700-inread-applovin-mediation#create-a-custom-network) step to finish the integration.
 4. You’re done.
 
+### Swift Package Manager
+
+[SPM](https://swift.org/package-manager/) is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
+
+#### Installing from Xcode
+
+1. Add a package by selecting `File` → `Add Packages…` in Xcode’s menu bar.
+2. Search for the Teads iOS SDK using the repo's URL:
+```console
+https://github.com/teads/TeadsSDK-iOS
+```
+3. Next, set the **Dependency Rule** to be `Up to Next Major Version` and keep `5.0.0 < 6.0.0`.
+4. Choose the Teads product that you want to be installed in your app: `TeadsAppLovinAdapter`
+5. Follow the [Create a custom Network](https://support.teads.tv/support/solutions/articles/36000357700-inread-applovin-mediation#create-a-custom-network) step to finish the integration.
+
+#### Alternatively, add Teads to your Package.swift manifest
+1. Add it to the `dependencies` of your `Package.swift`:
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/teads/TeadsSDK-iOS", .upToNextMajor(from: "5.0.0"))
+]
+```
+
+2. in any target that depends on a Teads product, add it to the `dependencies` array of that target:
+
+```swift
+.target(
+  name: "MyTargetName",
+  dependencies: [
+    .product(name: "TeadsAppLovinAdapter", package: "Teads"),
+  ]
+),
+```
+
+3. Follow the [Create a custom Network](https://support.teads.tv/support/solutions/articles/36000357700-inread-applovin-mediation#create-a-custom-network) step to finish the integration.
+
 
 ## Integration Documentation
 

MediationAdapters/TeadsAppLovinAdapter/Exports.txt renamed to MediationAdapters/TeadsAppLovinAdapter/Exports.swift

@@ -3,10 +3,18 @@
 import PackageDescription
 
 let teadsModuleName = "TeadsSDK"
+let teadsAdMobAdapterModuleName = "TeadsAdMobAdapter"
+let teadsAppLovinAdapterModuleName = "TeadsAppLovinAdapter"
+let teadsSASAdapterModuleName = "TeadsSASAdapter"
+let mediationAdaptersDirectory = "MediationAdapters"
+let googleMobileAdsModuleName = "GoogleMobileAds"
+let appLovinMaxModuleName = "AppLovinSDK"
 let omModuleName = "OMSDK_Teadstv"
+let commonModuleName = "TeadsAdapterCommon"
+let commonModuleNamePath = "Common"
 
 let package = Package(
-    name: teadsModuleName,
+    name: "Teads",
     platforms: [
         .iOS(.v10),
     ],
@@ -15,6 +23,26 @@ let package = Package(
             name: teadsModuleName,
             targets: [teadsModuleName, omModuleName]
         ),
+        .library(
+            name: teadsAdMobAdapterModuleName,
+            targets: [teadsAdMobAdapterModuleName]
+        ),
+        .library(
+            name: teadsAppLovinAdapterModuleName,
+            targets: [teadsAppLovinAdapterModuleName]
+        ),
+    ],
+    dependencies: [
+        .package(
+            name: googleMobileAdsModuleName,
+            url: "https://github.com/googleads/swift-package-manager-google-mobile-ads.git",
+            from: "9.0.0"
+        ),
+        .package(
+            name: appLovinMaxModuleName,
+            url: "https://github.com/AppLovin/AppLovin-MAX-Swift-Package.git",
+            .upToNextMajor(from: "11.1.1")
+        ),
     ],
     targets: [
         .binaryTarget(
@@ -25,5 +53,29 @@ let package = Package(
             name: omModuleName,
             path: "Frameworks/\(omModuleName).xcframework"
         ),
+        .target(
+            name: commonModuleName,
+            path: "\(mediationAdaptersDirectory)/\(commonModuleNamePath)"
+        ),
+        .target(
+            name: teadsAdMobAdapterModuleName,
+            dependencies: [
+                .product(name: googleMobileAdsModuleName, package: googleMobileAdsModuleName),
+                .target(name: omModuleName),
+                .target(name: teadsModuleName),
+                .target(name: commonModuleName),
+            ],
+            path: "\(mediationAdaptersDirectory)/\(teadsAdMobAdapterModuleName)"
+        ),
+        .target(
+            name: teadsAppLovinAdapterModuleName,
+            dependencies: [
+                .product(name: appLovinMaxModuleName, package: appLovinMaxModuleName),
+                .target(name: omModuleName),
+                .target(name: teadsModuleName),
+                .target(name: commonModuleName),
+            ],
+            path: "\(mediationAdaptersDirectory)/\(teadsAppLovinAdapterModuleName)"
+        ),
     ]
 )

MediationAdapters/TeadsAppLovinAdapter/README.md

@@ -8,13 +8,6 @@
 
 Teads allows you to integrate a single SDK into your app, and serve premium branded "outstream" video ads from Teads SSP ad server. This sample app includes Teads iOS framework and is showing integration examples.
 
-
-> **⚠️ Important ⚠️**
->
-> ***Xcode 13***
->
-> In Xcode 13, Apple introduced an option to override the version number of every plist present inside your app (https://developer.apple.com/forums/thread/690647). Even those from third parties frameworks like TeadsSDK. We used to rely on the plist to retrieve the TeadsSDK version. To prevent this, we changed the way we checked the SDK version since version 5.0.6. So please update your integration to at least version 5.0.6.
-
 ## 📋 Table of Contents
 
 - [Integration Documentation](#-integration-documentation)
@@ -40,8 +33,6 @@ Clone this repository, open it with Xcode, and run project.
 
 ## 📦 Install the Teads SDK iOS framework
 
-Teads SDK is currently distributed through CocoaPods. It includes everything you need to serve "outstream" video ads. 
-
 ### Cocoapods
 
 To install the TeadsSDK just put this on your podfile, if you've never used cocoapods before please check the [offical documentation](https://guides.cocoapods.org/using/using-cocoapods.html).
@@ -56,6 +47,7 @@ On your terminal, go to the directory containing your project's `.xcodeproj` fil
 pod install --repo-update
 ```
 
+Before installing Teads adapter, you need to implement [Google Mobile Ads](https://developers.google.com/admob/ios/quick-start) in your application.
 
 ### Swift Package Manager
 
@@ -69,6 +61,7 @@ pod install --repo-update
 https://github.com/teads/TeadsSDK-iOS
 ```
 3. Next, set the **Dependency Rule** to be `Up to Next Major Version` and keep `5.0.0 < 6.0.0`.
+4. Choose the Teads product that you want to be installed in your app: `TeadsSDK`
 
 #### Alternatively, add Teads to your Package.swift manifest
 1. Add it to the `dependencies` of your `Package.swift`:
@@ -79,6 +72,18 @@ dependencies: [
 ]
 ```
 
+2. in any target that depends on a Teads product, add it to the `dependencies` array of that target:
+
+```swift
+.target(
+  name: "MyTargetName",
+  dependencies: [
+    // The product(s) you want (e.g. TeadsSDK).
+    .product(name: "TeadsSDK", package: "Teads"),
+  ]
+),
+```
+
 ## 🤝 Mediation Adapters
 - [Google AdMob](./MediationAdapters/TeadsAdMobAdapter/README.md)
 - [AppLovin Max](./MediationAdapters/TeadsAppLovinAdapter/README.md)
@@ -95,3 +100,4 @@ Teads SDK supports the [IAB](https://www.iabcertification.com/) [Open Measuremen
 
 See [changelog here](https://github.com/teads/TeadsSDK-iOS/releases). 
 
+Integration instructions are available on [Teads SDK Documentation](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation).