Release 4.3.0

Author: Str4tos

.gitignore

@@ -44,5 +44,11 @@ app.*.map.json
 /android/app/profile
 /android/app/release
 
+GeneratedPluginRegistrant.h
+GeneratedPluginRegistrant.m
+GeneratedPluginRegistrant.java
+GeneratedPluginRegistrant.swift
+generated_plugin_registrant.dart
+
 # iOS
 Podfile.lock

CHANGELOG.md

@@ -1,3 +1,45 @@
+## 4.3.0
+### Major changes
+- Version bumped to 4.3 to align with native SDK versions.
+- Completely rewritten Android and iOS platform code for improved performance, stability, and better integration with native SDKs.
+- Introduced new `CASMobileAds` class. Deprecated `CAS` and `MediationManager` classes are still available for use but they may be removed in a future release.
+- The CAS SDK initialization is now done via a single function `CASMobileAds.initialize(...)` that uses a `Future` to return the new `InitializationStatus` structure.
+- The Ad format management has been modernized and streamlined. All ad classes now extend the base AdInstance class and share similar callbacks.
+- Introduced `createAndLoad(...)` method for each ad format, accepting all possible configuration options and automatically initiating ad loading. This improvement simplifies and optimizes the creation of ad instances.
+- Introduced support for Native Ads using built-in templates or native platform view factories.
+- The Banner ad management is now handled via the `CASBanner` class, which can be `createAndLoad()` independently of the widget state and displayed using the new `CASWidget`. Platform view rendering has been optimized by simplifying the widget class.
+- The CAS ID only needs to be passed once during initialization if you are using a single ID.
+- The `AdContentInfo` structure now provides ad information synchronously, without requiring `await` of `Future`.
+- Added the `debugGeography` to override `PrivacyGeography` for `ConsentFlow` to test different consent dialogs.
+- The `ConsentFlow.show()` functions now complete `Future<int>` only after the consent form is dismissed and return the resulting consent flow status.
+- For detailed information on all new functions, please refer to the updated wiki.
+- Removed several functions that were previously deprecated.
+### Migration table
+Deprecated functions are still supported but no longer recommended.
+| Deprecated  | Replacement | 
+| ----------- | ----------- | 
+| `CAS.buildManager()...` | `CASMobileAds.initialize(...)` | 
+| `CAS.targetingOptions...` | `CASMobileAds.targetingOptions...` | 
+| `CAS.settings.setMutedAdSounds()` | `CASMobileAds.setAdSoundsMuted()` |
+| `CAS.settings.setDebugMode()` | `CASMobileAds.setDebugLoggingEnabled()` |
+| `CAS.settings.setTrialAdFreeInterval()` | `CASMobileAds.setTrialAdFreeInterval()` |
+| `CAS.settings.setTaggedAudience()` | `CASMobileAds.initialize(targetAudience:)` |
+| `CAS.settings.setTestDeviceId()` | `CASMobileAds.initialize(testDeviceIds:)` |
+| `CASInterstitial.create()` | `CASInterstitial.createAndLoad(...)` |
+| `CASInterstitial.impressionListener` | `CASInterstitial.onAdImpression` |
+| `CASInterstitial.contentCallback` | `CASInterstitial.onAdLoaded` and others |
+| `CASAppOpen.create()` | `CASAppOpen.createAndLoad(...)` |
+| `CASAppOpen.impressionListener` | `CASAppOpen.onAdImpression` |
+| `CASAppOpen.contentCallback` | `CASAppOpen.onAdLoaded` and others |
+| `CASRewarded.create()` | `CASRewarded.createAndLoad(...)` |
+| `CASRewarded.impressionListener` | `CASRewarded.onAdImpression` |
+| `CASRewarded.contentCallback` | `CASRewarded.onAdLoaded` and others |
+| `OnRewardEarnedListener` | `CASRewarded.onUserEarnedReward` |
+| `BannerWidgetState()...` | `CASBanner.createAndLoad(...)` |
+| `BannerWidget(...)` | `CASWidget(ad:)` |
+| `AdSize.getAdaptiveBannerInScreen()` | `maxWidth = MediaQuery.of(context).size.width`<br>and `AdSize.getAdaptiveBanner(maxWidth)` | 
+
+
 ## 0.9.0
 - Updated CAS [Android](https://github.com/cleveradssolutions/CAS-Android/releases) and [iOS](https://github.com/cleveradssolutions/CAS-iOS/releases) dependencies to 4.3.0
 - Updated `AdError` codes for compatibility with CAS 4.

README.md

@@ -1,19 +1,30 @@
-# CAS.AI Flutter Plugin
-The CAS.AI SDK is mobile advertising featuring refined ad formats and streamlined APIs for access to mobile ad networks and advertising solutions. The SDK enables mobile app developers to maximize their monetization in native mobile apps.
-
-This repository contains the source code for the CAS.AI (CleverAdsSolutions) plugin for Flutter. This plugin enables Flutter developers to easily serve ads on Android and iOS apps without having to write Java or Objective-C code. The plugin provides a Dart interface for ad management that is used in your Flutter project.
-
+# 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)
+
+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 instructions on using the plugin, please refer to [this developer guide](https://github.com/cleveradssolutions/CAS-Flutter/wiki).
+For setup instructions, usage examples, and API details, refer to the [Developer Guide on our Wiki](https://github.com/cleveradssolutions/CAS-Flutter/wiki).
 
 ## Downloads
-See [pub.dev](https://pub.dev/packages/clever_ads_solutions/versions) for the latest releases of the plugin.
+Visit [pub.dev](https://pub.dev/packages/clever_ads_solutions/versions) to get the latest version of the plugin.
 
 ## Sample application
-For a sample application demonstrating how to use CAS.AI Flutter plugin see `example` directory.
+A full sample application demonstrating CAS.AI Flutter integration is available in the [example/](https://github.com/cleveradssolutions/CAS-Flutter/tree/main/example) directory.
+
+## Feedback & Contributions
+Found a bug? Have a feature request or suggestion?  
+Please open an issue using [GitHub’s Issue Tracker](https://github.com/cleveradssolutions/CAS-Flutter/issues).
+
+## Native SDK Repositories
+This Flutter plugin is built on top of the official native CAS.AI SDKs:
+- [CAS.AI Android SDK (GitHub)](https://github.com/cleveradssolutions/CAS-Android)
+  Native Android SDK for Java and Kotlin applications.
+- [CAS.AI iOS SDK (GitHub)](https://github.com/cleveradssolutions/CAS-iOS)
+  Native iOS SDK for Swift and Objective-C applications.
 
-## Suggesting improvements
-To file bugs, make feature requests, or to suggest other improvements, please use [GitHub's issue tracker](https://github.com/cleveradssolutions/CAS-Flutter/issues).
+Refer to these repositories for follow the latest releases, changelogs, or to report platform-specific issues.

analysis_options.yaml

@@ -1,4 +1,11 @@
 include: package:flutter_lints/flutter.yaml
 
-# Additional information about this file can be found at
-# https://dart.dev/guides/language/analysis-options
+analyzer:
+  exclude: [
+  ]
+  errors:
+    omit_local_variable_types: ignore
+
+linter:
+  rules:
+    - public_member_api_docs

android/build.gradle

@@ -1,8 +1,8 @@
 group = 'com.cleveradssolutions.plugin.flutter'
-version = '0.9.0'
+version = '4.3.0'
 
 buildscript {
-    ext.kotlin_version = '1.8.22'
+    ext.kotlin_version = '2.0.21'
     repositories {
         google()
         mavenCentral()
@@ -90,6 +90,6 @@ android {
     }
 
     dependencies {
-        api 'com.cleveradssolutions:cas-sdk:4.3.0'
+        implementation 'com.cleveradssolutions:cas-sdk:4.3.0'
     }
-}
+}

android/src/main/kotlin/com/cleveradssolutions/plugin/flutter/AdContentInfoMethodHandler.kt

@@ -0,0 +1,93 @@
+package com.cleveradssolutions.plugin.flutter
+
+import android.app.Activity
+import android.util.Size
+import com.cleveradssolutions.sdk.AdContentInfo
+import com.cleversolutions.ads.AdError
+import io.flutter.plugin.common.MethodChannel
+
+/**
+ * Maintains reference to ad instances for the CASMobileAdsPlugin.
+ *
+ * When an Ad is loaded from Dart, an equivalent ad object is created
+ * and maintained here to provide access until the ad is disposed.
+ */
+internal class AdInstanceManager(
+    private val channel: MethodChannel
+) {
+    var activity: Activity? = null
+
+    private val ads = HashMap<Int, FlutterAd>()
+
+    fun findAd(adId: Int): FlutterAd? = ads[adId]
+
+    fun trackAd(ad: FlutterAd) {
+        require(ads[ad.adId] == null) {
+            "Ad for following adId already exists: ${ad.adId}"
+        }
+        ads[ad.adId] = ad
+    }
+
+    fun disposeAd(adId: Int) {
+        ads.remove(adId)?.dispose()
+    }
+
+    fun disposeAllAds() {
+        for ((_, value) in ads) {
+            value.dispose()
+        }
+        ads.clear()
+    }
+
+    fun onAdLoaded(adId: Int, size: Size?) {
+        val args = HashMap<String, Any>()
+        args["adId"] = adId
+        if (size != null)
+            args["size"] = size
+        channel.invokeMethod("onAdLoaded", args)
+    }
+
+    fun onAdFailedToLoad(adId: Int, error: AdError) {
+        val args = HashMap<String, Any>()
+        args["adId"] = adId
+        args["error"] = error
+        channel.invokeMethod("onAdFailedToLoad", args)
+    }
+
+    fun onAdFailedToShow(adId: Int, error: AdError) {
+        val args = HashMap<String, Any>()
+        args["adId"] = adId
+        args["error"] = error
+        channel.invokeMethod("onAdFailedToShow", args)
+    }
+
+    fun onAdShowed(adId: Int) {
+        invokeOnAdEvent("onAdShowed", adId)
+    }
+
+    fun onAdClicked(adId: Int) {
+        invokeOnAdEvent("onAdClicked", adId)
+    }
+
+    fun onAdImpression(adId: Int, contentInfo: AdContentInfo) {
+        val args = HashMap<String, Any>()
+        args["adId"] = adId
+        args["info"] = contentInfo
+        channel.invokeMethod("onAdImpression", args)
+    }
+
+    fun onAdDismissed(adId: Int) {
+        invokeOnAdEvent("onAdDismissed", adId)
+    }
+
+    fun onAdUserEarnedReward(adId: Int) {
+        invokeOnAdEvent("onAdUserEarnedReward", adId)
+    }
+
+    private fun invokeOnAdEvent(name: String, adId: Int) {
+        val args = HashMap<String, Any>()
+        args["adId"] = adId
+        channel.invokeMethod(name, args)
+    }
+
+}