Installation

The Plugchoice SDK is in beta. Until version 1.0, a minor version may change the SDK or the SDK API. Pin the SDK version in your app and the Plugchoice-Version header on your server.

The SDK has the same version on every platform. The source is on GitHub at plugchoice/mobile-sdk.

Platform	Package	Requirements
iOS	`PlugchoiceSDK` with Swift Package Manager	iOS 16+, Xcode 16+
Android	`com.plugchoice:plugchoice` from Maven Central	Android 10 (API 29)+, `compileSdk 36`
React Native and Expo	`@plugchoice/react-native` from npm	Expo SDK 57+, a development or release build

iOS
Android
React Native

Requirements: iOS 16 or later, and Xcode 16 or later. On iOS 18 and later the SDK joins a charger’s Wi-Fi through AccessorySetupKit; on iOS 16 and 17 it uses the classic join prompt.Add the package with Swift Package Manager. In Xcode, choose File › Add Package Dependencies…, enter https://github.com/plugchoice/mobile-sdk, pick Up to Next Minor Version from 0.4.0, and add the PlugchoiceSDK library to your app target.In a Package.swift:

Package.swift

dependencies: [
    .package(url: "https://github.com/plugchoice/mobile-sdk", .upToNextMinor(from: "0.4.0")),
],
targets: [
    .target(name: "YourApp", dependencies: [
        .product(name: "PlugchoiceSDK", package: "mobile-sdk"),
    ]),
]

Then import it where you use it:

import PlugchoiceSDK

Requirements: Android 10 (API 29) or later (minSdk 29), compileSdk 36, and JDK 17. Bluetooth on Android 12 and later needs your app to target API 31 or later. Scanning a charger’s QR code uses Google Play services; on a device without them, the user types the code instead.The library is com.plugchoice:plugchoice on Maven Central. Make sure mavenCentral() is in your repositories (it usually is), then add the dependency to your app module:

dependencies {
    implementation("com.plugchoice:plugchoice:0.4.0")
}

dependencies {
    implementation 'com.plugchoice:plugchoice:0.4.0'
}

The public API is in the package com.plugchoice.

Requirements: Expo SDK 57 or later (React Native 0.86), in a development or release build of your app. Expo Go doesn’t include the SDK’s native code. iOS 16.4 or later, and Android 10 (API 29) or later.Install the package:

npx expo install @plugchoice/react-native

Add its config plugin to your app config. On every npx expo prebuild it adds what the SDK needs on iOS and Android:

app.json

{
  "expo": {
    "plugins": ["@plugchoice/react-native"]
  }
}

Then rebuild the native app: npx expo prebuild and npx expo run:ios or npx expo run:android, or an EAS build.

The package is an Expo module. A React Native app without Expo needs Expo modules first (npx install-expo-modules@latest), and then makes the native changes by hand, as on the iOS and Android pages.

Next steps

Your app needs a few more settings before the SDK can join a charger’s Wi-Fi, reach it on the local network or talk Bluetooth to it. Each platform page lists them:

iOS

Entitlements and Info.plist keys.

Android

Permissions and plain HTTP to chargers.

React Native

The config plugin and its options.

The SDK also needs a client secret from your server. Get started walks through the server endpoint and the app together.

Get started

Platforms

Concepts

Chargers

API reference

Errors

Resources

Next steps

iOS

Android

React Native

​Next steps

iOS

Android

React Native

Next steps