@expofp/react-native-efp-crowdconnected 0.1.6 → 0.1.8

package/README.md

@@ -18,10 +18,8 @@ React Native Turbo Module for CrowdConnected location tracking and indoor positi
 
 ## Requirements
 
-- React Native 0.71+
-- React 18+
-- iOS 12.0+ (CrowdConnected SDK v2.2.1)
-- Android 7+ (API 24+)
+- Android 7.0+ (API level 24+)
+- iOS minimum version follows your React Native installation
 
 ## Installation
 
@@ -37,9 +35,21 @@ yarn add @expofp/react-native-efp-crowdconnected
 cd ios && pod install
 ```
 
+Your host app's `Info.plist` must declare the relevant location/Bluetooth usage descriptions and `UIBackgroundModes` entries. See [`example/ios/ExpofpCrowdconnectedExample/Info.plist`](./example/ios/ExpofpCrowdconnectedExample/Info.plist) for a working configuration.
+
 ### Android
 
-No additional setup required. CocoaPods/Gradle will handle dependencies.
+Gradle resolves the dependencies automatically. The CrowdConnected SDK AARs (`net.crowdconnected.android.{core,background,geo,ips}`, fetched from CrowdConnected's Maven repository) contribute the foreground-service declaration and the following permissions via Gradle's manifest merger. You do not need to declare them in your host app's `AndroidManifest.xml`: `INTERNET`, `ACCESS_FINE_LOCATION`, `ACCESS_COARSE_LOCATION`, `FOREGROUND_SERVICE`, `FOREGROUND_SERVICE_LOCATION`, `BLUETOOTH_SCAN`, `BLUETOOTH_CONNECT`, and the legacy `BLUETOOTH` / `BLUETOOTH_ADMIN` (`maxSdkVersion=30`).
+
+If you set `isBackgroundUpdateEnabled: true`, your host app **must** also declare:
+
+```xml
+<!-- AndroidManifest.xml -->
+<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+```
+
+`ACCESS_BACKGROUND_LOCATION` cannot be granted from the standard runtime prompt on Android 11+; the system redirects the user to the app's settings screen, where they must select "Allow all the time".
 
 ## Quick Start
 
@@ -84,7 +94,7 @@ unsubscribeError();
 
 ## API Reference
 
-### `setup(settings: ExpoFpLocationSettings): Promise<string>`
+### `setup(settings: ExpoFpLocationSettings): Promise<ExpoFpProviderInfo>`
 
 Initializes the CrowdConnected SDK with configuration.
 
@@ -98,25 +108,25 @@ Initializes the CrowdConnected SDK with configuration.
 - `isHeadingEnabled` - Enable compass/heading tracking
 - `aliases?` - Custom location aliases (optional)
 
-**Returns:** Promise resolving to initialization status
+**Returns:** Promise resolving to `ExpoFpProviderInfo` (`{ deviceId?, isLocationUpdating }`)
 
 ---
 
-### `startUpdatingLocation(): void`
+### `startUpdatingLocation(): Promise<ExpoFpProviderInfo>`
 
 Starts location tracking.
 
 ---
 
-### `stopUpdatingLocation(): void`
+### `stopUpdatingLocation(): Promise<ExpoFpProviderInfo>`
 
 Stops location tracking.
 
 ---
 
-### `isLocationUpdating(): Promise<boolean>`
+### `isLocationUpdating(): Promise<ExpoFpProviderInfo>`
 
-Checks if location tracking is currently active.
+Returns the current provider state.
 
 ---
 
@@ -165,5 +175,5 @@ yarn prepare
 ## Support
 
 - 📖 [Documentation](https://developer.expofp.com)
-- 🐛 [Report Issues](https://github.com/expofp/react-native-crowdconnected/issues)
-- 💬 [Discussions](https://github.com/expofp/react-native-crowdconnected/discussions)
+- 🐛 [Report Issues](https://github.com/expofp/react-native-efp-crowdconnected/issues)
+- 💬 [Discussions](https://github.com/expofp/react-native-efp-crowdconnected/discussions)

package/android/src/main/java/com/expofpcrowdconnected/RCTCrowdConnectedLocationProviderModule.kt

@@ -32,6 +32,7 @@ import net.crowdconnected.android.core.Configuration
 import net.crowdconnected.android.core.CrowdConnected
 import net.crowdconnected.android.core.ErrorCode
 import net.crowdconnected.android.core.Location
+import net.crowdconnected.android.background.BackgroundModule
 import net.crowdconnected.android.geo.GeoModule
 import net.crowdconnected.android.ips.IPSModule
 
@@ -484,8 +485,10 @@ class RCTCrowdConnectedLocationProviderModule(
             }
         }
 
-        // Set foreground service notification if background updates are enabled
+        // BackgroundModule is required. Without it v3 silently stays in FOREGROUND mode
+        // and withForegroundServiceConfig is ignored.
         if (currentSettings.isBackgroundUpdateEnabled) {
+            builder.addModule(BackgroundModule())
             builder.withForegroundServiceConfig(
                 NOTIFICATION_TITLE,
                 NOTIFICATION_ICON

package/ios/RCTCrowdConnectedLocationProvider.swift

@@ -65,8 +65,6 @@ class RCTCrowdConnectedLocationProvider: RCTEventEmitter, @MainActor CLLocationM
       ccLocationManager.delegate = self
       clLocationManager.delegate = self
 
-      settings.aliases.forEach(ccLocationManager.setAlias)
-
       isLocationUpdating
       ? startUpdatingLocation(resolve, rejecter: reject)
       : (try? providerInfo.toDict()).map(resolve)
@@ -192,6 +190,8 @@ extension RCTCrowdConnectedLocationProvider: @MainActor CrowdConnectedDelegate {
       clLocationManager.startUpdatingHeading()
     }
 
+    settings.aliases.forEach(ccLocationManager.setAlias)
+
     (try? providerInfo.toDict()).map { updatingResolver?($0) }
     updatingResolver = nil
     updatingRejecter = nil

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expofp/react-native-efp-crowdconnected",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "React Native wrapper for ExpoFP around CrowdConnected SDK",
   "keywords": [
     "react-native",