Follow

Embarcadero Platform Component Integration Version 1.0

 + 

 

Component Overview:

Aerserv Embarcadero Component is a Delphi and C++Builder library that allow Embarcadero developers access over 35 mobile ad network, support mobile video ads, and the abilities to utilize Aerserv advance mobile ad mediation platform.  

Download Requirements:

 

Product versions: (16.0 = XE8)

Library platforms: List of supported platforms x86; x64

Library OS:         Window, Android, IOS

Library Framework: VCL & FMX

Installation process:

1) Open “Aerserv\ProjectGroup1.groupproj” using RadStudio XE8

2) Compile “Aerserv\AerservSDK.bpl” for Window, IOS 32 & 64 bit, Android

3) Install “AerservSDK.bpl” package and Add Source path as FM

4) Install AerServBannerAdComponent & AerServInterstitialAdComponent and Add Source Path as Delphi

Uninstallation process:

1) Uninstall “AerservSDK.bpl” package

2) Remove “source\”  library path for Delphi 

 

Additional Notes:

  • When you run PAServer on the Mac, a Terminal window opens; it is recommended that you type “v” to enable verbose mode.  
  • You should also type “i” to display the IP address of the Mac; you will need this information when setting up and testing the PC’s connection profile to the Mac.
  • If you have previously installed a version of PAServer from an earlier version of RadStudio, make sure that the earlier version is not running before starting the latest version.

 

Step 1: Open “Aerserv\ProjectGroup1.groupproj”

Step 2: Compile “Aerserv\AerservSDK.bpl” for Window, IOS, Android OS1.

Select the top project by double-clicking on it.  This will be named either “AerServSDK.bpl” or “bplAerServSDK.dylib” or AerServSDk.so  depending which target you choose.

  1. Select 32-bit Windows Target, Right Click on AerServSDK.bpl, & select Build
  2. Select 32-bit IOS Target, Right Click bplAerServSDK.dylib,  & Select Build
  3. Select 64-bit IOS Target, Right Click bplAerServSDK.dylib,  & Select Build
  4. Select Android Target, Right Click and Build AerServSDk.so , & select Build
  5. This will create the package AerServSDK.Bpl that is needed for adding the component to the Delphi Tool Palette.  

This is a Windows DLL that is used to display the component in the Delphi Tool Palette and Object Inspector.

If you are using XE8, this will be found in your Embarcadero Folder

Default File Directory, : C:\Users\Public\Documents\Embarcadero\Studio\16.0\Bpl

The “16.0” will be a different number if you are using a version of RadStudio newer than XE8.

Step 3: Installing AerServ FireMonkey as a Packages in your Project

Step 4: Uninstallation Process

Step 5: Integrating IOS Component

The additional IOS frameworks needed to build against the AerServ SDK installed on the Windows PC

  1. In RadStudio, choose Tools | Options | Environment Options | SDK Manager.
  2. In the “SDK versions” panel, select one of the SDKs against which you intend to build (e.g., iOS Device  32 bit | iPhoneOS 8.3).
  3. Press the button near the upper right to “Add Remote Path Item”

Adding IOS required Frameworks

  1.  “$(SDKROOT)/System/Library/Frameworks” into the “Path on remote machine:” edit field.
  2. Enter “AdSupport” into the “Framework name:” field.
  3. Leave the radio buttons and checkbox unselected.
  4. Press “OK”.
  5. Repeat the steps of the above paragraph for each of the following in place of “AdSupport” for the “Framework name:”:
  • AdSupport
  • CoreMIDI
  • MediaToolbox
  • AudioToolbox
  • CoreAudio
  • EventKitUI
  • MessageUI
  • Metal
  • AVKit
  • CoreTelephony
  • EventKit
  • SystemConfiguration

 

Adding IOS required Lib

  1. Type text “$(SDKROOT)/Users/Lib” into the “Path on remote machine:” 
  2. Enter libxml2.2.dylib
  3. Press “OK”

 

Then press “Update Local File Cache” in order to copy the associated files from the Mac to Windows.

Repeat all of the above steps (adding the 11 additional frameworks) for each SDK version you need to support (eg, iOS Device  32 bit | iPhoneOS 8.4 and iOS Device  64 bit | iPhoneOS 8.4).

Remember that if you add a new SDK in the future (e.g., iOS 8.4), you have to add these again for each SDK version.

 

 

Adding Required Search path 

To use the  components in a Delphi project targeting iOS apps, select Project | Options | Delphi Compiler. Select an appropriate Target (e.g., “Debug configuration – iOS Device- 32-bit platform”), and then “Search path”.

Enter the directories where the

1. Aerserv .dcu files
Example directory: C:\Users\<username>\Documents\download\Aerserv\IOS32\Release
 
 
2. AerServ universal binary file
Example directory : C:\Users\<username>\Documents\Work\AerServ\aerserv-ios-sdk-latest\target\aerserv-ios-sdk\lib\AerServSDK.framework;
 
3. libxml2.2.dylib library 
Example direcotory: C:\Users\<username>\Documents\Embarcadero\Studio\SDKs\iPhoneOS8.4.sdk\usr\lib

Remember to do this for all targets of the app. For example:

“Debug configuration - iOS Device - 32-bit platform”

“Debug configuration - iOS Device - 64-bit platform”

“Release configuration - iOS Device - 32-bit platform”

“Release configuration - iOS Device - 64-bit platform”

If you are unlikely to change or add to this setting for any configuration or target:

“All configurations - iOS Device - 32-bit platform”

“All configurations - iOS Device - 64-bit platform”

 

 

Adding Required LD linker 

In Delphi, this setting is made using Project | Options… | Delphi Compiler | Linking | Options passed to the LD linker. –ObjC

Example of LD linker: 

-ObjC -LC:\Users\<user>\Documents\Embarcadero\Studio\SDKs\iPhoneOS8.4.sdk\usr\lib 

Frameworks\AdSupport.framework\AdSupport Frameworks\AudioToolbox.framework\AudioToolbox Frameworks\AVFoundation.framework\AVFoundation Frameworks\CoreGraphics.framework\CoreGraphics Frameworks\CoreMedia.framework\CoreMedia Frameworks\CoreTelephony.framework\CoreTelephony Frameworks\EventKit.framework\EventKit Frameworks\EventKitUI.framework\EventKitUI Frameworks\MessageUI.framework\MessageUI Frameworks\StoreKit.framework\StoreKit Frameworks\SystemConfiguration.framework\SystemConfiguration -lxml2.2

 

 

Included AerServCommon to use statement 

Step 6: Integrating Android Component

AerServ SDK:

With Android selected as Target in the Project Manager pane, expand the Android target node. Right click on the Libraries node and from the AerServ Android SDK’s lib subdirectories add:

aerserv-sdk.jar

 

Search Path

In Project | Options | Delphi Compiler, set the Search Path to the directory containing the .dcu files of the FM component. For example, on the component development machine, this is usually:

C:\Users\<users>\Documents\Embarcadero\Studio\Projects\AerServ\Android\Release

Note: on the system of a developer using the FM component, this would be something quite different, namely the deployment directory containing the Android version of the .dcu files.

 

Permissions:

In Project | Options | Uses Permissions, in addition to whatever permissions your app otherwise requires and in addition to the defaults set by Delphi, make sure that the following are set to “true”:

  • Access coarse location
  • Access fine location
  • Access network state
  • Internet
  • Read GServices
  • Read phone state
  • Vibrate
  • Write external storage
 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk