Merge pull request #183 from splitio/development

Release v1.2.1

Author: EmilianoSanchez

.github/workflows/update-license-year.yml .github/workflows/update-notice-year.yml.github/workflows/update-license-year.yml renamed to .github/workflows/update-notice-year.yml

@@ -1,4 +1,4 @@
-name: Update License Year
+name: Update Notice Year
 
 on:
   schedule:
@@ -23,23 +23,23 @@ jobs:
       - name: Set Previous Year
         run: "echo PREVIOUS=$(($CURRENT-1)) >> $GITHUB_ENV"
 
-      - name: Update LICENSE
+      - name: Update NOTICE
         uses: jacobtomlinson/gha-find-replace@v3
         with:
           find: ${{ env.PREVIOUS }}
           replace: ${{ env.CURRENT }}
-          include: "**/LICENSE"
+          include: "NOTICE"
           regex: false
 
       - name: Commit files
         run: |
           git config user.name 'github-actions[bot]'
           git config user.email 'github-actions[bot]@users.noreply.github.com'
-          git commit -m "Updated License Year" -a
+          git commit -m "Updated Notice Year" -a
 
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v5
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          title: Update License Year
-          branch: update-license
+          title: Update Notice Year
+          branch: update-notice

CONTRIBUTORS-GUIDE.md

@@ -26,6 +26,10 @@ Run unit tests in Android & iOS packages with `flutter test`.
 
 Run unit tests in Web package with `flutter test --platform chrome`.
 
+### Linting and other useful checks
+
+Run the static code analyzer (`flutter analyze`) to fix any errors, warnings, lints, or formatting issues.
+
 # Contact
 
 If you have any other questions or need to contact us directly in a private manner send us a note at sdks@split.io

NOTICE

