Manual Integration

1. Installation

Please make sure Deployment Target is 8.0 or above and you are using Xcode 8.0 or above.

Open your project in Xcode, click on the project file, and select the target of the application, then click Build Phases.

Please add the following frameworks under the Link Binary With Libraries section or paste the following to the top of your AppDelegate.h/AppDelegate.swift) file:

Objective-C
Swift
@import AVFoundation;
@import AdSupport;
@import AudioToolbox;
@import CFNetwork;
@import CoreBluetooth;
@import CoreData;
@import CoreGraphics;
@import CoreImage;
@import CoreLocation;
@import CoreMedia;
@import CoreMotion;
@import CoreTelephony;
@import CoreVideo;
@import EventKit;
@import EventKitUI;
@import Foundation;
@import GLKit;
@import ImageIO;
@import JavaScriptCore;
@import MapKit;
@import MediaPlayer;
@import MediaToolbox;
@import MessageUI;
@import MobileCoreServices;
@import QuartzCore;
@import SafariServices;
@import Security;
@import Social;
@import StoreKit;
@import SystemConfiguration;
@import UIKit;
@import WatchConnectivity;
@import WebKit;

The following needs to be added manually by drag and drop in the to the Link Binary With Libraries section of your project:

  • libz.tbd
  • libz.1.2.5.tbd
  • libc++.tbd
  • libsqlite3.0.tbd
  • libxml2.tbd

B. Add the Tapdaq framework

Drag the unzipped Tapdaq.framework into your project (under the Frameworks group). We recommend that you tick Copy items into destination group's folder. Next, add Tapdaq.framework to the Link Binary With Libraries section of your project.

Swift bridging header

If you are using Swift in your project, you need to create a bridging header if you haven't done so already.

To do this, create a Header File (File > New > File...) and name it with the following format; YourProject-Bridging-Header.h replace YourProject with your project name. Save the file in your project directory.

Once created, add the following:

#import <Tapdaq/Tapdaq.h>

Next, go to your Build Settings and search for Objective-C Bridging Header property.

Once you have found it, add this as the value: $(PROJECT_DIR)/YourProject-Bridging-Header.h.

Remember to replace YourProject with your project name.

Build Settings

Build Settings Navigate to the Build Settings of the app's target. Select the All tab. Search for the following entries and make sure all of them are set to or contain these values:

Key Value
Objective-C Automatic Reference Counting YES
Enable Modules (C and Objective-C) YES
Other Linker Flags -ObjC

2. Add Adapters

A. Add ad network dependencies

Depending on the ad networks required, their SDKs should be added to the project.

These SDKs can be found within a folder with network's respective name in Network-SDKs directory.

All .a and .framework files should be added to Link Binary With Libraries within General section of your project settings.

If you wish to use one of the following networks, please add frameworks listed below to Embedded Binaries within General section of your project settings.

Network Framework(s)
YouAppi YouAppiMoat.framework

B. Add ad network adapters

In order for Tapdaq SDK to be able to access network SDKs, respective adapter has to be added to the project.

Tapdaq SDK will automatically detect if the ad network adapters are included in your project.

To add them, use the adapters provided in the zip, they will be located in the adapters folder. Drag and drop them to the Link Binary With Libraries section under the General tab.

C. Add ad network resources

Some networks may require their resources to be added to the app.

If you wish to use one of the following adapters, please navigate to Network-SDKs and then to a folder named after the network you require, inside there is one or more .bundle file.

Network Bundle(s)
Tapjoy TapjoyResources.bundle
MoPub MoPub.bundle
Kiip KiipSDKResources.bundle
Zplay ZplayMuteListener.bundle

Please add these bundles to your Copy Bundle Resources section under Build Phases.

D. YouAppi specific steps

When including YouAppi to your project, you must add YouAppiMoat.framework section. Also, you should add YouAppiAdapter.framework to Project Settings -> General -> Embedded Binaries.

Navigate to the Build Settings of the app's target. Select the All tab. Search for the following entries and make sure all of them are set to YES:

Key Value
ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES YES
DEFINES_MODULE YES

Need help?

If you are having any problems integrating, feel free to contact us on [email protected] and we will be more than happy to help.