flutter_opencode_client/BUILD_GUIDE.md

构建指南

环境要求

• Flutter SDK 3.29+
• Dart 3.11+
• Android SDK
• Java 17+

快速开始

1. 安装 Flutter

# 下载 Flutter SDK
cd /tmp
curl -o flutter_linux.tar.xz "https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.29.0-stable.tar.xz"

# 解压到 /opt
sudo tar -xf flutter_linux.tar.xz -C /opt

# 添加 PATH
export PATH="$PATH:/opt/flutter/bin"

# 验证安装
flutter doctor

2. 配置 Android SDK

确保已安装 Android SDK 并设置 ANDROID_HOME 环境变量：

export ANDROID_HOME=/path/to/android-sdk
export PATH="$PATH:$ANDROID_HOME/cmdline-tools/latest/bin"
export PATH="$PATH:$ANDROID_HOME/platform-tools"

3. 项目设置

# 进入项目目录
cd flutter_openclaw_client

# 获取依赖
flutter pub get

# 运行代码生成 (如果需要)
dart run build_runner build --delete-conflicting-outputs

4. 构建 APK

Debug 版本

flutter build apk --debug

Release 版本

flutter build apk --release

输出路径: build/app/outputs/flutter-apk/app-release.apk

指定 ABI

# 仅构建 arm64
flutter build apk --release --target-platform android-arm64

# 构建多个 ABI
flutter build apk --release --target-platform android-arm,android-arm64,android-x64

5. 构建 App Bundle (Google Play)

flutter build appbundle --release

输出路径: build/app/outputs/bundle/release/app-release.aab

项目结构

flutter_openclaw_client/
├── android/          # Android 平台代码
├── ios/             # iOS 平台代码
├── lib/             # Dart 主代码
├── linux/           # Linux 平台代码
├── macos/           # macOS 平台代码
├── packages/        # 本地依赖包
├── test/            # 测试代码
├── windows/         # Windows 平台代码
├── pubspec.yaml     # 依赖配置
└── build_apk.sh     # 构建脚本

签名配置

项目已配置调试签名密钥：android/app/debug.keystore

如需使用正式签名，修改 android/key.properties：

storeFile=/path/to/your/keystore.jks
storePassword=your_store_password
keyAlias=your_key_alias
keyPassword=your_key_password

常见问题

Flutter 命令未找到

确保已将 Flutter bin 目录添加到 PATH。

构建失败 - 缺少依赖

运行 flutter pub get 获取依赖。

构建失败 - 代码生成问题

运行 dart run build_runner build --delete-conflicting-outputs。

Android SDK 未找到

运行 flutter doctor 检查环境配置。

一键构建

使用提供的构建脚本：

./build_apk.sh