iOS

This guide explains the tasks to perform after installing the Hive SDK.

Setting access permissions¶

After installing the Hive SDK, add keys to Info.plist to obtain access permissions for the camera, photo library, and tracking.

1. Select your project in the project navigator of the Xcode project window.
2. Select your app from the TARGETS list.
3. Click on the Info tab.
4. Click on the Custom iOS Target Properties section in the Info tab.
5. Right-click on the Custom iOS Target Properties list.
6. Click on the Add Row menu.
7. Enter NSCameraUsageDescription in the Key field and add the value specified in the multilingual settings file > Base.Iproj folder > InfoPlist.strings in the Value field.
8. Repeat steps 6-7 for the NSPhotoLibraryUsageDescription and NSUserTrackingUsageDescription keys.

When setting access permissions, keep the following in mind:

1. Write a message requesting permission from game users as specified in the multilingual settings file. If you do not enter a permission request popup message, additional explanation guidance for user access permission in use will be omitted, and your app may be rejected during app review.
2. The corresponding values for the NSPhotoLibraryUsageDescription, NSCameraUsageDescription, and NSUserTrackingUsageDescription keys must inform the user of the purpose of permission use and can only be used if the user allows it, in accordance with Apple's legal requirement guidelines. The multilingual settings file provides popup phrases for each language to inform the user about the purpose of the request and allow use when photo library, camera, and tracking permissions are required.
3. If you apply the updated Permission.strings file, you must also change the corresponding file. Otherwise, your app may be rejected during the App Store upload phase.

If the Sign In with Apple option does not appear in the Capability list due to permissions or other issues, activate the Sign In with Apple item in the Apple Developer Console. After the updated provisioning is applied, repeat steps 4-6 to add the IdP.

Applying HIVEAppDelegate¶

This is the configuration to launch the app with user engagement, app links, push notifications, etc. In the application:didFinishLaunchingWithOptions: API of the AppDelegate.m file, call the application:didFinishLaunchingWithOptions: API provided by the Hive platform.

import HIVEService    

@UIApplicationMain    
class AppDelegate: UIResponder, UIApplicationDelegate {    

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {           
        return HIVEAppDelegate.application(application, didFinishLaunchingWithOptions: launchOptions)    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    

@interface AppDelegate ()    
@end    

@implementation AppDelegate    

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    
        return [HIVEAppDelegate application:application didFinishLaunchingWithOptions:launchOptions];    
  }    

@end

Setting up keychain (optional)¶

If your app uses the KeyChain-GroupSharing feature, you need to set up KeyChain Groups after installing the Hive SDK. If you do not use KeyChain-GroupSharing, no additional configuration is required. The Hive SDK uses KeyChain on iOS targets.

The first name must be the same as the AppId.