Qa

.github/workflows/test.yml

@@ -16,11 +16,14 @@ jobs:
         run: flutter packages get
 
       - name: Format code
-        run: dart format --fix
+        run: dart format .
 
       - name: Analyze Code
         run: flutter analyze lib test example
 
+      - name: Test Publish
+        run:  dart pub publish --dry-run
+
       - name: Test
         run: flutter test --coverage
 

.gitignore

@@ -28,3 +28,5 @@ migrate_working_dir/
 .dart_tool/
 .packages
 build/
+.flutter-plugins-dependencies
+.flutter-plugins

CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 1.5.0
+
+###  SDK & Dependency Updates
+
+* Updated SDK constraints:
+
+  * Dart: `>=3.8.0 <4.0.0`
+  * Flutter: `>=3.32.0`
+* Upgraded dependencies:
+
+  * `async: ^2.13.0`
+  * `playx_core: ^0.7.3`
+  * `playx_theme: ^1.1.0`
+  * `playx_widget: ^0.3.0`
+  * `playx_network: ^0.5.1`
+  * `playx_navigation: ^0.2.0`
+  * `playx_localization: ^0.3.0`
+  * `sentry_flutter: ^9.2.0`
+  * `internet_connection_checker_plus: ^2.7.2`
+  * `connectivity_plus: ^6.1.4`
+
+###  Connection Status Enhancements
+
+* Improved `ConnectionStatusController`:
+
+  * Replaced default internet check URLs with more reliable ones.
+  * Added `backOnlineDelay` to control delay after reconnection.
+  * Skipped unnecessary checks on app resume.
+
+###  Project Maintenance
+
+* Migrated example project’s Android build files to **Kotlin DSL (`.kts`)**.
+* Upgraded example project dependencies for compatibility.
+
+
 ## 1.4.1
 - Update packages.
 

example/.metadata

@@ -4,7 +4,7 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: "68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3"
+  revision: "fcf2c11572af6f390246c056bc905eca609533a0"
   channel: "stable"
 
 project_type: app
@@ -13,26 +13,26 @@ project_type: app
 migration:
   platforms:
     - platform: root
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
     - platform: android
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
     - platform: ios
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
     - platform: linux
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
     - platform: macos
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
     - platform: web
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
     - platform: windows
-      create_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
-      base_revision: 68415ad1d920f6fe5ec284f5c2febf7c4dd5b0b3
+      create_revision: fcf2c11572af6f390246c056bc905eca609533a0
+      base_revision: fcf2c11572af6f390246c056bc905eca609533a0
 
   # User provided section
 

example/android/.gitignore

@@ -5,134 +5,10 @@ gradle-wrapper.jar
 /gradlew.bat
 /local.properties
 GeneratedPluginRegistrant.java
