SDKの初期化

Suggest Edits

🚧

このドキュメントは古いバージョンのReact Native SDKについて記載しています

Native SDK v1に依存する旧React Native SDKは 2021/05/11でサポート終了となります。

SDK を利用するためには、アプリ起動時に初期化を行う必要があります。

SDK を初期化する（iOS）

SDKを初期化する

AppDelegate の application:didFinishLaunchingWithOptions: メソッド内で SDK の初期化を行います。

import KarteTracker

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
  
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    KarteTracker.setup(appKey: "YOUR_APP_KEY")
    ...
  }
}

#import "AppDelegate.h"
#import <KarteTracker/KarteTracker.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [KarteTracker setupWithAppKey:@"YOUR_APP_KEY"];
  ...
}

@end

オプションを指定して初期化を行う方法については、こちらをご覧ください。

🚧

Application Key について

初期化時に指定する Application Key は、KARTE管理画面に記載されている API_KEY とは異なります。
キーは営業担当よりお送りしているメールに記載されておりますので、こちらをご確認ください。

URLスキームをハンドルする

KARTE で独自に定義したURLスキームを処理するために、URLスキームハンドラを実装する必要があります。
管理画面に表示したQRコードを利用して、SDKの特定の機能を呼び出す際に本実装が必要となります。

import KarteTracker

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
  
 func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
        KarteUrlSchemeHandler.handle(url)
        return true
    }
}

#import "AppDelegate.h"
#import <KarteTracker/KarteTracker.h>
#import <KarteTracker/KarteUrlSchemeHandler.h>

@implementation AppDelegate
  
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    [KarteUrlSchemeHandler handle:url];
    return YES;
}

@end

SDK を初期化する（Android）

Application の onCreate() メソッド内で SDK の初期化を行います。

import android.app.Application
import io.karte.android.tracker.Tracker

class MainApplication : Application() {

  override fun onCreate() {
    super.onCreate()
    Tracker.init(this, "YOUR_APP_KEY")
  }
}

import android.app.Application;
import io.karte.android.tracker.Tracker;

public class MainApplication extends Application {
  
  @Override
  public void onCreate() {
    super.onCreate();
    Tracker.init(this, "YOUR_APP_KEY");
  }
}

オプションを指定して初期化を行う方法については、こちらをご覧ください。

Updated 5 months ago