Release 1.1.2

Author: bojan

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.2] - 2025-03-06
+
+### Changed
+- Enhanced the session analytics feature to work better across different environments.
+
+### Removed
+- Removed the support for automatic processing of DevRev push notifications. For more info, please refer to the integration guide (README.md).
+
 ## [1.1.1] - 2025-02-25
 
 ### Fixed

DevRevSDK.doccarchive.zip

@@ -1,13 +1,13 @@
 Pod::Spec.new do |spec|
   spec.name = "DevRevSDK"
-  spec.version = "1.1.1"
+  spec.version = "1.1.2"
   spec.summary = "DevRev SDK, used for integrating DevRev services into your iOS app."
   spec.homepage = "https://devrev.ai"
   spec.license = "Apache 2.0"
   spec.author = { "DevRev" => "[email protected]" }
   spec.platform = :ios, "15.0"
   spec.source = {
-    http: "https://github.com/devrev/devrev-sdk-ios/releases/download/v1.1.1/DevRevSDK.xcframework.zip",
+    http: "https://github.com/devrev/devrev-sdk-ios/releases/download/v1.1.2/DevRevSDK.xcframework.zip",
     type: :zip,
     headers: [
       "Accept: application/octet-stream",

DevRevSDK.podspec

@@ -0,0 +1,18 @@
+# Migration Guide
+This guide and chart should help facilitate the transition from the legacy UserExperior SDK to the new DevRev SDK in your iOS application, providing insights into feature equivalents and method changes.
+
+## Feature Equivalence Chart
+
+| Feature | UserExperior SDK | DevRev SDK |
+|-|-|-|
+| Installation | `pod 'UserExperior', '~> <version>` | SPM: `https://github.com/devrev/devrev-sdk-ios`<br />CocoaPods: `pod 'DevRevSDK', '~> <version>` |
+| Initialization | `UserExperior.startRecording(_ versionKey: String)` | `DevRev.configure(appID: String)` |
+| User Identification | `UserExperior.setUserIdentifier(_ userIdentifier: String)` | `DevRev.identifyAnonymousUser(userID: String)`<br />`DevRev.identifyUnverifiedUser(_ identity: Identity)`<br />`DevRev.updateUser(_ identity: Identity)`<br /> `identifyVerifiedUser( _ userID: String, 		sessionToken: String)`<br />`DevRev.logout(deviceID: String)` |
+| Event Tracking | `UserExperior.logEvent(_ eventName: String)` | `DevRev.trackEvent(name: String, properties: [String: String])` |
+| Session Recording | `UserExperior.stopRecording()`<br />`UserExperior.pauseRecording()`<br />`UserExperior.resumeRecording()` | `DevRev.startRecording()`<br />`DevRev.stopRecording()`<br />`DevRev.pauseRecording()`<br />`DevRev.resumeRecording()`<br />`DevRev.processAllOnDemandSessions()` |
+| Opting in/out | `UserExperior.consentOptIn()`<br />`UserExperior.consentOptOut()`<br />`UserExperior.getConsentStatus`<br />`UserExperior.getOptOutStatus` | `DevRev.stopAllMonitoring()`<br />`DevRev.resumeAllMonitoring()` |
+| Session Properties | `UserExperior.setUserProperties(_ properties: [String: Any])` | `DevRev.addSessionProperties(properties: [String: String])`<br />`DevRev.clearSessionProperties()` |
+| Masking Sensitive Data | `UserExperior.markSensitiveViews(_ viewsToSecure: NSArray)`<br />`UserExperior.unmarkSensitiveViews(_ viewsToSecure: NSArray)` | `DevRev.markSensitiveViews(_ sensitiveViews: [UIView])`<br />`DevRev.unmarkSensitiveViews(_ sensitiveViews: [UIView])` |
+| Timers | `UserExperior.startTimer(_ timerName: String)`<br />`UserExperior.endTimer(_ timerName: String)` | `DevRev.startTimer(_ name: String, properties: [String: String])`<br />`DevRev.stopTimer(_ name: String, properties: [String: String])` |
+| PLuG support chat | Not supported. | `DevRev.showSupport(isAnimated: Bool)`<br />`DevRev.showSupport(from parentViewController: UIViewController,  isAnimated: Bool)`<br />`DevRev.showSupport(from navigationController: UINavigationController,  isAnimated: Bool)`<br />`DevRev.createSupportConversation(isAnimated: Bool)`<br />`DevRev.shouldDismissModalsOnOpenLink`<br />`DevRev.inAppLinkHandler` |
+| Push Notifications | Not supported. | `DevRev.registerDeviceToken(_ deviceToken: Data, deviceID: String)`<br />`DevRev.processPushNotification(_ userInfo: [String: String])` |

DevRevSDK.xcframework.zip

@@ -18,8 +18,8 @@ let package = Package(
     targets: [
         .binaryTarget(
             name: "DevRevSDK",
-            url: "https://github.com/devrev/devrev-sdk-ios/releases/download/v1.1.1/DevRevSDK.xcframework.zip",
-            checksum: "549a08539cf2601ec7e73b67ae5a58979d917b3f4daa5f30ebf3e66b74315095"
+            url: "https://github.com/devrev/devrev-sdk-ios/releases/download/v1.1.2/DevRevSDK.xcframework.zip",
+            checksum: "53381d4c965b14a7b37a0a77cf3647bac3a97bfd7f1e8921406a1f4d294cec31"
         )
     ]
 )

MIGRATION.md

@@ -457,12 +457,15 @@ Task {
 ```
 
 #### Handle push notifications
-To properly handle push notifications, implement the following method, typically in either the `UNUserNotificationCenterDelegate.userNotificationCenter(_:didReceive:)` or `UIApplicationDelegate.application(_:didReceiveRemoteNotification:fetchCompletionHandler:)`:
+Push notifications coming to the DevRev SDK need to be handled manually. To properly handle them, implement the following method, typically in either the `UNUserNotificationCenterDelegate.userNotificationCenter(_:didReceive:)` or `UIApplicationDelegate.application(_:didReceiveRemoteNotification:fetchCompletionHandler:)`:
 
 ```swift
 DevRev.processPushNotification(_:)
 ```
 
+> [!IMPORTANT]
+> For convenience, this method provides two overloads that accept `userInfo` as either `[AnyHashable: Any]` or `[String: any Sendable]` dictionary types.
+
 ##### Example
 ```swift
 func userNotificationCenter(

Package.swift

@@ -0,0 +1,75 @@
+import Foundation
+import SwiftUI
+import DevRevSDK
+
+struct HomeView: View {
+	@SwiftUI.State private var isConfigured = false
+	@SwiftUI.State private var isUserIdentified = false
+	@SwiftUI.State private var isMonitoringEnabled = false
+
+	var body: some View {
+		NavigationView {
+			List {
+				Section(header: Text("Status")) {
+					StatusRow(
+						status: "Is the SDK configured?",
+						isComplete: $isConfigured
+					)
+					StatusRow(
+						status: "Is the user identified?",
+						isComplete: $isUserIdentified
+					)
+					StatusRow(
+						status: "Is session monitoring enabled?",
+						isComplete: $isMonitoringEnabled
+					)
+				}
+
+				Section(header: Text("Features")) {
+					NavigationLink(destination: IdentificationView()) {
+						Text("Identification")
+					}
+					NavigationLink(destination: PushNotificationsView()) {
+						Text("Push Notifications")
+					}
+					NavigationLink(destination: SupportView()) {
+						Text("Support")
+					}
+					NavigationLink(destination: SessionAnalyticsView()) {
+						Text("Session Analytics")
+					}
+				}
+
+				Section(header: Text("Debug")) {
+					Button(
+						action: {
+							print("The app will crash now!")
+							let array = [Int]()
+							_ = array[1]
+						}
+					) {
+						Text("Force a crash")
+					}
+				}
+			}
+			.navigationTitle("DevRev SDK")
+			.navigationBarItems(trailing: RefreshButton(action: updateStatuses))
+			.refreshable {
+				await updateStatuses()
+			}
+			.task {
+				await updateStatuses()
+			}
+		}
+	}
+
+	private func updateStatuses() async {
+		isConfigured = await DevRev.isConfigured
+		isUserIdentified = await DevRev.isUserIdentified
+		isMonitoringEnabled = DevRev.isMonitoringEnabled
+	}
+}
+
+#Preview {
+	HomeView()
+}

README.md

@@ -7,7 +7,7 @@ struct SampleApp: App {
 
 	var body: some Scene {
 		WindowGroup {
-			ContentView()
+			HomeView()
 		}
 	}
 }