Migrating from SDK 2

🚧

Covered in this guide

• Migrating from iOS SDK 2.x -> 3.x
• Migrating from React Native plugin 2.x -> 3.x

---

For Android, refer to the SDK 4 migration guide.

Introduction

In order to streamline Taboola integration, the SDK has undergone extensive changes. As such, when migrating from v2 to v3, treat it as a new integration.

Detailed migration guidelines are provided below.

📘

Placement codes used for v2 can be used with v3. No new codes are required.

Migrating from iOS SDK 2.x -> 3.x

🚧

Treat SDK 3 as a new integration.
It is not sufficient to update the pod file only.

1. Edit your pod file to use the latest SDK 3 version (<<iosSDKVersion>>).

   For detailed instructions, see:

   • iOS - Classic > First Steps
   • iOS - Web > First Steps

2. Run pod install.

3. Remove (or comment) out all Taboola SDK 2 code: init methods, setters, delegates, Storyboard elements, etc.

4. From within Xcode, select: Product > Clean Build Folder.

5. Build the project and verify it compiles correctly (with the removed SDK 2 code).

   Compilation errors?

   In the project root directory:

   • Run rm -rf Pods to remove all pod files.
   • Run pod install to install the SDK 3 pods.

6. Implement the SDK 3 integration - see:

   • iOS - Classic > Basic Integration
   • iOS - Web > Basic Integration

Migrating from React Native plugin 2.x -> 3.x

🚧

Treat React-Native 3.x as a new integration.

Make sure to comment out or delete old code related to React-Native 2.x and then proceed with the integration guide for 3.x