Merge: branch 'main'

CHANGELOG.md

@@ -9,6 +9,13 @@
 
 -  Add `Tilt.lightShadowMode` and configuration. ([#12](https://github.com/fluttercandies/flutter_tilt/pull/12))
 
+## 3.1.0
+
+### Improvements
+
+- Bump `sensors_plus` package from `6.0.0` to `6.1.0`. ([#20](https://github.com/fluttercandies/flutter_tilt/pull/20))
+- Migrate the example to Android Studio Ladybug (JDK 21). ([#19](https://github.com/fluttercandies/flutter_tilt/pull/19))
+
 ## 3.0.6
 
 ### Improvements

README-ZH.md

@@ -55,9 +55,11 @@
 
   - [版本兼容](#版本兼容-)
 
+  - [平台兼容](#平台兼容-)
+
   - [添加 flutter_tilt](#添加-flutter_tilt-)
 
-- [传感器兼容](#传感器兼容-)
+- [传感器兼容][]
 
 - [手势优先级](#手势优先级-)
 
@@ -100,7 +102,7 @@
 - 🔦 光照效果
 - 💡 阴影效果
 - 👀 视差效果
-- 📱 陀螺仪传感器支持（[传感器兼容](#传感器兼容-)）
+- 📱 陀螺仪传感器支持（[传感器兼容][]）
 - 🧱 多种布局位置
 - 👇 支持鼠标、触摸和传感器事件
 - 🖼️ 流畅的动画
@@ -117,6 +119,13 @@
 | flutter_tilt 1.0.0+ |    ✅    |    ❌    |    ❌    |  
 
 
+### 平台兼容 📱  
+
+| Android |  iOS  |  Web  | macOS | Windows | Linux |  
+| :-----: | :---: | :---: | :---: | :-----: | :---: |  
+|   ✅   |   ✅  |  ✅   |  ✅  |   ✅   |  ✅   |  
+
+
 ### 添加 flutter_tilt 📦  
 
 使用 Flutter 运行以下指令，  
@@ -129,17 +138,18 @@ $ flutter pub add flutter_tilt
 
 ```yaml
 dependencies:
-  flutter_tilt: ^latest_version
+  flutter_tilt: ^最新版本
 ```
 
 
-## 传感器兼容 📱
+## 传感器兼容 📱  
 
-传感器仅在以下平台触发。
+传感器仅在以下平台触发。  
+不支持传感器的平台不会影响其他功能的正常使用。  
 
-| Android |  iOS  |                 Web (HTTPS)                  | macOS | Linux | Windows |  
-| :-----: | :---: | :------------------------------------------: | :---: | :---: | :-----: |  
-|   ✅   |   ✅  | [浏览器兼容][Gyroscope Browser compatibility] |  ❌  |   ❌  |   ❌   |  
+| Android |  iOS  |                 Web (HTTPS)                  | macOS | Windows | Linux |  
+| :-----: | :---: | :------------------------------------------: | :---: | :-----: | :---: |  
+|   ✅   |   ✅  | [浏览器兼容][Gyroscope Browser compatibility] |  ❌  |   ❌    |  ❌  |  
 
 > [!NOTE]  
 > 目前 Web 使用 [Sensor API - Gyroscope][]，但它不兼容部分主流浏览器，比如 Safari、Firefox。  
@@ -411,6 +421,7 @@ tiltStreamController.add(
 [在线示例]: https://amoshuke.github.io/flutter_tilt_book
 [迁移指南]: https://github.com/fluttercandies/flutter_tilt/blob/main/guides/migration_guide.md
 [flutter_tilt/example]: https://github.com/fluttercandies/flutter_tilt/tree/main/example
+[传感器兼容]: #传感器兼容-
 [Tilt widget 参数]: #tilt-widget-参数-
 [TiltParallax widget 参数]: #tiltparallax-widget-参数-
 [ChildLayout]: #childlayout-

README.md

@@ -55,11 +55,13 @@ Check out the [Live Demo][].
 
   - [Versions compatibility](#versions-compatibility-)
 
+  - [Platforms compatibility](#platforms-compatibility-)
+
   - [Add package](#add-package-)
 
-- [Sensors compatibility](#sensors-compatibility-)
+- [Sensors compatibility][]
 
-- [Gesture priority](#gesture-priority-)
+- [Gestures priority](#gestures-priority-)
 
 - [Simple usage](#simple-usage-)
 
@@ -100,7 +102,7 @@ Check out the [Live Demo][].
 - 🔦 Light effect
 - 💡 Shadow effect
 - 👀 Parallax effect
-- 📱 Gyroscope sensor support ([Sensors compatibility](#sensors-compatibility-))
+- 📱 Gyroscope sensor support ([Sensors compatibility][])
 - 🧱 Multiple layouts
 - 👇 Supports hover, touch and sensors events
 - 🖼️ Smooth animation
@@ -117,6 +119,13 @@ Check out the [Live Demo][].
 | flutter_tilt 1.0.0+ |    ✅    |    ❌    |    ❌    |  
 
 
+### Platforms compatibility 📱  
+
+| Android |  iOS  |  Web  | macOS | Windows | Linux |  
+| :-----: | :---: | :---: | :---: | :-----: | :---: |  
+|   ✅   |   ✅  |  ✅   |  ✅  |   ✅   |  ✅   |  
+
+
 ### Add package 📦  
 
 Run this command with Flutter,  
@@ -133,20 +142,21 @@ dependencies:
 ```
 
 
-## Sensors compatibility 📱
+## Sensors compatibility 📱  
 
-Sensors are triggered only on these platforms.
+Sensors will only trigger on these platforms.  
+Platforms without sensors support do not affect the normal use of other features.  
 
-| Android |  iOS  |                        Web (HTTPS)                       | macOS | Linux | Windows |  
-| :-----: | :---: | :------------------------------------------------------: | :---: | :---: | :-----: |  
-|   ✅   |   ✅  | [Browser compatibility][Gyroscope Browser compatibility] |  ❌  |   ❌  |   ❌   |  
+| Android |  iOS  |                        Web (HTTPS)                       | macOS | Windows | Linux |  
+| :-----: | :---: | :------------------------------------------------------: | :---: | :-----: | :---: |  
+|   ✅   |   ✅  | [Browser compatibility][Gyroscope Browser compatibility] |  ❌  |   ❌    |  ❌  |  
 
 > [!NOTE]  
 > Currently Web uses the [Sensor API - Gyroscope], but it is not compatible with some of the major browsers, such as Safari, Firefox.  
 <!-- > After that maybe replace it with [DeviceMotionEvent][]. -->
 
 
-## Gesture priority 📱
+## Gestures priority 📱
 
 When multiple gestures are enabled, they are triggered based on priority:
 
@@ -411,6 +421,7 @@ Open sourced under the MIT license.
 [Live Demo]: https://amoshuke.github.io/flutter_tilt_book
 [Migration Guide]: https://github.com/fluttercandies/flutter_tilt/blob/main/guides/migration_guide.md
 [flutter_tilt/example]: https://github.com/fluttercandies/flutter_tilt/tree/main/example
+[Sensors compatibility]: #sensors-compatibility-
 [Tilt widget parameters]: #tilt-widget-parameters-
 [TiltParallax widget parameters]: #tiltparallax-widget-parameters-
 [ChildLayout]: #childlayout-

example/android/app/build.gradle

@@ -8,7 +8,7 @@ plugins {
 android {
     namespace = "com.example.example"
     compileSdk = flutter.compileSdkVersion
-    ndkVersion = flutter.ndkVersion
+    ndkVersion = "25.1.8937393" // flutter.ndkVersion
 
     compileOptions {
         sourceCompatibility = JavaVersion.VERSION_1_8

example/android/gradle/wrapper/gradle-wrapper.properties

@@ -2,4 +2,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip

example/android/settings.gradle

@@ -18,7 +18,7 @@ pluginManagement {
 
 plugins {
     id "dev.flutter.flutter-plugin-loader" version "1.0.0"
-    id "com.android.application" version "7.3.0" apply false
+    id "com.android.application" version "8.3.2" apply false
     id "org.jetbrains.kotlin.android" version "1.7.10" apply false
 }
 

lib/flutter_tilt.dart

@@ -1,5 +1,7 @@
 /// Easily apply tilt parallax hover effects for Flutter,
 /// which supports tilt, light, shadow effects, gyroscope sensors and many custom parameters.
+
+// ignore: unnecessary_library_name
 library flutter_tilt;
 
 export 'src/config/tilt_config.dart';

pubspec.yaml

@@ -28,7 +28,7 @@ dependencies:
   flutter:
     sdk: flutter
   stream_transform: ^2.1.0
-  sensors_plus: ^6.0.0
+  sensors_plus: ^6.1.0
 
 dev_dependencies:
   flutter_test: