Dynamic Theme 支持多语言切换（Flutter 3.10.x, Java 17）

项目中配置了 org.gradle.java.home，用于指定本工程 Android 构建时使用的 JDK 路径。这样做的原因：

• 与系统 JDK 解耦：本机可能装有多套 JDK（如 8、11、17），默认 JAVA_HOME 或 java 可能指向其它版本。Gradle 会优先使用 org.gradle.java.home，确保执行 Gradle、AGP、Kotlin 编译时统一用 Java 17，避免因版本不一致导致的构建失败。
• 满足 AGP 8.x 要求：Android Gradle Plugin 8.x 要求 Java 17，显式指定可避免误用 Java 11 等旧版本。
• 团队协作：该路径是本机路径（如 /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home），其他人拉代码后若 JDK 安装位置不同，需要改成自己机器上的 JDK 17 路径，或删除/注释该行，改用环境变量 JAVA_HOME。

若你使用 Java 17 且已设置 JAVA_HOME，也可以不配置 org.gradle.java.home，Gradle 会使用 JAVA_HOME。

项目当前使用 Java 17。若你本机使用不同 Java 版本，可按以下方式配置：

1. 使用 Java 17（推荐，与项目一致）

   • 安装 JDK 17（如 Zulu OpenJDK 17 或 Oracle JDK 17）。
   • 设置环境变量（以 macOS/Linux 为例）：

     export JAVA_HOME=/path/to/jdk-17   # 替换为你的 JDK 17 路径
     export PATH="$JAVA_HOME/bin:$PATH"

   • 验证：java -version 应显示 17.x。

2. 修改项目以使用其他 Java 版本（如 Java 11 或 21）

   • 编辑 android/app/build.gradle：

     android {
         compileOptions {
             sourceCompatibility JavaVersion.VERSION_17   // 改为 VERSION_11 或 VERSION_21
             targetCompatibility JavaVersion.VERSION_17
         }
         kotlinOptions {
             jvmTarget = '17'   // 改为 '11' 或 '21'
         }
     }

   • 若 android/gradle.properties 里配置了 org.gradle.java.home，需改为目标 JDK 的安装路径，或删除该行改用环境变量。
   • 注意：AGP 8.x 官方要求 Java 17，若降级到 Java 11 需同时降级 AGP（如改为 7.x），在 android/settings.gradle 中修改 com.android.application 版本并对应调整 Gradle 版本。

3. 多版本 Java 共存（如通过 asdf、jenv、sdkman）

   • 在项目目录下使用对应工具切换到 JDK 17，例如：

     # jenv 示例
     jenv local 17
     # 或 asdf
     asdf local java openjdk-17.0.x

   • 确保 JAVA_HOME 与 java -version 一致。

cd ios && pod install && cd ..
flutter run

若遇到 CocoaPods 或 Xcode 签名问题，请确保：

• 已用 Xcode 打开过 ios/Runner.xcworkspace 并选择开发团队（Signing & Capabilities）。
• 模拟器或真机的系统版本 ≥ iOS 12.0。

# Flutter
Flutter 3.10.6 • channel stable • https://github.com/flutter/flutter.git
Framework • revision f468f3366c (9 months ago) • 2023-07-12 15:19:05 -0700
Engine • revision cdbeda788a
Tools • Dart 3.0.6 • DevTools 2.23.1

# Java（建议与项目一致使用 17）
openjdk version "17.x.x" ...

flutter build apk --release --target-platform android-arm64,android-arm

项目已做以下优化以减小 release APK 体积：

• 资源：仅打包运行时需要的资源（assets/icons/、assets/images/、network_image.json、city_list.json），不包含 assets/preview/ 等文档用资源。
• Android：已开启 R8 代码压缩与资源收缩（minifyEnabled true、shrinkResources true），规则见 android/app/proguard-rules.pro。

如需进一步减小体积，可：

1. Dart 混淆并剥离调试信息（发布时建议）：

   flutter build apk --release --obfuscate --split-debug-info=./debug-info/

2. 上架 Google Play 时使用 App Bundle（按设备生成更小 APK）：

   flutter build appbundle --release --obfuscate --split-debug-info=./debug-info/

flutter drive --target=test_driver/app.dart

# 普通 release
flutter build apk --release

