# Technology Stack

**Analysis Date:** 2026-03-30

## Languages

**Primary:**
- Dart 3.9.0+ - Flutter 插件层代码（`lib/*.dart`）
- Java 11 - Android 原生实现（`android/src/main/java/**/*.java`）

**Secondary:**
- Kotlin - 未使用（纯 Java 实现）
- C/C++ (Native) - 虹软 SDK native 库（`libarcsoft_face.so`, `libarcsoft_face_engine.so`, `libarcsoft_image_util.so`）

## Runtime

**Environment:**
- Flutter SDK 3.18.0+ (stable channel)
- Dart SDK 3.9.0+ (<4.0.0)
- Android SDK compileSdk 36, minSdk 24

**Package Manager:**
- pub (Flutter/Dart 包管理器)
- Gradle 8.9.1 (Android 构建)
- Lockfile: `pubspec.lock` (present), `pubspec.yaml` (present)

## Frameworks

**Core:**
- Flutter SDK - 跨平台移动应用框架
- Flutter Plugin Architecture - 平台通道通信机制

**Testing:**
- flutter_test - Flutter 单元测试框架
- flutter_lints 5.0.0 - Dart/Flutter 代码规范检查
- JUnit 4.13.2 - Java 单元测试
- Mockito 5.0.0 - Java mock 测试框架

**Build/Dev:**
- Gradle 8.9.1 - Android 构建系统
- Android Gradle Plugin 8.9.1 - Android 构建插件
- Flutter CLI - Flutter 命令行工具

## Key Dependencies

**Critical:**
- `plugin_platform_interface` 2.0.2 - Flutter 插件平台接口抽象层
- `arcsoft_face.jar` - 虹软人脸识别核心 SDK
- `arcsoft_image_util.jar` - 虹软图像处理工具库
- `libarcsoft_face.so` (~87MB) - 虹软人脸识别 native 库（arm64-v8a）
- `libarcsoft_face_engine.so` (~1.3MB) - 虹软人脸引擎 native 库
- `libarcsoft_image_util.so` (~80KB) - 虹软图像处理 native 库

**Infrastructure (Example App):**
- `camera` 0.11.1 - 摄像头访问插件（用于实时人脸检测）
- `cupertino_icons` 1.0.8 - iOS 风格图标

## Configuration

**Environment:**
- Dart SDK 版本约束: `^3.9.0`（`pubspec.yaml`）
- Flutter SDK 版本约束: `>=3.3.0`（`pubspec.yaml`）
- Java 版本: 11（`android/build.gradle`）
- Pub 仓库源: `https://pub.flutter-io.cn`（中国镜像）

**Build:**
- `pubspec.yaml` - Dart/Flutter 包配置
- `pubspec.lock` - 依赖锁定文件
- `analysis_options.yaml` - Dart 代码分析配置（继承 flutter_lints）
- `android/build.gradle` - Android 构建配置
- `android/settings.gradle` - Android 项目设置

## Platform Requirements

**Development:**
- Flutter SDK 3.18.0+ 安装
- Dart SDK 3.9.0+ 安装
- Android Studio / Android SDK（compileSdk 36）
- JDK 11

**Production:**
- Android 设备（API 24+，即 Android 7.0+）
- ARM64-v8a 或 armeabi-v7a 架构支持
- 摄像头权限（用于人脸检测）
- 虹软 SDK 有效激活（AppId、SdkKey、ActiveKey）

## Architecture Support

**Native Libraries:**
- `arm64-v8a` - 64位 ARM 设备（主流现代设备）
- `armeabi-v7a` - 32位 ARM 设备（兼容旧设备）

**SDK 功能掩码常量:**
```java
ASF_FACE_DETECT = 0x00000001      // 人脸检测
ASF_FACE_RECOGNITION = 0x00000004 // 人脸特征
ASF_AGE = 0x00000008              // 年龄检测
ASF_GENDER = 0x00000010           // 性别检测
ASF_LIVENESS = 0x00000080         // RGB 活体检测
ASF_IMAGEQUALITY = 0x00000200     // 图像质量检测
ASF_MASK_DETECT = 0x00001000      // 口罩检测
ASF_UPDATE_FACEDATA = 0x00002000  // 人脸信息更新
```

**默认功能掩码:** 0x85 = 人脸检测 + 人脸特征 + RGB活体检测

---

*Stack analysis: 2026-03-30*