Release/v1.1.3 (#31)

- chore: update version 1.1.2 -> 1.1.3
- chore: bridgefy started and initialized flags
- chore: upgrade iOS framework 1.1.2
- chore: update android SDK 1.1.2
- chore: update readme

Author: julian-bridgefy

CHANGELOG.md

@@ -1,4 +1,4 @@
-# Bridgefy Flutter 1.1.2
+# Bridgefy Flutter 1.1.3
 ### BLUETOOTH MESH NETWORKS
 
 Devices running your app create Bluetooth Low-Energy mesh networks, which work in large crowds, during and after natural disasters, and whenever else your users lose access to the Internet.

README.md

@@ -1,5 +1,3 @@
-
-
 <p align="center">
     <img src="https://www.gitbook.com/cdn-cgi/image/width=256,dpr=2,height=40,fit=contain,format=auto/https%3A%2F%2F3290834949-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5XKIMMP6VF2l9XuPV80l%252Flogo%252Fd78nQFIysoU2bbM5fYNP%252FGroup%25203367.png%3Falt%3Dmedia%26token%3Df83a642d-8a9a-411f-9ef4-d7189a4c5f0a" />
 </p>
@@ -44,7 +42,7 @@ To install this SDK, you'll need to either add the following to your `pubspec.ya
 
 ```yaml
 dependencies:
-  bridgefy: ^1.1.2
+  bridgefy: ^1.1.3
 ```
 
 Or run this flutter command:
@@ -58,8 +56,7 @@ flutter pub add bridgefy
 ### Initialization
 
 The init method initializes the Bridgefy SDK with the given API key and verbose logging. The
-delegate parameter is required and should be an object that conforms to the `BridgefyDelegate`
-mixin.
+delegate parameter is required and should be an object that conforms to the `BridgefyDelegate`mixin.
 
 The following code shows how to init the SDK (using your API key) and how to assign the delegate.
 
@@ -96,6 +93,14 @@ The following code shows how to start the SDK with propagation profile and custo
 
 ````
 
+### Stop Bridgefy
+
+Stop Bridgefy operations
+```dart
+	_bridgefy.stop();
+```
+
+
 ### Sending data
 
 The following method is used to send data using a transmission mode. This method returns a UUID to
@@ -123,10 +128,18 @@ The following is an example event emitted when a message is successfully sent:
 ```dart
 @override
 void bridgefyDidSendMessage({required String messageID}) {
-  // `messageID` contains the ID of the message.
+  // `messageID` The id of the message sent successfully.
+}
+
+// This function is called when the message could not be sent.
+@override
+void bridgefyDidFailSendingMessage({required String messageID, BridgefyError? error}) {
+    // `messageID`: The id of the message that was tried to be sent.
+	// `error`: Error reason.
 }
 ```
 
+
 When the app received data through Bridgefy:
 
 ```dart
@@ -140,6 +153,24 @@ void bridgefyDidReceiveData({
 }
 ```
 
+### Transmission Mode
+
+`BridgefyTransmissionModeType` specifies different transmission modes:
+
+- `p2p`: Deliver a message to a specific recipient only if there's an active connection with it.
+- `mesh`: Deliver a message to a specific recipient using nearby devices to propagate it.
+- `broadcast`: Propagate a message readable by every device that receives it.
+
+### PropagationProfile
+
+`BridgefyPropagationProfile` defines different propagation profiles within the BridgefySDK.
+
+- `standard`: Represents a standard propagation profile.
+- `highDensityNetwork`: Indicates a propagation profile suitable for high-density networks.
+- `sparseNetwork`: Represents a propagation profile tailored for sparse networks.
+- `longReach`: Indicates a propagation profile optimized for long reach.
+- `shortReach`: Represents a propagation profile designed for short reach communication.
+
 ### Nearby peer detection
 
 The following method is invoked when a peer has established connection:
@@ -162,6 +193,43 @@ When a peer is disconnected(out of range), the following method will be invoked:
 
 To see a full list of events, take a look at the `BridgefyDelegate` mixin.
 
+### Other Utilities
+
+Retrieve current user ID:
+
+ ```dart
+ String currentUserID = await _bridgefy.currentUserID;
+ ```
+
+Get a list of connected peers:
+
+
+ ```dart
+ List<String> connectedPeers = await _bridgefy.connectedPeers;
+ ```
+
+Check if the SDK is initialized or started:
+
+ ```dart
+bool isInitialized = await _bridgefy.isInitialized;
+bool isStarted = await _bridgefy.isStarted;
+ ```
+
+Retrieve license expiration date:
+
+
+```dart
+DateTime? expirationDate = await _bridgefy.licenseExpirationDate;
+```
+
+### License Update
+Update the license:
+
+```dart
+await _bridgefy.updateLicense();
+```
+
+
 ## Multi-Platform Support
 
 Bridgefy's SDKs are designed to work seamlessly across different platforms, including iOS and Android. This means that users with different devices can communicate with each other as long as they have the Bridgefy-enabled applications installed.

android/build.gradle

@@ -20,6 +20,9 @@ rootProject.allprojects {
             url "http://34.82.5.94:8081/artifactory/libs-release-local"
             allowInsecureProtocol = true
         }
+        flatDir {
+            dirs("/Users/bridgefy/bridgefy/sdk/bridgefy_flutter/android/libs")
+        }
     }
 }
 