@@ -0,0 +1,5 @@
+Harness Feature Management Flutter SDK Copyright 2024-2026 Harness Inc.
+
+This product includes software developed at Harness Inc. (https://harness.io/).
+
+This product includes software originally developed by Split Software, Inc. (https://www.split.io/). Copyright 2022-2024 Split Software, Inc.

splitio/CHANGELOG.md

@@ -1,15 +1,26 @@
+# 1.2.1 (Jan 28, 2026)
+* Bug fix: corrected asset path for loading the Browser SDK.
+
+# 1.2.1-rc.1 (Jan 28, 2026)
+
+# 1.2.0 (Jan 28, 2026)
+* Added new configuration for Fallback Treatments, which allows setting a treatment value and optional config to be returned in place of "control", either globally or by flag. Read more in our docs.
+* Updated Android SDK to `5.4.2`, iOS SDK to `3.6.0`, and Browser SDK to `1.6.1`
+
+# 1.2.0-rc.1 (Jan 28, 2026)
+
 # 1.1.0 (Jan 16, 2026)
-- Added Web support via the `splitio_web` package, the Web implementation of `splitio` based on the Split Browser SDK v1.6.0.
+* Added Web support via the `splitio_web` package, the Web implementation of `splitio` based on the Split Browser SDK `1.6.0`.
 
 # 1.1.0-rc.1 (Jan 15, 2026)
 
 # 1.0.0 (Aug 14, 2025)
-- Updated Android SDK to `5.3.1` & iOS SDK to `3.3.2`
-- Added support for rule-based segments. These segments determine membership at runtime by evaluating their configured rules against the user attributes provided to the SDK.
-- Added support for feature flag prerequisites. This allows customers to define dependency conditions between flags, which are evaluated before any allowlists or targeting rules.
-- Added two new configuration options to control the behavior of the persisted rollout plan cache. Use `rolloutCacheConfiguration` in the config.
-- Added a new optional argument to the client `getTreatment` methods to allow passing additional evaluation options, such as a map of properties to append to the generated impressions sent to Split backend. Read more in our docs.
-- Added support for the new impressions tracking toggle available on feature flags, both respecting the setting and including the new field being returned on SplitView type objects. Read more in our docs.
+* Updated Android SDK to `5.3.1` & iOS SDK to `3.3.2`
+* Added support for rule-based segments. These segments determine membership at runtime by evaluating their configured rules against the user attributes provided to the SDK.
+* Added support for feature flag prerequisites. This allows customers to define dependency conditions between flags, which are evaluated before any allowlists or targeting rules.
+* Added two new configuration options to control the behavior of the persisted rollout plan cache. Use `rolloutCacheConfiguration` in the config.
+* Added a new optional argument to the client `getTreatment` methods to allow passing additional evaluation options, such as a map of properties to append to the generated impressions sent to Split backend. Read more in our docs.
+* Added support for the new impressions tracking toggle available on feature flags, both respecting the setting and including the new field being returned on SplitView type objects. Read more in our docs.
 
 # 1.0.0-rc.1 (Aug 14, 2025)
 

splitio/analysis_options.yaml

@@ -2,3 +2,7 @@ include: package:flutter_lints/flutter.yaml
 
 # Additional information about this file can be found at
 # https://dart.dev/guides/language/analysis-options
+
+linter:
+  rules:
+    - public_member_api_docs

splitio/example/ios/Podfile.lock

@@ -1,9 +1,9 @@
 PODS:
   - Flutter (1.0.0)
-  - Split (3.3.2)
-  - splitio_ios (0.8.0):
+  - Split (3.6.0)
+  - splitio_ios (0.9.0):
     - Flutter
-    - Split (~> 3.3.2)
+    - Split (~> 3.6.0)
 
 DEPENDENCIES:
   - Flutter (from `Flutter`)
@@ -20,9 +20,9 @@ EXTERNAL SOURCES:
     :path: ".symlinks/plugins/splitio_ios/ios"
 
 SPEC CHECKSUMS:
-  Flutter: e0871f40cf51350855a761d2e70bf5af5b9b5de7
-  Split: 0d4962a6c15180e1857c1a3753e1ae9c91a6150b
-  splitio_ios: 438ad21d0dfe467670f8b9508773b77b16a71d6b
+  Flutter: cabc95a1d2626b1b06e7179b784ebcf0c0cde467
+  Split: 1e2176aacd6421029bea41413401389d86e3d50a
+  splitio_ios: ad4f484a6c478bf7285e417ea8252371f66b54ff
 
 PODFILE CHECKSUM: 4e8f8b2be68aeea4c0d5beb6ff1e79fface1d048
 

splitio/example/lib/main.dart

@@ -1,3 +1,5 @@
+// ignore_for_file: avoid_print
+
 import 'package:flutter/material.dart';
 import 'package:splitio/splitio.dart';
 

splitio/example/pubspec.lock

@@ -171,39 +171,39 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "1.1.0"
+    version: "1.2.1"
   splitio_android:
     dependency: transitive
     description:
       name: splitio_android
-      sha256: "344bf82de6694cffb8dd80a96ee734e31bb838d2b4693fb046e0fc98e31512ca"
+      sha256: "7c0e5ad4ccdf4990120a7a6a2f067d274c107ab9830fd20b1d54bf3f0392ac02"
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.0"
+    version: "1.1.0"
   splitio_ios:
     dependency: transitive
     description:
       name: splitio_ios
-      sha256: "1c078bc49bf7b30df6ca50accb6a9eecf592ec607e20e77b1c6ecdabc7a44dc9"
+      sha256: c15cd7dfd195df107ae07c030fd742dcabb0610c769466d6d7e3890d22a91bc2
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.0"
+    version: "1.1.0"
   splitio_platform_interface:
     dependency: transitive
     description:
       name: splitio_platform_interface
-      sha256: "8bcb1cab9f5fffb7b79cfeeaf6c80d82f8ede55c8d6ca7578ec78653f3f9e499"
+      sha256: faa022814c7b2fc7b5f68b80b088e1638e06783419075176d1adadcf787897db
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.0"
+    version: "2.1.0"
   splitio_web:
     dependency: transitive
     description:
       name: splitio_web
-      sha256: "29dc1a55d80c026afb0f0bad378c81e44ee1e9da5faaf9e931f35b5dfd3ff5f3"
+      sha256: "656cf71d4ec900cf1ad1b9eae20bbabe797de5c99f49584672161de9fe133afb"
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.0"
+    version: "1.1.1"
   stack_trace:
     dependency: transitive
     description:

splitio/lib/split_client.dart

@@ -1,5 +1,6 @@
 import 'package:splitio_platform_interface/splitio_platform_interface.dart';
 
+/// Abstract class representing a Split client.
 abstract class SplitClient {
   /// Performs an evaluation for the [featureFlagName] feature flag.
   ///
@@ -187,11 +188,13 @@ abstract class SplitClient {
   Future<SplitClient> whenTimeout();
 }
 
+/// Default implementation of the Split client.
 class DefaultSplitClient implements SplitClient {
   final SplitioPlatform _platform;
   final String _matchingKey;
   final String? _bucketingKey;
 
+  /// Creates a new instance of the Split client.
   DefaultSplitClient(this._platform, this._matchingKey, this._bucketingKey);
 
   @override

splitio/lib/splitio.dart

@@ -12,9 +12,13 @@ export 'package:splitio_platform_interface/split_view.dart';
 export 'package:splitio_platform_interface/split_certificate_pinning_configuration.dart';
 export 'package:splitio_platform_interface/split_evaluation_options.dart';
 export 'package:splitio_platform_interface/split_rollout_cache_configuration.dart';
+export 'package:splitio_platform_interface/split_fallback_treatment.dart';
+export 'package:splitio_platform_interface/split_fallback_treatments_configuration.dart';
 
+/// Callback function type for client readiness events.
 typedef ClientReadinessCallback = void Function(SplitClient splitClient);
 
+/// Main class for interacting with the Split Flutter SDK.
 class Splitio {
   final String _sdkKey;
 
@@ -77,7 +81,11 @@ class Splitio {
       ClientReadinessCallback? onReadyFromCache,
       ClientReadinessCallback? onUpdated,
       ClientReadinessCallback? onTimeout}) {
-    String? key = matchingKey ?? _defaultMatchingKey;
+    String key = matchingKey ?? _defaultMatchingKey;
+    if (matchingKey == null && bucketingKey == null) {
+      bucketingKey = _defaultBucketingKey;
+    }
+
     _platform.getClient(matchingKey: key, bucketingKey: bucketingKey);
 
     var client = DefaultSplitClient(_platform, key, bucketingKey);
@@ -108,12 +116,14 @@ class Splitio {
     return client;
   }
 
+  /// Gets the list of all feature flag names.
   Future<List<String>> splitNames() async {
     List<String> splitNames = await _platform.splitNames();
 
     return splitNames;
   }
 
+  /// Gets the list of all feature flag views.
   Future<List<SplitView>> splits() async {
     return _platform.splits();
   }
@@ -124,14 +134,22 @@ class Splitio {
     return _platform.impressionsStream();
   }
 
+  /// Gets a specific feature flag view.
+  ///
+  /// Returns null if the provided feature flag name is not found.
   Future<SplitView?> split(String splitName) async {
     return _platform.split(splitName: splitName);
   }
 
+  /// Gets the user consent status.
   Future<UserConsent> getUserConsent() async {
     return _platform.getUserConsent();
   }
 
+  /// Sets the user consent status.
+  ///
+  /// [enabled] is a boolean that enables (`UserConsent.granted`)
+  /// or disables (`UserConsent.declined`) data collection.
   Future<void> setUserConsent(bool enabled) async {
     return _platform.setUserConsent(enabled);
   }