# 体积优化（混淆 + 剥离调试信息）
flutter build apk --release --obfuscate --split-debug-info=./debug-info/

flutter run --profile --trace-skia
flutter screenshot --type=skia --observatory-uri=http://127.0.0.1:49368/s4vbW7Mp_KE=/#/timeline

Flutter 中，RouteAware 是一个 widget mixin，用于监听路由的推送和弹出事件。这使得 widget 能够知道它们何时被显示或隐藏，例如当用户导航到一个页面或从一个页面返回时。这对于跟踪页面视图或执行在页面进入或离开屏幕时的操作特别有用。

RouteAware 需要和 RouteObserver 一起使用，后者是一个监听 Navigator 路由堆栈变化的类。你需要在全局范围内创建一个 RouteObserver 并在整个应用中使用它，这样 RouteAware mixin 的 widgets 才能注册到观察者并接收路由变化的通知。

class _NewViewState extends State<NewView> with RouteAware {
  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    App.routeObserver.subscribe(this, ModalRoute.of(context) as PageRoute<dynamic>);
    debugPrint("$this");
  }

  @override
  void didPopNext() {
    // Covering route was popped off the navigator.
    debugPrint('返回NewView');
  }

  @override
  void didPush() {
    // Route was pushed onto navigator and is now topmost route.
    debugPrint('进入NewView');
  }

  @override
  void dispose() {
    App.routeObserver.unsubscribe(this);
    super.dispose();
  }
}

Navigator.of(context).pushNamed 直接进入新页面(每次都将新建一个新的页面)

Navigator.of(context).pushReplacementNamed 把当前页面在栈中的位置替换成跳转的页面（替换导航器的当前路由，通过推送路由[routeName]），当新的页面进入后，之前的页面将执行dispose方法

Navigator.of(context).popAndPushNamed 将当前页面pop，然后跳转到制定页面（将当前路由弹出导航器，并将命名路由推到它的位置

Navigator.of(context).pushNamedAndRemoveUntil 将制定的页面加入到路由中，然后将其他所有的页面全部pop, (Route route) => false将确保删除推送路线之前的所有路线。 这时候将打开一个新页面

例如 当用户点击了退出登录时，我们需要进入某一个页面（比如点退出登录后进入了登录页），这个时候用户点击返回时不应该能进入任何一个页面，这种情况就可以使用

Navigator.of(context).pushNamedAndRemoveUntil('/', (Route<dynamic> route) => false);

Navigator.of(context).pushNamedAndRemoveUntil 将指定的页面加入到路由中，然后将之前的路径移除直到指定的页面为止（将具有给定名称的路由推到导航器上，然后删除所有路径前面的路由直到'predicate'返回true为止。） 这时候将销毁栈内除了screen4的页面，点击直接去栈内screen4，这时screen4会重新build

Navigator.of(context).pushNamedAndRemoveUntil('/screen4', ModalRoute.withName('/screen1'));

Navigator.of(context).popUntil推出之前push的路由直到/newView路由为止

Navigator.of(context).popUntil(ModalRoute.withName('/newView'))

  Navigator.pushAndRemoveUntil(
  context,
  MaterialPageRoute(builder: (BuildContext context) => new  screen4()),
  ModalRoute.withName('/'),

  Navigator.popUntil(context, ModalRoute.withName('/screen2'));

UrlConfig.of().url

class CustomBehavior extends ScrollBehavior {
  @override
  Widget buildOverscrollIndicator(BuildContext context, Widget child, ScrollableDetails details) {
    return child;
  }
}

ScrollConfiguration(
        behavior: CustomBehavior(),
        child: ListView.builder(
          itemCount: 60,
          itemBuilder: (BuildContext context, int index) {
            return Container(
              height: 44.0,
              width: MediaQuery.of(context).size.width,
              child: Center(child: Text('Data-$index')),
            );
          },
        ),
      )

final bool isDark = Theme.of(context).brightness == Brightness.dark;

CustomColors.of(context).borderColor

maybePop 会自动进行判断，如果当前页面pop后，会显示其他页面，不会出现问题，则将执行当前页面的pop操作 否则将不执行

Navigator.of(context, rootNavigator: true).maybePop();

flutter_driver 说明文档