NHN Cloud > SDK使用ガイド > 開始する > iOS

サポート環境

• iOS 11.0以上
• XCode最新バージョン(バージョン14以上)

NHN Cloud SDKの構成

• iOS用NHN Cloud SDKの構成は次のとおりです。

  • Logger SDK
  • In-app Purchase AppStore SDK
  • Push SDK OCR SDK

• NHN Cloud SDKが提供するサービスの中から、希望する機能を選択して適用できます。

Service	Cocoapods Pod Name	Carthage	Framework	Deployment Target	Dependency	Build Settings
All	NHNCloudSDK	binary "https://nh.nu/nhncloudsdk	NHNCloudCore.framework NHNCloudCommon.framework NHNCloudLogger.framework NHNCloudIAP.framework NHNCloudPush.framework
Mandatory	NHNCloudCore NHNCloudCommon		NHNCloudCore.framework NHNCloudCommon.framework	11.0		OTHER_LDFLAGS = ( "-ObjC", "-lc++" );
Log & Crash	NHNCloudLogger		NHNCloudLogger.framework	11.0	[External & Optional] * CrashReporter.framework (NHNCloud)
IAP	NHNCloudIAP		NHNCloudIAP.framework	11.0	* StoreKit.framework [Optional] * libsqlite3.tdb
Push	NHNCloudPush		NHNCloudPush.framework	11.0	* UserNotifications.framework [Optional] * PushKit.framework
OCR	NHNCloudOCR		NHNCloudOCR.framework	11.0	* Vision.framework * AVFoundation.framework

NHN Cloud SDKをXcodeプロジェクトに適用

1. Cococapodsを使用してNHN Cloud SDK適用

• Podfileを作成してNHN Cloud SDKのPodを追加します。

platform :ios, '11.0'
use_frameworks!

target '{YOUR PROJECT TARGET NAME}' do
    pod 'NHNCloudSDK'
end

2. Swift Package Managerを使用してNHN Cloud SDK適用

• XCodeでFile > Add Packages...メニューを選択します。
• Package URLに'https://github.com/nhn/nhncloud.ios.sdk'を入れてAdd Packageボタンを選択します。
• 追加したいLibraryを選択します。

プロジェクト設定

• Build Settingsの Other Linker Flagsに-lc++と-ObjC項目を追加します。
  • Project Target > Build Settings > Linking > Other Linker Flags

3. Carthageを使用してNHN Cloud SDK適用

• Cartfileを作成してNHN Cloud SDKを追加します。

# Full URL
binary "https://api-storage.cloud.toast.com/v1/AUTH_f9e3dc598ca142d3820e1c19343d5428/carthage/NHNCloudSDK.json"

# Short URL
binary "https://nh.nu/nhncloudsdk"

• 作成されたCarthage/BuildフォルダのFrameworkをXcodeプロジェクトに追加します。
  

• プロジェクトに次のようにフレームワーク(framework)が追加されたことを確認します。

• NHN Cloud SDKを使用するためにフレームワーク設定とプロジェクト設定を行う必要があります。

サービスのいずれかの機能を選択して使用するには、サービスごとに必要なFrameworkのみ選択してプロジェクトに追加する必要があります。 サービスごとに必要なFrameworkはNHN Cloud SDKの構成で確認できます。

4. バイナリをダウンロードしてNHN Cloud SDK適用

Link Frameworks

• NHN CloudのDownloadsページで全体iOS SDKをダウンロードできます。

• NHN Cloud LoggerのCrash Report機能を使用するには、一緒に配布されるCrashReporter.frameworkもプロジェクトに追加する必要があります。

• プロジェクトに次のようにフレームワーク(framework)が追加されたことを確認します。

• IAP機能を使用するには、StoreKit.frameworkを追加する必要があります。

• Push機能を使用するには、UserNotifications.frameworkを追加する必要があります。

xcframework

• xcframeworkを使用するとarm simulatorでもNHN Cloud SDKを使用できます。

Project Settings

• Build SettingsのOther Linker Flagsに-lc++と-ObjC項目を追加します。

  • Project Target > Build Settings > Linking > Other Linker Flags

• CrashReporter.frameworkを直接ダウンロードするか、ビルドした場合はBuild SettingsのEnable Bitcodeの値をNOに変更する必要があります。

  • Project Target > Build Settings > Build Options > Enable Bitcode

    NHN Cloud SDKのDownloadsページでダウンロードしたCrashReporter.frameworkは、bitCodeをサポートします。

フレームワークのインポート

• 使用するフレームワークをインポートします(import)。

#import <NHNCloudCore/NHNCloudCore.h>
#import <NHNCloudLogger/NHNCloudLogger.h>
#import <NHNCloudIAP/NHNCloudIAP.h>
#import <NHNCloudPush/NHNCloudPush.h>
#import <NHNCloudOCR/NHNCloudOCR.h>

UserID設定

• NHN Cloud SDKにユーザーIDを設定できます。
• 設定したUserIDは、NHN Cloud SDKの各モジュールで共通使用されます。
• NHN Cloud SDK Loggerのログ送信APIを呼び出すたびに、設定したユーザーIDをログと一緒にサーバーに送信します。

UserID API仕様

+ (void)setUserID:(NSString *)userID;

UserID設定使用例

[NHNCloudSDK setUserID:@"NHNCloud-USER"];

デバッグモード設定

• NHN Cloud SDKの内部ログを確認するために、デバッグモードを設定できます。
• NHN Cloud SDKに関するお問い合わせの際は、デバッグモードを有効にしていただくと、迅速にサポートできます。

デバッグモード設定API仕様

+ (void)setDebugMode:(BOOL)debugMode;

デバッグモード設定使用例

[NHNCloudSDK setDebugMode:YES];    // or NO

[注意]アプリをリリースする場合、デバッグモードを無効化する必要があります。

NHN Cloud SDK Service使用

• Log & Crash使用ガイド
• In-app Purchase使用ガイド
• Push使用ガイド
• OCR使用ガイド