Merge pull request #385 from Countly/preview_content

feat: preview content

Author: turtledreams

.vscode/settings.json

@@ -1,5 +1,6 @@
 {
   "dart.lineLength": 300,
+  "editor.formatOnSave": true,
   "java.configuration.updateBuildConfiguration": "interactive",
   "emeraldwalk.runonsave": {
     "commands": [

CHANGELOG.md

@@ -1,4 +1,5 @@
 ## XX.XX.XX
+* Added Content feature method `previewContent(String contentId)` (Experimental!).
 * Added a new config option disableViewRestartForManualRecording to disable auto close/restart behavior of manual views on app background/foreground actions.
 * Added a new config option "setWebviewDisplayOption: WebViewDisplayOption" to control how Content and Feedback Widgets are presented.
   * IMMERSIVE mode (default): Full-screen display (except cutouts).

android/src/main/java/ly/count/dart/countly_flutter/CountlyFlutterPlugin.java

@@ -1461,6 +1461,10 @@ else if ("enterContentZone".equals(call.method)) {
             } else if ("refreshContentZone".equals(call.method)) {
                 Countly.sharedInstance().contents().refreshContentZone();
                 result.success(null);
+            } else if ("previewContent".equals(call.method)) {
+                String contentId = call.argument("contentId");
+                Countly.sharedInstance().contents().previewContent(contentId);
+                result.success(null);
             }
 
             else {

ios/Classes/CountlyFlutterPlugin.m

@@ -1421,6 +1421,12 @@ - (void)handleMethodCall:(FlutterMethodCall *)call result:(FlutterResult)result
             [Countly.sharedInstance.content refreshContentZone];
             result(nil);
         });
+    } else if ([@"previewContent" isEqualToString:call.method]) {
+        NSString* contentId = call.arguments[@"contentId"];
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [Countly.sharedInstance.content previewContent:contentId];
+            result(nil);
+        });
     } else if ([@"attemptToSendStoredRequests" isEqualToString:call.method]) {
         dispatch_async(dispatch_get_main_queue(), ^{
             [Countly.sharedInstance attemptToSendStoredRequests];

lib/src/content_builder.dart

@@ -21,4 +21,9 @@ abstract class ContentBuilder {
   /// This method forces an update by fetching the latest content,
   /// ensuring the user receives the most up-to-date information.
   Future<void> refreshContentZone();
+
+  ///  This is an experimental feature and it can have breaking changes
+  /// Previews the content associated with the given [contentId].
+  /// This method fetches and displays the content for preview purposes.
+  Future<void> previewContent(String contentId);
 }

lib/src/content_builder_internal.dart

@@ -38,6 +38,20 @@ class ContentBuilderInternal implements ContentBuilder {
     await _countlyState.channel.invokeMethod('refreshContentZone');
   }
 
+  @override
+  Future<void> previewContent(String contentId) async {
+    if (!_countlyState.isInitialized) {
+      Countly.log('previewContent, "initWithConfig" must be called before "previewContent"', logLevel: LogLevel.ERROR);
+      return;
+    }
+    if (contentId.isEmpty) {
+      Countly.log('previewContent, contentId cannot be null or empty', logLevel: LogLevel.ERROR);
+      return;
+    }
+    Countly.log('Calling "previewContent" with contentId: [$contentId]');
+    await _countlyState.channel.invokeMethod('previewContent', {'contentId': contentId});
+  }
+
   void registerContentCallback(ContentCallback callback) {
     _contentCallback = callback;
   }