VMAX
 
 
 
 
Show Sidebar

Xcode Plugin for iOS

Maaf, entri ini hanya boleh didapati dalam bahasa English. For the sake of viewer convenience, the content is shown below in the alternative language. You may click the link to switch the active language.

Plugin version: 1.0

The Xcode plugin has been designed to reduce the time taken by developers to integrate the VMAX iOS SDK into Xcode projects. With a few simple steps to setup the plugin, integrating the VMAX iOS SDK and Mediation is easier than ever.

Minimum Requirements:

  • Xcode 7 or later
  • Mac running OS X version 10.10.4 or later
  • The earliest VMAX iOS SDK supported is v3.5.11

Note: The plugin is ONLY intended to be used with final Xcode releases, using the plugin with beta Xcode releases is not recommended.

Installing the plugin

    • Quit Xcode
    • Copy the VMaxSDKPlugin.xcplugin file to the following directory on your Mac:
      VMaxSDKPlugin.xcplugin installation

      VMaxSDKPlugin.xcplugin installation

 

  • Re-open Xcode, you will be prompted with a dialog asking whether you want to load or skip (default selected option) the bundle installation; choose ‘Load Bundle’
    Load Bundle

    Load Bundle

Getting Started

In Xcode, select ‘Product’ from the main menu; then select VMAX SDK Integrator

VMAX SDK Integrator

VMAX SDK Integrator

The integrator will ask you to allow the downloading of the VMAX iOS SDK from VMAX website. Allow it, this is a one time process.

Downloading the VMAX iOS SDK

Downloading the VMAX iOS SDK

On completion, the Xcode project which was active when the VMAX SDK Integrator was selected from Product menu is selected. Click Browse to select another project if needed. Click Next.

Xcode project selection

Xcode project selection

On the Next screen, add one or more mediation partners supporting the different ad formats. By default, none are selected. To add a mediation partner:

    • Click the plus (+) button next to the desired ad format(s)
    • Select the checkbox on the left of the mediation partner
Adding mediation partners

Adding mediation partners

Mediation partner selection

Mediation partner selection

Selected mediation partners

Selected mediation partners

 

Note: To remove a mediation partner, click the minus (-) button next to each mediation partner. Click ‘View Code’ to view the invocation code for the ad format.

    • Click Next. Drag and drop the integrator icon onto your Xcode Project navigator window (Shortcut: Command + 1). The integrator will copy the VMAX iOS SDK & mediation partner adapter files into the project directory. Click Finish in Xcode when prompted.
Drag & drop integrator onto Xcode Project navigator

Drag & drop the integrator icon onto Xcode Project navigator

VMAX SDK and mediation partners added by integrator

VMAX SDK and mediation partners added by integrator in Xcode project navigator

 

    • Click Next in the integrator. You will see the list of System Frameworks required for the mediation partners and the SDK.
Required System frameworks

Required System frameworks

 

      Navigate to Project > Target > Build Phases > Link Binary With Libraries > Click + to add the listed frameworks.
Linking System Frameworks

Linking System Frameworks

 

    • Click Next in the integrator & complete the required settings as shown in Xcode.

Tip: The copy button in the integrator will copy the setting to Clipboard for easier pasting in Xcode.

Additional settings

Additional settings

App transport security & location services settings

App transport security & location services settings (Info.plist opened in external text editor)

Add '-ObjC' to Other Linker Flags

Add ‘-ObjC’ to Other Linker Flags

Set 'Enable Bitcode' to NO

Set ‘Enable Bitcode’ to NO

  • Click Finish in the integrator

The next step is to request ads.

Important Note: As you have already added the mediation partner files, you do not need to add them again as mentioned here. Post adding the code for requesting ads, move on to the section for testing the integration.