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

サポート環境

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

NHN Cloud SDKの構成

  • iOS用NHN Cloud 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を選択します。

swift_package_manager

プロジェクト設定

  • Build SettingsOther Linker Flags-lc++-ObjC項目を追加します。
    • Project Target > Build Settings > Linking > Other Linker Flags 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プロジェクトに追加します。
    carthage_import_framework

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

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

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

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

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

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

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

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

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

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

Project Settings

  • Build SettingsOther Linker Flags-lc++-ObjC項目を追加します。

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

    • Project Target > Build Settings > Build Options > Enable Bitcode 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使用

TOP