@@ -55,7 +58,7 @@ android {
 }
 
 dependencies {
-    implementation (group: "me.bridgefy", name: "android-sdk", version: "1.1.1", ext: "aar") {
+    implementation (group: "me.bridgefy", name: "android-sdk", version: "1.1.2", ext: "aar") {
         transitive = true
     }
 }

android/src/main/kotlin/me/bridgefy/plugin/flutter/BridgefyPlugin.kt

@@ -44,6 +44,8 @@ class BridgefyPlugin : FlutterPlugin, MethodCallHandler {
             "licenseExpirationDate" -> licenseExpirationDate(call, result)
             "destroySession" -> destroySession(call, result)
             "updateLicense" -> updateLicense(call, result)
+            "isInitialized" -> isInitialized(call, result)
+            "isStarted" -> isStarted(call, result)
             else -> result.notImplemented()
         }
     }
@@ -173,9 +175,16 @@ class BridgefyPlugin : FlutterPlugin, MethodCallHandler {
                 if (verboseLogging) Log.DEBUG else 1,
             )
             result.success(null)
+        } catch (illegal: IllegalArgumentException) {
+            illegal.printStackTrace()
+            result.error("invalidAPIKey", illegal.message ?: illegal.localizedMessage, null)
         } catch (error: BridgefyException) {
+            error.printStackTrace()
             val map = mapFromBridgefyException(error)
             result.error(map["code"] as String, map["message"] as String, map["details"])
+        } catch (e: Exception) {
+            e.printStackTrace()
+            result.error("sessionError", e.message ?: e.localizedMessage, null)
         }
     }
 
@@ -242,6 +251,14 @@ class BridgefyPlugin : FlutterPlugin, MethodCallHandler {
         result.success(null)
     }
 
