iOS

Hive SDK를 설치 후 수행하는 작업을 안내합니다.

접근 권한 요청 설정하기¶

Hive SDK 설치 후 카메라, 사진첩 및 추적에 대한 접근 권한을 얻기 위해 Info.plist에 키를 추가하세요.

1. Xcode 프로젝트 창의 프로젝트 네비게이터에서 여러분의 프로젝트를 선택하세요.
2. TARGETS 목록에서 여러분의 앱을 선택하세요.
3. Info 탭을 클릭하세요.
4. Info 탭의 Custom iOS Target Properties 항목을 클릭하세요.
5. Custom iOS Target Properties 목록에서 마우스 오른쪽 버튼을 클릭하세요.
6. Add Row 메뉴를 클릭하세요.
7. Key 항목에 NSCameraUsageDescription을 입력하고, Value 항목은 다국어 설정 파일 > Base.Iproj 폴더 > InfoPlist.strings에 명시된 값을 추가합니다.
8. NSPhotoLibraryUsageDescription, NSUserTrackingUsageDescription 키도 6번-7번 과정을 반복하세요.

권한 요청 설정 시 아래 사항을 유의하세요.

1. 다국어 설정 파일에 명시된 게임 유저에게 권한 승인을 요청하는 메시지를 작성하세요. 권한 승인 요청 팝업 메시지를 입력하지 않으면 사용중인 사용자 접근 권한에 대한 추가 설명 가이드가 누락되어 앱 검수 시 거부(Reject)됩니다.
2. NSPhotoLibraryUsageDescription, NSCameraUsageDescription, NSUserTrackingUsageDescription 키의 대응 값은 Apple의 법적 요구 사항 가이드라인에 따라 권한 사용 목적을 알리고, 유저가 허용했을 때만 사용할 수 있도록 해야 합니다. 다국어 설정 파일은 사진첩, 카메라, 추적 사용 권한이 필요할 때 유저에게 요청 목적에 대해 알리고 사용을 허용할 수 있도록 팝업 문구를 언어별로 제공합니다.
3. 업데이트된 Permission.strings 파일을 적용한다면 해당 파일도 반드시 변경해야 합니다. 그렇지 않으면 앱스토어 업로드 단계에서 여러분의 앱이 거부(Reject)될 수 있습니다.

권한이나 기타 문제로 Capability 목록에 보이지 않을 경우에는 Apple 개발자 콘솔에서 Sign In with Apple 항목을 활성화하세요. 이후 갱신된 프로비저닝이 적용되면 4~6 순서를 다시 진행해 IdP를 추가합니다.

HIVEAppDelegate 적용하기¶

유저 인게이지먼트, 앱 링크, 푸시 등으로 앱을 실행하기 위한 설정입니다. AppDelegate.m 파일의 application:didFinishLaunchingWithOptions: API에서, Hive 플랫폼이 제공하는 HIVEAppDelegate의 application:didFinishLaunchingWithOptions: API를 호출하세요.

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

KeyChain 설정하기 (선택)¶

앱에서 KeyChain-GroupSharing 기능을 사용하는 경우 Hive SDK 설치 후 KeyChain Groups를 설정해야 합니다. KeyChain-GroupSharing을 사용하지 않는 경우는 특별한 추가 설정이 필요 없습니다. Hive SDK는 iOS 타겟에서 KeyChain을 사용하고 있습니다.

첫번째 이름으로 AppId와 동일한 값을 지정해야 합니다.