+.cxx/
 
 # Remember to never publicly share your keystore.
 # See https://flutter.dev/to/reference-keystore
 key.properties
 **/*.keystore
 **/*.jks
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/query/client-agp/cache-v2
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/query/client-agp/cmakeFiles-v1
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/query/client-agp/codemodel-v2
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/reply/cache-v2-18571856890350f0824d.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/reply/cmakeFiles-v1-d11fca9ba96e713762d9.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/reply/codemodel-v2-2eea782cc0a3e7d384fe.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/reply/directory-.-Debug-d0094a50bb2071803777.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/.cmake/api/v1/reply/index-2025-03-12T19-05-16-0682.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.c
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.o
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.cpp
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.o
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCCompiler.cmake
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCXXCompiler.cmake
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_C.bin
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_CXX.bin
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeSystem.cmake
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/cmake.check_cache
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/rules.ninja
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeFiles/TargetDirectories.txt
-/app/.cxx/Debug/3z3j495b/arm64-v8a/additional_project_files.txt
-/app/.cxx/Debug/3z3j495b/arm64-v8a/android_gradle_build.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/android_gradle_build_mini.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/build.ninja
-/app/.cxx/Debug/3z3j495b/arm64-v8a/build_file_index.txt
-/app/.cxx/Debug/3z3j495b/arm64-v8a/cmake_install.cmake
-/app/.cxx/Debug/3z3j495b/arm64-v8a/CMakeCache.txt
-/app/.cxx/Debug/3z3j495b/arm64-v8a/configure_fingerprint.bin
-/app/.cxx/Debug/3z3j495b/arm64-v8a/metadata_generation_command.txt
-/app/.cxx/Debug/3z3j495b/arm64-v8a/prefab_config.json
-/app/.cxx/Debug/3z3j495b/arm64-v8a/symbol_folder_index.txt
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/query/client-agp/cache-v2
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/query/client-agp/cmakeFiles-v1
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/query/client-agp/codemodel-v2
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/reply/cache-v2-efc38ddb025d20aa9f54.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/reply/cmakeFiles-v1-2c67d48941a5c2515bb2.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/reply/codemodel-v2-4dcf0f14cee4d381c28d.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/reply/directory-.-Debug-d0094a50bb2071803777.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/.cmake/api/v1/reply/index-2025-03-12T19-05-27-0226.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.c
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.o
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.cpp
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.o
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCCompiler.cmake
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCXXCompiler.cmake
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_C.bin
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_CXX.bin
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/3.22.1-g37088a8-dirty/CMakeSystem.cmake
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/cmake.check_cache
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/rules.ninja
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeFiles/TargetDirectories.txt
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/additional_project_files.txt
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/android_gradle_build.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/android_gradle_build_mini.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/build.ninja
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/build_file_index.txt
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/cmake_install.cmake
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/CMakeCache.txt
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/configure_fingerprint.bin
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/metadata_generation_command.txt
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/prefab_config.json
-/app/.cxx/Debug/3z3j495b/armeabi-v7a/symbol_folder_index.txt
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/query/client-agp/cache-v2
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/query/client-agp/cmakeFiles-v1
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/query/client-agp/codemodel-v2
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/reply/cache-v2-0f36b46314711f555579.json
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/reply/cmakeFiles-v1-d03af4cbaff4c35023ba.json
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/reply/codemodel-v2-14966da1d6ce366fbfa3.json
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/reply/directory-.-Debug-d0094a50bb2071803777.json
-/app/.cxx/Debug/3z3j495b/x86/.cmake/api/v1/reply/index-2025-03-12T19-05-35-0807.json
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.c
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.o
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.cpp
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.o
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCCompiler.cmake
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCXXCompiler.cmake
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_C.bin
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_CXX.bin
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/3.22.1-g37088a8-dirty/CMakeSystem.cmake
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/cmake.check_cache
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/rules.ninja
-/app/.cxx/Debug/3z3j495b/x86/CMakeFiles/TargetDirectories.txt
-/app/.cxx/Debug/3z3j495b/x86/additional_project_files.txt
-/app/.cxx/Debug/3z3j495b/x86/android_gradle_build.json
-/app/.cxx/Debug/3z3j495b/x86/android_gradle_build_mini.json
-/app/.cxx/Debug/3z3j495b/x86/build.ninja
-/app/.cxx/Debug/3z3j495b/x86/build_file_index.txt
-/app/.cxx/Debug/3z3j495b/x86/cmake_install.cmake
-/app/.cxx/Debug/3z3j495b/x86/CMakeCache.txt
-/app/.cxx/Debug/3z3j495b/x86/configure_fingerprint.bin
-/app/.cxx/Debug/3z3j495b/x86/metadata_generation_command.txt
-/app/.cxx/Debug/3z3j495b/x86/prefab_config.json
-/app/.cxx/Debug/3z3j495b/x86/symbol_folder_index.txt
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/query/client-agp/cache-v2
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/query/client-agp/cmakeFiles-v1
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/query/client-agp/codemodel-v2
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/reply/cache-v2-919a7980865cfcc51ea3.json
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/reply/cmakeFiles-v1-7a0f6549ce0008eda020.json
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/reply/codemodel-v2-75f2e3a96ca61039dced.json
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/reply/directory-.-Debug-d0094a50bb2071803777.json
-/app/.cxx/Debug/3z3j495b/x86_64/.cmake/api/v1/reply/index-2025-03-12T19-05-55-0131.json
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.c
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdC/CMakeCCompilerId.o
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.cpp
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CompilerIdCXX/CMakeCXXCompilerId.o
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCCompiler.cmake
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CMakeCXXCompiler.cmake
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_C.bin
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CMakeDetermineCompilerABI_CXX.bin
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/3.22.1-g37088a8-dirty/CMakeSystem.cmake
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/cmake.check_cache
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/rules.ninja
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeFiles/TargetDirectories.txt
-/app/.cxx/Debug/3z3j495b/x86_64/additional_project_files.txt
-/app/.cxx/Debug/3z3j495b/x86_64/android_gradle_build.json
-/app/.cxx/Debug/3z3j495b/x86_64/android_gradle_build_mini.json
-/app/.cxx/Debug/3z3j495b/x86_64/build.ninja
-/app/.cxx/Debug/3z3j495b/x86_64/build_file_index.txt
-/app/.cxx/Debug/3z3j495b/x86_64/cmake_install.cmake
-/app/.cxx/Debug/3z3j495b/x86_64/CMakeCache.txt
-/app/.cxx/Debug/3z3j495b/x86_64/configure_fingerprint.bin
-/app/.cxx/Debug/3z3j495b/x86_64/metadata_generation_command.txt
-/app/.cxx/Debug/3z3j495b/x86_64/prefab_config.json
-/app/.cxx/Debug/3z3j495b/x86_64/symbol_folder_index.txt
-/app/.cxx/Debug/3z3j495b/hash_key.txt

example/android/app/build.gradle.kts

@@ -0,0 +1,44 @@
+plugins {
+    id("com.android.application")
+    id("kotlin-android")
+    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+    id("dev.flutter.flutter-gradle-plugin")
+}
+
+android {
+    namespace = "com.example.playx_example"
+    compileSdk = flutter.compileSdkVersion
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_17.toString()
+    }
+
+    defaultConfig {
+        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+        applicationId = "com.example.playx_example"
+        // You can update the following values to match your application needs.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
+        minSdk = flutter.minSdkVersion
+        targetSdk = flutter.targetSdkVersion
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+    }
+
+    buildTypes {
+        release {
+            // TODO: Add your own signing config for the release build.
+            // Signing with the debug keys for now, so `flutter run --release` works.
+            signingConfig = signingConfigs.getByName("debug")
+        }
+    }
+}
+
+flutter {
+    source = "../.."
+}

example/android/app/src/main/kotlin/com/example/playx_example/MainActivity.kt

@@ -0,0 +1,5 @@
+package com.example.playx_example
+
+import io.flutter.embedding.android.FlutterActivity
+
+class MainActivity : FlutterActivity()