🚧

Expoプラグインは Beta 版として提供中です

Expoプラグインは現在 Beta 版として提供しております。
そのため、今後予告なく仕様変更を伴う機能改善やAPIの破壊的変更が行われる可能性があります。

またexpoではビジュアルトラッキング、設定値配信については動作未検証です。

導入手順（Expo）

1. パッケージをインストールする

プロジェクトを Managed Workflow で開発する場合は、下記パッケージをインストールします。

npm install @react-native-karte/core
npm install @react-native-karte/notification
npm install @react-native-karte/in-app-messaging
npm install karte-expo-plugin

🚧

パッケージ導入に関する注意点

karte-expo-plugin では @react-native-karte/core @react-native-karte/in-app-messaging @react-native-karte/notification の導入が必須です。

2. React Native Firebase を導入する

npm install @react-native-firebase/app
npm install @react-native-firebase/messaging

導入に関しては、下記ドキュメントをご覧ください。

• プッシュ通知を受信する

3. KARTE 設定ファイルをプロジェクトに追加する

iOS, Android それぞれの設定ファイルダウンロードします。

ダウンロード方法に関しては、下記ドキュメントをご覧ください。

• SDKの設定ファイルをダウンロードする

ダウンロードしたファイルをプロジェクトディレクトリに移動します。

4. app.json ファイルを編集する

app.json ファイルに、設定ファイルのパスを指定します。Firebaseプラグインの設定も追加します。

{
  "expo": {
    "plugins": [
      [
        "karte-expo-plugin",
        {
          "karteInfoPlist": "./Karte-Info.plist",
          "karteXml": "./karte.xml"
        }
    	],
      "@react-native-firebase/app",
      [
        "expo-build-properties",
        {
          "ios": {
            "useFrameworks": "static"
          }
        }
      ]
    ]
  }
}

5. ネイティブコードを生成する

npx expo prebuild --clean

詳細については Expo のドキュメントをご覧ください。

🚧

実行環境について

ExpoプラグインはExpo Go環境では動作しません。 npx expo prebuild --clean コマンド実行後、プラットフォームに合わせて以下のコマンドを実行するかXcode/AndroidStudioからネイティブ環境で実行してください。

Shell

npx expo run:ios
npx expo run:android