Merge pull request #572 from Instabug/chore/update-master-dev

Release: v14.3.0

Author: mzelzoghbi

.circleci/config.yml

@@ -10,7 +10,7 @@ commands:
   setup_flutter:
     steps:
       - flutter/install_sdk_and_pub:
-          version: 3.10.5
+          version: 3.24.0
       - run:
           name: Generate Pigeons
           command: sh ./scripts/pigeon.sh

CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [14.3.0](https://github.com/Instabug/Instabug-Flutter/compare/v14.1.0...14.3.0) (April 21, 2025)
+
+### Added
+
+- Add support enable/disable capturing network body. ([#561](https://github.com/Instabug/Instabug-Flutter/pull/561))
+
+### Changed
+
+- Bump Instabug iOS SDK to v14.3.0 ([#569](https://github.com/Instabug/Instabug-Flutter/pull/569)). [See release notes](https://github.com/Instabug/Instabug-iOS/releases/tag/14.3.0).
+
+- Bump Instabug Android SDK to v14.3.0 ([#569](https://github.com/Instabug/Instabug-Flutter/pull/569)). [See release notes](https://github.com/Instabug/Instabug-Android/releases/tag/v14.3.0).
+
+
+### Fixed
+
+- Fixed an issue with `SetReproStepsConfig` on Android platform ([#543](https://github.com/Instabug/Instabug-Flutter/pull/543)).
+
+
+## [14.1.0](https://github.com/Instabug/Instabug-Flutter/compare/v14.0.0...v14.1.0) (January 2, 2025)
+
+### Changed
+
+- Bump Instabug Android SDK to v14.1.0 ([#539](https://github.com/Instabug/Instabug-Flutter/pull/539)). [See release notes](https://github.com/Instabug/Instabug-Android/releases/tag/v14.1.0).
+- Bump Instabug iOS SDK to v14.1.0 ([#539](https://github.com/Instabug/Instabug-Flutter/pull/539)). [See release notes](https://github.com/Instabug/Instabug-iOS/releases/tag/14.1.0),
+
 ## [14.1.0](https://github.com/Instabug/Instabug-Flutter/compare/v14.0.0...v14.1.0) (January 2, 2025)
 
 ### Changed

android/build.gradle

@@ -1,5 +1,5 @@
 group 'com.instabug.flutter'
-version '14.1.0'
+version '14.3.0'
 
 buildscript {
     repositories {
@@ -44,7 +44,7 @@ android {
 }
 
 dependencies {
-    api 'com.instabug.library:instabug:14.1.0'
+    api 'com.instabug.library:instabug:14.3.0'
     testImplementation 'junit:junit:4.13.2'
     testImplementation "org.mockito:mockito-inline:3.12.1"
     testImplementation "io.mockk:mockk:1.13.13"

android/src/main/java/com/instabug/flutter/InstabugFlutterPlugin.java

@@ -27,22 +27,13 @@
 import io.flutter.embedding.engine.plugins.activity.ActivityPluginBinding;
 import io.flutter.embedding.engine.renderer.FlutterRenderer;
 import io.flutter.plugin.common.BinaryMessenger;
-import io.flutter.plugin.common.PluginRegistry.Registrar;
 
 public class InstabugFlutterPlugin implements FlutterPlugin, ActivityAware {
     private static final String TAG = InstabugFlutterPlugin.class.getName();
 
     @SuppressLint("StaticFieldLeak")
     private static Activity activity;
 
-    /**
-     * Embedding v1
-     */
-    @SuppressWarnings("deprecation")
-    public static void registerWith(Registrar registrar) {
-        activity = registrar.activity();
-        register(registrar.context().getApplicationContext(), registrar.messenger(), (FlutterRenderer) registrar.textures());
-    }
 
     @Override
     public void onAttachedToEngine(@NonNull FlutterPluginBinding binding) {

android/src/main/java/com/instabug/flutter/modules/ApmApi.java

@@ -33,6 +33,14 @@ public static void init(BinaryMessenger messenger) {
         ApmPigeon.ApmHostApi.setup(messenger, api);
     }
 
+  /**
+   * The function sets the enabled status of APM.
+   * 
+   * @param isEnabled The `setEnabled` method in the code snippet is used to enable or disable a
+   * feature, and it takes a `Boolean` parameter named `isEnabled`. When this method is called with
+   * `true`, it enables the feature, and when called with `false`, it disables the feature. The method
+   * internally calls
+   */
     @Override
     public void setEnabled(@NonNull Boolean isEnabled) {
         try {
@@ -42,6 +50,13 @@ public void setEnabled(@NonNull Boolean isEnabled) {
         }
     }
 
+    /**
+    * Sets the cold app launch enabled status using the APM library.
+    * 
+    * @param isEnabled The `isEnabled` parameter is a Boolean value that indicates whether cold app launch
+    * is enabled or not. When `isEnabled` is set to `true`, cold app launch is enabled, and when it is set
+    * to `false`, cold app launch is disabled.
+    */
     @Override
     public void setColdAppLaunchEnabled(@NonNull Boolean isEnabled) {
         try {
@@ -51,6 +66,14 @@ public void setColdAppLaunchEnabled(@NonNull Boolean isEnabled) {
         }
     }
 
+   /**
+    * The function sets the auto UI trace enabled status in an APM system, handling any exceptions that
+    * may occur.
+    * 
+    * @param isEnabled The `isEnabled` parameter is a Boolean value that indicates whether the Auto UI
+    * trace feature should be enabled or disabled. When `isEnabled` is set to `true`, the Auto UI trace
+    * feature is enabled, and when it is set to `false`, the feature is disabled.
+    */
     @Override
     public void setAutoUITraceEnabled(@NonNull Boolean isEnabled) {
         try {
@@ -60,6 +83,21 @@ public void setAutoUITraceEnabled(@NonNull Boolean isEnabled) {
         }
     }
 
+  /**
+   * Starts an execution trace and handles the result
+   * using callbacks.
+   * 
+   * @param id The `id` parameter is a non-null String that represents the identifier of the execution
+   * trace.
+   * @param name The `name` parameter in the `startExecutionTrace` method represents the name of the
+   * execution trace that will be started. It is used as a reference to identify the trace during
+   * execution monitoring.
+   * @param result The `result` parameter in the `startExecutionTrace` method is an instance of
+   * `ApmPigeon.Result<String>`. This parameter is used to provide the result of the execution trace
+   * operation back to the caller. The `success` method of the `result` object is called with the
+   * 
+   * @deprecated see {@link #startFlow}
+   */
     @Override
     public void startExecutionTrace(@NonNull String id, @NonNull String name, ApmPigeon.Result<String> result) {
         ThreadManager.runOnBackground(
@@ -100,6 +138,17 @@ public void run() {
         );
     }
 
+    /**
+     * Starts an AppFlow with the specified name.
+     * <br/>
+     * On starting two flows with the same name the older flow will end with force abandon end reason.
+     * AppFlow name cannot exceed 150 characters otherwise it's truncated,
+     * leading and trailing whitespaces are also ignored.
+     *
+     * @param name AppFlow name. It can not be empty string or null.
+     *             Starts a new AppFlow, if APM is enabled, feature is enabled
+     *             and Instabug SDK is initialized.
+     */
     @Override
     public void startFlow(@NonNull String name) {
         try {
@@ -109,6 +158,26 @@ public void startFlow(@NonNull String name) {
         }
     }
 
+   /**
+     * Sets custom attributes for AppFlow with a given name.
+     * <br/>
+     * Setting an attribute value to null will remove its corresponding key if it already exists.
+     * <br/>
+     * Attribute key name cannot exceed 30 characters.
+     * Leading and trailing whitespaces are also ignored.
+     * Does not accept empty strings or null.
+     * <br/>
+     * Attribute value name cannot exceed 60 characters,
+     * leading and trailing whitespaces are also ignored.
+     * Does not accept empty strings.
+     * <br/>
+     * If a trace is ended, attributes will not be added and existing ones will not be updated.
+     * <br/>
+     *
+     * @param name  AppFlow name. It can not be empty string or null
+     * @param key   AppFlow attribute key. It can not be empty string or null
+     * @param value AppFlow attribute value. It can not be empty string. Null to remove attribute
+     */
     @Override
     public void setFlowAttribute(@NonNull String name, @NonNull String key, @Nullable String value) {
         try {
@@ -118,6 +187,11 @@ public void setFlowAttribute(@NonNull String name, @NonNull String key, @Nullabl
         }
     }
 
+   /**
+     * Ends AppFlow with a given name.
+     *
+     * @param name AppFlow name to be ended. It can not be empty string or null
+     */
     @Override
     public void endFlow(@NonNull String name) {
         try {
@@ -127,6 +201,15 @@ public void endFlow(@NonNull String name) {
         }
     }
 
+     /**
+     * Adds a new attribute to trace
+     *
+     * @param id    String id of the trace.
+     * @param key   attribute key
+     * @param value attribute value. Null to remove attribute
+     *
+     * @deprecated see {@link #setFlowAttribute}
+     */
     @Override
     public void setExecutionTraceAttribute(@NonNull String id, @NonNull String key, @NonNull String value) {
         try {
@@ -136,6 +219,13 @@ public void setExecutionTraceAttribute(@NonNull String id, @NonNull String key,
         }
     }
 
+    /**
+     * Ends a trace
+     *
+     * @param id string id of the trace.
+     *
+     * @deprecated see {@link #endFlow}
+     */
     @Override
     public void endExecutionTrace(@NonNull String id) {
         try {
@@ -145,6 +235,11 @@ public void endExecutionTrace(@NonNull String id) {
         }
     }
 
+    /**
+     * Starts a UI trace.
+     *
+     * @param name string name of the UI trace.
+     */
     @Override
     public void startUITrace(@NonNull String name) {
         try {
@@ -154,6 +249,9 @@ public void startUITrace(@NonNull String name) {
         }
     }
 
+    /**
+     * This method is used to terminate the currently active UI trace.
+     */
     @Override
     public void endUITrace() {
         try {
@@ -163,6 +261,9 @@ public void endUITrace() {
         }
     }
 
+    /**
+     * This method is used to signal the end of the app launch process.
+     */
     @Override
     public void endAppLaunch() {
         try {
@@ -172,6 +273,12 @@ public void endAppLaunch() {
         }
     }
 
+
+    /**
+     * logs network-related information
+     * 
+     * @param data Map of network data object.
+     */
     @Override
     public void networkLogAndroid(@NonNull Map<String, Object> data) {
         try {
@@ -265,8 +372,13 @@ public void networkLogAndroid(@NonNull Map<String, Object> data) {
         }
 
 
-
-
+    /** 
+    * This method is responsible for initiating a custom performance UI trace
+    * in the APM module. It takes three parameters:
+    * @param screenName: A string representing the name of the screen or UI element being traced.
+    * @param microTimeStamp: A number representing the timestamp in microseconds when the trace is started.
+    * @param traceId: A number representing the unique identifier for the trace.
+    */
     @Override
     public void startCpUiTrace(@NonNull String screenName, @NonNull Long microTimeStamp, @NonNull Long traceId) {
         try {
@@ -276,6 +388,17 @@ public void startCpUiTrace(@NonNull String screenName, @NonNull Long microTimeSt
         }
     }
 
+
+    /** 
+    * This method is responsible for reporting the screen
+    * loading data from Dart side to Android side. It takes three parameters:
+    * @param startTimeStampMicro: A number representing the start timestamp in microseconds of the screen
+    * loading custom performance data.
+    * @param durationMicro: A number representing the duration in microseconds of the screen loading custom
+    * performance data.
+    * @param uiTraceId: A number representing the unique identifier for the UI trace associated with the
+    * screen loading.
+    */
     @Override
     public void reportScreenLoadingCP(@NonNull Long startTimeStampMicro, @NonNull Long durationMicro, @NonNull Long uiTraceId) {
         try {
@@ -285,6 +408,15 @@ public void reportScreenLoadingCP(@NonNull Long startTimeStampMicro, @NonNull Lo
         }
     }
 
+
+    /**
+    *  This method is responsible for extend the end time if the screen loading custom
+    * trace. It takes two parameters:
+    * @param timeStampMicro: A number representing the timestamp in microseconds when the screen loading
+    * custom trace is ending.
+    * @param uiTraceId: A number representing the unique identifier for the UI trace associated with the
+    * screen loading.
+    */
     @Override
     public void endScreenLoadingCP(@NonNull Long timeStampMicro, @NonNull Long uiTraceId) {
         try {
@@ -294,11 +426,16 @@ public void endScreenLoadingCP(@NonNull Long timeStampMicro, @NonNull Long uiTra
         }
     }
 
+
+    /**
+     *  This method is used to check whether the end screen loading feature is enabled or not.
+     */
     @Override
     public void isEndScreenLoadingEnabled(@NonNull ApmPigeon.Result<Boolean> result) {
         isScreenLoadingEnabled(result);
     }
 
+
     @Override
     public void isEnabled(@NonNull ApmPigeon.Result<Boolean> result) {
         try {
@@ -310,6 +447,9 @@ public void isEnabled(@NonNull ApmPigeon.Result<Boolean> result) {
         }
     }
 
+    /** 
+     * checks whether the screen loading feature is enabled. 
+     * */    
     @Override
     public void isScreenLoadingEnabled(@NonNull ApmPigeon.Result<Boolean> result) {
         try {
@@ -324,6 +464,9 @@ public void invoke(boolean isFeatureAvailable) {
         }
     }
 
+    /**
+     * This method is setting the enabled state of the screen loading feature.
+     */
     @Override
     public void setScreenLoadingEnabled(@NonNull Boolean isEnabled) {
         try {