expo-enode-link-sdk

An Expo Module integration for Enode's Link SDK

Android

[!NOTE]
This step is no longer required if using Expo 50+. The new default is 34

The Enode SDK requires Android SDK version 34+ and the minimum SDK 23+. It is required to add this to your app's app.json under plugins.

"plugins": [
  [
    "expo-build-properties",
    {
      "android": {
        "minSdkVersion": 23,
        "compileSdkVersion": 34,
        "targetSdkVersion": 34,
        "buildToolsVersion": "34.0.0"
      }
    }
  ],
  // your other plugins, if any
]

If not already installed, you'll also need to install expo-build-properties

npx expo install expo-build-properties

IOS

The enode SDK uses bluetooth and therefore you need to add this in your app's app.json under ios.

"ios": {
  "infoPlist": {
    "NSBluetoothAlwaysUsageDescription": "Our app requires Bluetooth to connect with energy devices, enabling efficient device management and enhanced user experience."
  },
  // your other ios configuration, if any
}

Additionally the Enode SDK requires iOS deployment target 14+. It is required to add this to your app's app.json under plugins.

"plugins": [
  [
    "expo-build-properties",
    {
      "ios": {
        "deploymentTarget": "14.0"
      }
    }
  ],
  // your other plugins, if any
]

This is the same plugin used in the Android config and not a seperate one. The final config of this plugin should look something like this:

"plugins": [
      [
        "expo-build-properties",
        {
          "android": {
            "minSdkVersion": 23,
            "compileSdkVersion": 34,
            "targetSdkVersion": 34,
            "buildToolsVersion": "34.0.0"
          },
          "ios": {
            "deploymentTarget": "14.0"
          }
        }
      ]
    ]

Usage

Install the package

npx expo install @youssefhenna/expo-enode-link-sdk

Import the package

import * as ExpoEnodeLinkSDK from "@youssefhenna/expo-enode-link-sdk";

Listen to the result events by:

React.useEffect(() => {
  const resultListener = ExpoEnodeLinkSDK.listenToResult(
    (code, errorMessage) => {
      // Add your code here to handle the result
    }
  );
  return () => resultListener.remove();
}, []);

Launch/Show the Enode Link UI

ExpoEnodeLinkSDK.show("<YOUR_TOKEN_HERE>");