3. 初期化処理の実装¶
注意
以降の手順は主に Objective-C を使用する場合の手順を示しています。 Swift の利用については、 Swift の利用 を参照してください。
3.1. ヘッダファイルの import¶
NEC BaaS iOS SDK を使用する際は、"Nebula.h" を適宜 import する必要があります。 CocoaPods を使用している場合と、Framework を組み込んでいる場合とで import 方法が異なるので注意してください。
CocoaPods を使用している場合:
#import <NecBaas/Nebula.h>
Framework を組み込んでいる場合:
#import "nebulaIosSdk/Nebula.h"
Swift を使用する場合は、Bridging ヘッダ (プロジェクト名-Bridging-Header.h) ファイルに 上記 import 文を追加してください。
3.2. 初期化処理¶
SDK の利用に先立ち、初期化処理を一度だけ実行しておく必要があります。
初期化は NBCore クラスに対して行います。 以下にコード例を示します。
// テナントID
NSString *tenantId = @".....";
// アプリケーションID
NSString *appId = @".....";
// アプリケーションキー
NSString *appKey = @".....";
// エンドポイントURI
NSString *endPointUri = @"https://api.nebula.example.com/api/";
// 初期化
[NBCore setUpWithAppId:appId appKey:appKey tenantId:tenantId];
[NBCore setEndPointUri:endPointUri];
この処理は、AppDelegate クラスの application:didFinishLaunchingWithOptions: メソッド内で 実施することを推奨します。
初期化時には以下のパラメータが必要です。
- テナントID
- アプリケーションID
- アプリケーションキー
- エンドポイントURI
テナントID、アプリケーションID・キーについては、デベロッパコンソールで作成しておく必要が あります。手順については、チュートリアル(iOS)に記載してありますので、そちらをご参照ください。
また、setEntpointUri でエンドポイント URI を指定する必要があります。 エンドポイントURIは、APIサーバのベースURIです。これはシステム毎に異なりますので、サーバ運用者に 確認してください。通常は "https://ホスト名/api/" のような形式になります。