Release 4.4.1

Str4tos · Str4tos · commit cf15d4ba21fd · 2025-10-30T11:35:10.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,8 @@
+## 4.4.1
+- Updated CAS [Android](https://github.com/cleveradssolutions/CAS-Android/releases) and [iOS](https://github.com/cleveradssolutions/CAS-iOS/releases) dependencies to 4.4.1
+- Renamed `AdError.rejected` to `AdError.codeRejected` for consistency with other error codes.
+- Migration to the new [Developer Docs](https://docs.page/cleveradssolutions/docs/Flutter)
+
 ## 4.3.0
 ### Major changes
 - Version bumped to 4.3 to align with native SDK versions.
diff --git a/LICENSE b/LICENSE
@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2025 CleverAdsSolutions LTD, CAS.AI
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
diff --git a/README.md b/README.md
@@ -1,14 +1,15 @@
 # CAS.AI Mobile Ads for Flutter
 [![Pub Version](https://img.shields.io/pub/v/clever_ads_solutions)](https://pub.dev/packages/clever_ads_solutions/versions)
-[![App-ads.txt](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/cleveradssolutions/App-ads.txt/master/Shield.json)](https://github.com/cleveradssolutions/App-ads.txt)
 ![Platform](https://img.shields.io/badge/platform-Android%20%7C%20iOS-blue.svg)
+[![App-ads.txt](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/cleveradssolutions/App-ads.txt/master/Shield.json)](https://github.com/cleveradssolutions/App-ads.txt)
+
 
 The CAS.AI Mobile Ads SDK (by CleverAdsSolutions) offers advanced mobile advertising capabilities with refined ad formats and streamlined APIs to access multiple ad networks and maximize monetization in mobile apps.
 
 This repository contains the official Flutter plugin for CAS.AI, allowing Flutter developers to easily integrate and monetize their apps using the CAS.AI SDK.
 
 ## Documentation
-For setup instructions, usage examples, and API details, refer to the [Developer Guide on our Wiki](https://github.com/cleveradssolutions/CAS-Flutter/wiki).
+For setup instructions, usage examples, and API details, refer to the [Developer Guide](https://docs.page/cleveradssolutions/docs/Flutter).
 
 ## Downloads
 Visit [pub.dev](https://pub.dev/packages/clever_ads_solutions/versions) to get the latest version of the plugin.
diff --git a/android/build.gradle b/android/build.gradle
@@ -1,5 +1,5 @@
 group = 'com.cleveradssolutions.plugin.flutter'
-version = '4.3.0'
+version = '4.4.1'
 
 buildscript {
     ext.kotlin_version = '2.0.21'
@@ -90,6 +90,6 @@ android {
     }
 
     dependencies {
-        implementation 'com.cleveradssolutions:cas-sdk:4.3.0'
+        implementation 'com.cleveradssolutions:cas-sdk:4.4.1'
     }
 }
diff --git a/android/src/main/kotlin/com/cleveradssolutions/plugin/flutter/CASMobileAdsPlugin.kt b/android/src/main/kotlin/com/cleveradssolutions/plugin/flutter/CASMobileAdsPlugin.kt
@@ -21,7 +21,7 @@ import io.flutter.plugin.common.MethodCall
 import io.flutter.plugin.common.MethodChannel
 import io.flutter.plugin.common.StandardMethodCodec
 
-private const val PLUGIN_VERSION = "4.3.0"
+private const val PLUGIN_VERSION = "4.4.1"
 private const val DEFAULT_KEY = "value"
 
 class CASMobileAdsPlugin : FlutterPlugin, ActivityAware, MethodChannel.MethodCallHandler {
diff --git a/example/android/app/build.gradle b/example/android/app/build.gradle
@@ -3,7 +3,7 @@ plugins {
     id "kotlin-android"
     // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
     id "dev.flutter.flutter-gradle-plugin"
-    id("com.cleveradssolutions.gradle-plugin") version "4.3.0"
+    id("com.cleveradssolutions.gradle-plugin") version "4.4.1"
 }
 
 cas {
diff --git a/example/ios/Podfile b/example/ios/Podfile
@@ -3,7 +3,7 @@ platform :ios, '13.0'
 source 'https://cdn.cocoapods.org/'
 source 'https://github.com/cleveradssolutions/CAS-Specs.git'
 
-$casVersion = '4.3.0'
+$casVersion = '4.4.1'
 
 # CocoaPods analytics sends network stats synchronously affecting flutter build latency.
 ENV['COCOAPODS_DISABLE_STATS'] = 'true'
diff --git a/ios/Classes/CASMobileAdsPlugin.swift b/ios/Classes/CASMobileAdsPlugin.swift
@@ -1,7 +1,7 @@
 import CleverAdsSolutions
 import Flutter
 
-private let pluginVersion = "4.3.0"
+private let pluginVersion = "4.4.1"
 private let defaultKey = "value"
 
 @objc(CASMobileAdsPlugin)
diff --git a/ios/clever_ads_solutions.podspec b/ios/clever_ads_solutions.podspec
@@ -4,7 +4,7 @@
 #
 Pod::Spec.new do |s|
   s.name             = 'clever_ads_solutions'
-  s.version          = '4.3.0'
+  s.version          = '4.4.1'
   s.summary          = 'CAS.AI plugin for Flutter.'
   s.description      = <<-DESC
 CAS.AI Mobile Ads plugin for Flutter.
@@ -20,7 +20,7 @@ CAS.AI Mobile Ads plugin for Flutter.
   s.static_framework = true
 
   s.dependency 'Flutter'
-  s.dependency 'CleverAdsSolutions-Base', '~> 4.3.0'
+  s.dependency 'CleverAdsSolutions-Base', '~> 4.4.1'
 
   s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES', 'VALID_ARCHS' => 'armv7 arm64 x86_64' }
 end
diff --git a/lib/src/ad_error.dart b/lib/src/ad_error.dart
@@ -1,24 +1,24 @@
-/// To see the error code, see AdError.code.
-/// To see a description of the error, see AdError.message.
-/// See CODE constants for a list of error codes.
+/// Use [code] to retrieve the error code.
+/// Use [message] to get a human-readable error description.
+/// See `code` constants for all available error codes.
 class AdError implements Comparable<int> {
   /// Indicates an internal error occurred.
   static const int codeInternalError = 0;
 
+  /// Indicates that ads are not ready to be shown.
+  /// Ensure to call the appropriate ad loading method or use automatic cache mode.
+  /// If using automatic load mode, wait a little longer for ads to be ready.
+  static const int codeNotReady = 1;
+
   /// Indicates that the device is rejected for services.
   /// Services may not be available for some devices that do not meet the requirements.
   /// For example, the country or version of the OS.
-  static const int rejected = 2;
+  static const int codeRejected = 2;
 
   /// Indicates that no ads are available to be served.
   /// If ads are visible in demo mode, your implementation is correct, and ads will be served once live.
   static const int codeNoFill = 3;
 
-  /// Indicates that ads are not ready to be shown.
-  /// Ensure to call the appropriate ad loading method or use automatic cache mode.
-  /// If using automatic load mode, wait a little longer for ads to be ready.
-  static const int codeNotReady = 1;
-
   /// Indicates that the ad creative has reached its daily cap for the user.
   /// This is typically relevant for cross-promotion ads only.
   static const int codeReachedCap = 6;
@@ -77,4 +77,8 @@ class AdError implements Comparable<int> {
 
   @override
   int compareTo(int other) => code.compareTo(other);
+
+  /// Renamed to [codeRejected]
+  @Deprecated("Renamed to codeRejected")
+  static const int rejected = codeRejected;
 }
diff --git a/lib/src/ad_instances.dart b/lib/src/ad_instances.dart
@@ -182,7 +182,7 @@ class CASAppOpen extends AdScreenInstance {
   /// Create [CASAppOpen] and load ad content.
   ///
   /// - [casId] - The unique identifier of the CAS content for each platform.
-  /// Leave blank to use the initialization identifier.
+  /// Leave null to use the initialization identifier.
   /// - [autoReload] - If enabled, the ad will automatically load new content when the current ad is dismissed or completed.
   /// Additionally, it will automatically retry loading the ad if an error occurs during the loading process.
   /// - [autoShow] - If enabled, the ad will automatically displayed when the user returns to the app.
@@ -243,7 +243,7 @@ class CASInterstitial extends AdScreenInstance {
   /// Create [CASInterstitial] and load ad content.
   ///
   /// - [casId] - The unique identifier of the CAS content for each platform.
-  /// Leave blank to use the initialization identifier.
+  /// Leave null to use the initialization identifier.
   /// - [autoReload] - If enabled, the ad will automatically load new content
   /// when the current ad is dismissed or completed.
   /// Additionally, it will automatically retry loading the ad if an error occurs
@@ -346,7 +346,7 @@ class CASRewarded extends AdScreenInstance {
   /// Create [CASRewarded] and load ad content.
   ///
   /// - [casId] - The unique identifier of the CAS content for each platform.
-  /// Leave blank to use the initialization identifier.
+  /// Leave null to use the initialization identifier.
   /// - [autoReload] - If enabled, the ad will automatically load new content
   /// when the current ad is dismissed or completed.
   /// Additionally, it will automatically retry loading the ad if an error occurs
diff --git a/lib/src/banner_ads.dart b/lib/src/banner_ads.dart
@@ -11,7 +11,7 @@ class CASBanner extends AdViewInstance {
   ///
   /// - [size] - Represents the size of a banner ad.
   /// - [casId] - The unique identifier of the CAS content for each platform.
-  /// Leave blank to use the initialization identifier.
+  /// Leave null to use the initialization identifier.
   /// - [autoReload] - If enabled, the ad will automatically retry loading the ad
   /// if an error occurs during the loading process.
   /// - [refreshInterval] - Sets the refresh interval in seconds for displaying
diff --git a/lib/src/native_ads.dart b/lib/src/native_ads.dart
@@ -39,7 +39,9 @@ class CASNativeContent extends AdViewInstance {
   /// CASNativeContent.load(
   ///   onAdLoaded: (ad) {
   ///     // Ad successfully loaded - display an CASWidget with the native ad.
-  ///     _nativeAd = ad;
+  ///     setState(() {
+  //        _nativeAd = ad;
+  //      });
   ///   },
   ///   onAdFailedToLoad: (ad, error) {
   ///     // Ad failed to load - log the error.
@@ -48,7 +50,7 @@ class CASNativeContent extends AdViewInstance {
   /// ```
   ///
   /// - [casId] - The unique identifier of the CAS content for each platform.
-  /// Leave blank to use the initialization identifier.
+  /// Leave null to use the initialization identifier.
   /// - [factoryId] - An identifier for the platform factory that creates the Platform view.
   /// If you do not provide a [factoryId] for the native factory, CAS will build
   /// a default template view based on the size you specify for the [CASWidget].
diff --git a/pubspec.yaml b/pubspec.yaml
@@ -1,6 +1,6 @@
 name: clever_ads_solutions
 description: The CAS.AI Flutter plugin allows you to easily monetize your apps for iOS and Android using lot of Ads SDKs in mediation.
-version: 4.3.0
+version: 4.4.1
 repository: https://github.com/cleveradssolutions/CAS-Flutter
 documentation: https://github.com/cleveradssolutions/CAS-Flutter/wiki
 issue_tracker: https://github.com/cleveradssolutions/CAS-Flutter/issues
diff --git a/tools/version_updater.py b/tools/version_updater.py
@@ -2,8 +2,8 @@
 import re
 import sys
 
-_FLUTTER_PLUGIN_VERSION = "4.3.0"
-_CAS_VERSION = "4.3.0"
+_PLUGIN_VERSION = "4.4.1"
+_CAS_VERSION = "4.4.1"
 
 # Plugin publishing flow (from the project root):
 # python3 tools/version_updater.py
@@ -67,36 +67,36 @@ def update_flutter_plugin_version():
     update_version_in_file(
         os.path.join('pubspec.yaml'),
         "version: ",
-        _FLUTTER_PLUGIN_VERSION
+        _PLUGIN_VERSION
     )
 
 
 def update_flutter_plugin_version_dart():
     update_version_in_file(
         os.path.join('android', 'src', 'main', 'kotlin', 'com', 'cleveradssolutions', 'plugin', 'flutter', 'CASMobileAdsPlugin.kt'),
         'private const val PLUGIN_VERSION = "',
-        _FLUTTER_PLUGIN_VERSION + '"'
+        _PLUGIN_VERSION + '"'
     )
     update_version_in_file(
         os.path.join('ios', 'Classes', 'CASMobileAdsPlugin.swift'),
         'private let pluginVersion = "',
-        _FLUTTER_PLUGIN_VERSION + '"'
+        _PLUGIN_VERSION + '"'
     )
 
 
 def update_flutter_plugin_version_android():
     update_version_in_file(
         os.path.join('android', 'build.gradle'),
         "version = '",
-        _FLUTTER_PLUGIN_VERSION + "'"
+        _PLUGIN_VERSION + "'"
     )
 
 
 def update_flutter_plugin_version_ios():
     update_version_in_file(
         os.path.join('ios', 'clever_ads_solutions.podspec'),
         "  s.version          = '",
-        _FLUTTER_PLUGIN_VERSION + "'"
+        _PLUGIN_VERSION + "'"
     )
 
 

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`group = 'com.cleveradssolutions.plugin.flutter'`
`2`		`-version = '4.3.0'`
	`2`	`+version = '4.4.1'`
`3`	`3`
`4`	`4`	`buildscript {`
`5`	`5`	`ext.kotlin_version = '2.0.21'`
`@@ -90,6 +90,6 @@ android {`
`90`	`90`	`}`
`91`	`91`
`92`	`92`	`dependencies {`
`93`		`- implementation 'com.cleveradssolutions:cas-sdk:4.3.0'`
	`93`	`+ implementation 'com.cleveradssolutions:cas-sdk:4.4.1'`
`94`	`94`	`}`
`95`	`95`	`}`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@ plugins {`
`3`	`3`	`id "kotlin-android"`
`4`	`4`	`// The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.`
`5`	`5`	`id "dev.flutter.flutter-gradle-plugin"`
`6`		`- id("com.cleveradssolutions.gradle-plugin") version "4.3.0"`
	`6`	`+ id("com.cleveradssolutions.gradle-plugin") version "4.4.1"`
`7`	`7`	`}`
`8`	`8`
`9`	`9`	`cas {`