QR code settings PE (before v1.7)

Configure your custom mobile app to launch directly from a QR code scan using the phone’s camera.

Modify android/app/src/main/AndroidManifest.xml and update android:host with your host:

<!-- App Links -->
<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data
        android:scheme="https"
        android:host="thingsboard.cloud"
        android:pathPrefix="/api/noauth/qr" />
</intent-filter>

To launch your app when a QR code is scanned, specify the app package name and SHA-256 certificate fingerprint in the QR code widget settings.

Find the applicationId in android/app/build.gradle:

defaultConfig {
    applicationId "org.thingsboard.pe.app"
}

For apps distributed via Google Play, find the SHA-256 fingerprint in your developer account under Release → Setup → App Integrity → App Signing:

For locally distributed apps, use the SHA-256 key your APK is signed with. For details, see the Set up app links for Android guide.

Modify ios/YOUR_APP_NAME/YOUR_APP_NAME.entitlements.xml and update applinks with your domain:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>aps-environment</key>
  <string>development</string>
  <key>com.apple.developer.associated-domains</key>
  <array>
    <string>applinks:thingsboard.cloud</string>
  </array>
</dict>
</plist>

To launch your iOS app when a QR code is scanned, specify the App ID in the QR code widget settings.

The bundle ID (CFBundleIdentifier) uniquely identifies your app. It combines the organization ID and app name in reverse-DNS format — for example, com.mycompany.app.Runner.

To find the bundle ID:

1. Select the target in Xcode.
2. Click the Signing & Capabilities pane.
3. Find the bundle identifier in the Signing section.