# 编译环境说明

> 适用命令：`flutter build apk --flavor universalDev --dart-define=ENV=dev --target-platform android-arm,android-arm64 --release`
> 记录时间：2026-06-03

## Flutter / Dart

| 工具 | 版本 |
|---|---|
| Flutter | 3.44.0 (stable) |
| Dart | 3.12.0 |
| DevTools | 2.57.0 |

## Android 构建工具

| 工具 | 版本 | 来源 |
|---|---|---|
| AGP (Android Gradle Plugin) | 8.9.1 | android/settings.gradle.kts |
| Gradle | 9.5.1 | 本机安装 |
| compileSdk | android-36 | Flutter 默认值 |
| targetSdk | 36 | Flutter 默认值 |
| minSdk | 24 | Flutter 默认值 |
| Build Tools | 36.1.0-rc1 | Android SDK 当前激活版本 |
| NDK | 28.2.13676358 | FlutterExtension 默认值（`flutter.ndkVersion`） |
| Android SDK 路径 | /Users/nsdm/Library/Android/sdk | local.properties |

## Java / Kotlin

| 工具 | 版本 | 说明 |
|---|---|---|
| JDK（编译用） | OpenJDK 21.0.10 | Android Studio 内置 JBR，Flutter 优先使用 |
| JDK（系统默认） | OpenJDK 21.0.11 (Temurin) | 终端 `java -version`，Flutter 编译不使用 |
| Kotlin | 2.1.0 | android/settings.gradle.kts |
| Java 源码兼容性 | VERSION_11 | app/build.gradle.kts `compileOptions` |

## 目标架构

| ABI | 说明 |
|---|---|
| armeabi-v7a | `--target-platform android-arm` |
| arm64-v8a | `--target-platform android-arm64` |

## Flavor 配置

| Flavor | applicationId | app_name | CHANNEL |
|---|---|---|---|
| universalDev | com.flashlink.vpn.dev | flashlink Dev | universal |
| universalProd | com.flashlink.vpn | flashlink | universal |
| googleDev | com.flashlink.vpn.dev | flashlink Dev | google |
| googleProd | com.flashlink.vpn | flashlink | google |

## 注意事项

- Flutter 编译时使用的是 Android Studio 内置 JBR（21.0.10），而非终端默认的 Temurin（21.0.11）。如需固定 JDK，执行：

  ```bash
  flutter config --jdk-dir="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
  ```

- `release` 构建依赖 `android/key.properties` 中的签名配置，文件不存在时自动回退到 debug 签名。
- `isShrinkResources = false` / `isMinifyEnabled = false`，release 包未开启代码/资源压缩。

签名信息：
您的名字與姓氏為何？
  [Unknown]:  BRETT S GREENBERG
您的組織單位名稱為何？
  [Unknown]:  FlashLink LLC
您的組織名稱為何？
  [Unknown]:  FlashLink
您所在的城市或地區名稱為何？
  [Unknown]:  Los Angeles
您所在的州及省份名稱為何？
  [Unknown]:  CA
此單位的兩個字母國別代碼為何？
  [Unknown]:  US