Migrate to Version 6.4+

HyprMX SDK 6.4+ contains a revamp to our public API, streamlining our SDK's initialization and providing more focused callbacks and delegates. Additionally, we now provide modernized asynchronous APIs that you can opt into, and have removed the main thread requirement from all of our public methods.

SDK Migration

The HyprMX iOS SDK 6.x can be migrated to 6.4+ through CocoaPods or by Manual Migration.

CocoaPods

To migrate the HyprMX SDK with CocoaPods, update the pod to 6.4.4 in your Podfile:

pod 'HyprMX', '6.4.4'

Run pod install from the terminal in the directory containing your Podfile.

Manual Migration

To manually migrate the framework, follow the steps below.

1

Download the SDK here and unzip the file.

2

Right-click on HyprMX.xcframework in your project navigator and select Show in Finder.

3

Drag and drop the new 6.4+ HyprMX.xcframework (available in the zip) into the folder that contains the 6.3 HyprMX.xcframework and replace the old one.

Fixing Your Broken Build

See below for migrations related to HyprMX SDK 6.4+.

Migrating HyprMX.initialize

The new SDK initializer now only requires a distributorId, and takes a completion closure or returns a Result depending on the API chosen:

switch await HyprMX.initialize(distributor: distributorId) {
    case .success:
        // successful init logic
    case .failure(let error):
        print(error)
        // failed init logic
}

HyprMX.initialize(distributorId) { success, error in
    if success {
        // successful init logic
    } else {
        print(error)
        // failed init logic
    }
}

[HyprMX initWithDistributorId:distributorId
                   completion: ^(BOOL success, NSError * _Nullable error) {
    if (success) {
        // successful init logic
    } else {
        NSLog(@"%@", [error description]);
        // failed init logic
    }
}];

Other parameters that used to be provided to the initialization API now have new setters. These parameters can now be set after initialization when the information is available. As a result, you will need to migrate the following parameters:

• consentStatus

• ageRestrictedUser

• userID

Follow the steps below to migrate the parameters.

Migrating the consentStatus parameter

HyprMX.setConsentStatus(CONSENT_GIVEN)
// OR
HyprMX.setConsentStatus(CONSENT_DECLINED)

[HyprMX setConsentStatus:CONSENT_GIVEN];
// OR
[HyprMX setConsentStatus:CONSENT_DECLINED];

Migrating the ageRestrictedUser parameter

HyprMX.setAgeRestrictedUser(true)

[HyprMX setAgeRestrictedUser:YES];

Migrating the userID parameter

Our API no longer accepts user ID.

HyprMXInitializationDelegate

HyprMXInitializationDelegate has been replaced with async Result or completion closure. To migrate existing code:

switch await HyprMX.initialize(distributor: distributorId) {
    case .success:
        // initializationDidComplete logic
    case .failure(let error):
        print(error)
        // initializationFailed logic
}

HyprMX.initialize(distributorId) { success, error in
    if success {
        // initializationDidComplete logic
    } else {
        print(error)
        // initializationFailed logic
    }
}

[HyprMX initWithDistributorId:distributorId
                   completion: ^(BOOL success, NSError * _Nullable error) {
    if (success) {
        // initializationDidComplete logic
    } else {
        NSLog(@"%@", [error description]);
        // initializationFailed logic
    }
}];

Migrating HyprMXPlacement.isAdAvailable

If used in any Swift source files, remove trailing parenthesis from placementInstance.isAdAvailable

Migrating HyprMXPlacement.loadAd

loadAd doesn't use a delegate in HyprMX SDK 6.4+. Instead, it returns results via async result or completion based callbacks. To migrate existing code:

let success = await placement.loadAd()
if success {
    // ad available logic
} else {
    // not available logic
}

placement.loadAd() { success in
    if success {
        // ad available logic
    } else {
        // not available logic
    }
}

[placement loadAdWithCompletion:^(BOOL success) {
    if (success) {
        // ad available logic
    } else {
        // not available logic
    }
}];

Migrating HyprMXPlacementDelegate

HyprMXPlacementDelegate has been renamed to HyprMXPlacementShowDelegate. The SDK takes the delegate as a parameter in showAd, and stops using that delegate instance after calling adDidClose. To migrate existing code:

class MyPlacementDelegate: NSObject, HyprMXPlacementShowDelegate {

@interface MyPlacementDelegate : NSObject<HyprMXPlacementShowDelegate>

placement.showAd(from: viewController, delegate: showDelegate)

[placement showAdFromViewController:viewController delegate:showDelegate];

class MyPlacementDelegate: NSObject, HyprMXPlacementShowDelegate, 
                                     HyprMXPlacementExpiredDelegate {

@interface MyPlacementDelegate: NSObject<HyprMXPlacementShowDelegate, 
                                         HyprMXPlacementExpiredDelegate>

placement.expiredDelegate = placementDelegate

placement.expiredDelegate = placementDelegate;

//func adWillStart(for placement: HyprMXPlacement) {
func adWillStart(placement: HyprMXPlacement) {

//func adDidClose(for placement: HyprMXPlacement, didFinishAd finished: Any!) {
func adDidClose(placement: HyprMXPlacement, finished: Bool) {

//func adDisplayError(_ error: Any!, placement: HyprMXPlacement)
func adDisplay(error: NSError, placement: HyprMXPlacement)

//func adDidReward(for placement: HyprMXPlacement, rewardName: Any!, rewardValue: Any!)
func adDidReward(placement: HyprMXPlacement, rewardName: String?, rewardValue: Int)

//func adExpired(for placement: HyprMXPlacement)
func adExpired(placement: HyprMXPlacement)

HyprMXBannerView.loadAd

loadAd doesn't use a delegate in HyprMX SDK 6.4+. Instead, it returns results via async or completion based paths. To migrate existing code:

let success = await bannerView.loadAd()
if success {
    // adDidLoad logic
} else {
    // adFailed logic
}

bannerView.loadAd() { success in
    if success {
        bannerDelegate.adDidLoad(bannerView)
    } else {
        bannerDelegate.adFailed(toLoad: bannerView, error: nil)
    }
}

[bannerView loadAdWithCompletion:^(BOOL success) {
    if (success) {
        [bannerDelegate adDidLoad:placement];
    } else {
        [bannerDelegate adFailedToLoad:placement error:nil];
    }
}];

That's it! You're done with the migration.