+    private fun isInitialized(@NonNull call: MethodCall, @NonNull result: Result) {
+        result.success(hashMapOf("isInitialized" to bridgefy.isInitialized))
+    }
+
+    private fun isStarted(@NonNull call: MethodCall, @NonNull result: Result) {
+        result.success(hashMapOf("isStarted" to bridgefy.isStarted))
+    }
+
     private fun mapFromBridgefyException(exception: BridgefyException): HashMap<String, Any?> {
         var code: String
         var details: Int? = null

example/lib/main.dart

@@ -20,7 +20,6 @@ class _MyAppState extends State<MyApp> implements BridgefyDelegate {
   String apiKey = "YOUR_API_KEY_HERE";
   final _bridgefy = Bridgefy();
   bool _didStart = false;
-  String _buttonText = 'Start';
   String _logStr = '';
   final Color _bfColor = const Color(0x00FF4040);
   final _scrollController = ScrollController();
@@ -55,11 +54,16 @@ class _MyAppState extends State<MyApp> implements BridgefyDelegate {
     super.initState();
     checkPermissions().then((value) async {
       try {
-        await _bridgefy.initialize(
-          apiKey: apiKey,
-          delegate: this,
-          verboseLogging: true,
-        );
+        //you can validate if there is already an initialized instance to avoid an error in case it already exists
+        final isInitialized = await _bridgefy.isInitialized;
+        _didStart = await _bridgefy.isStarted;
+        if (!isInitialized){
+          await _bridgefy.initialize(
+            apiKey: apiKey,
+            delegate: this,
+            verboseLogging: true,
+          );
+        }
       } catch (e) {
         _log("Unable to initialize: $e");
       }
@@ -95,7 +99,7 @@ class _MyAppState extends State<MyApp> implements BridgefyDelegate {
                             ? const Icon(Icons.stop_circle)
                             : const Icon(Icons.check_circle),
                         onPressed: _toggleStart,
-                        label: Text(_buttonText)),
+                        label: Text(_didStart ? "Stop" : "Start")),
                     const SizedBox(width: 7),
                     ElevatedButton.icon(
                         icon: const Icon(Icons.send),
@@ -222,7 +226,6 @@ class _MyAppState extends State<MyApp> implements BridgefyDelegate {
     _log("bridgefyDidStart: $currentUserID");
     setState(() {
       _didStart = true;
-      _buttonText = 'Stop';
     });
   }
 
@@ -231,7 +234,6 @@ class _MyAppState extends State<MyApp> implements BridgefyDelegate {
     _log("bridgefyDidStop");
     setState(() {
       _didStart = false;
-      _buttonText = 'Start';
     });
   }
 

ios/Classes/BridgefyPlugin.swift

@@ -36,6 +36,12 @@ public class BridgefyPlugin: NSObject, FlutterPlugin, BridgefyDelegate {
     case "currentUserID":
       currentUserID(call, result: result)
       break
+    case "isInitialized":
+      isInitialized(call, result: result)
+      break
+    case "isStarted":
+      isStarted(call, result: result)
+      break
     case "establishSecureConnection":
       establishSecureConnection(call, result: result)
       break
@@ -190,8 +196,16 @@ public class BridgefyPlugin: NSObject, FlutterPlugin, BridgefyDelegate {
     })])
   }
 
+  private func isInitialized(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
+    result(["isInitialized": Bridgefy.isInitialized])
+  }
+
+  private func isStarted(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
+      result(["isStarted": Bridgefy.isStarted])
+  }
+
   private func currentUserID(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
-    result(["userId": bridgefy!.currentUserId!.uuidString])
+      result(["userId": bridgefy!.currentUserId!.uuidString])
   }
 
   private func establishSecureConnection(_ call: FlutterMethodCall,

ios/Frameworks/BridgefySDK.xcframework/Info.plist

@@ -5,35 +5,39 @@
 	<key>AvailableLibraries</key>
 	<array>
 		<dict>
+			<key>BinaryPath</key>
+			<string>BridgefySDK.framework/BridgefySDK</string>
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>BridgefySDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
+			<key>BinaryPath</key>
+			<string>BridgefySDK.framework/BridgefySDK</string>
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>BridgefySDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

ios/Frameworks/BridgefySDK.xcframework/ios-arm64/BridgefySDK.framework/BridgefySDK

@@ -1,6 +1,6 @@
 #if 0
 #elif defined(__arm64__) && __arm64__
-// Generated by Apple Swift version 5.8 (swiftlang-5.8.0.124.2 clang-1403.0.22.11.100)
+// Generated by Apple Swift version 5.9 (swiftlang-5.9.0.128.108 clang-1500.0.40.1)
 #ifndef BRIDGEFYSDK_SWIFT_H
 #define BRIDGEFYSDK_SWIFT_H
 #pragma clang diagnostic push
@@ -42,12 +42,18 @@
 #include <string.h>
 #endif
 #if defined(__cplusplus)
-#if __has_include(<ptrauth.h>)
+#if defined(__arm64e__) && __has_include(<ptrauth.h>)
 # include <ptrauth.h>
 #else
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wreserved-macro-identifier"
 # ifndef __ptrauth_swift_value_witness_function_pointer
 #  define __ptrauth_swift_value_witness_function_pointer(x)
 # endif
+# ifndef __ptrauth_swift_class_method_pointer
+#  define __ptrauth_swift_class_method_pointer(x)
+# endif
+#pragma clang diagnostic pop
 #endif
 #endif
 
@@ -246,6 +252,17 @@ typedef unsigned int swift_uint4  __attribute__((__ext_vector_type__(4)));
 #else
 # define SWIFT_NOEXCEPT 
 #endif
+#if !defined(SWIFT_C_INLINE_THUNK)
+# if __has_attribute(always_inline)
+# if __has_attribute(nodebug)
+#  define SWIFT_C_INLINE_THUNK inline __attribute__((always_inline)) __attribute__((nodebug))
+# else
+#  define SWIFT_C_INLINE_THUNK inline __attribute__((always_inline))
+# endif
+# else
+#  define SWIFT_C_INLINE_THUNK inline
+# endif
+#endif
 #if defined(_WIN32)
 #if !defined(SWIFT_IMPORT_STDLIB_SYMBOL)
 # define SWIFT_IMPORT_STDLIB_SYMBOL __declspec(dllimport)
@@ -282,12 +299,12 @@ typedef unsigned int swift_uint4  __attribute__((__ext_vector_type__(4)));
 #if defined(__OBJC__)
 
 
-#endif
-#if defined(__cplusplus)
 #endif
 #if __has_attribute(external_source_symbol)
 # pragma clang attribute pop
 #endif
+#if defined(__cplusplus)
+#endif
 #pragma clang diagnostic pop
 #endif