Windows 系统手动安装 Flutter 环境

✅ 一、准备条件

• Git for Windows
• Android Studio
• Flutter插件

安卓sdk：

✅ 二、安装 Flutter SDK

1. 下载 Flutter

• 下载地址：https://docs.flutter.dev/install/manual

2. 解压

解压到路径，例如：

C:\flutter

3. 配置环境变量

将以下路径添加到系统环境变量 Path 中：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\flutter\bin", "Machine")

然后重启终端（powershell）。

✅ 三、验证安装

flutter doctor --android-licenses

一路输入y直到完成

检查是否识别出所有组件并显示 ✅。

✅ 四、创建和构建项目

1. 创建多平台项目

flutter create myapp --org io.github.name --platforms android,ios,windows,macos,linux

2. 构建 APK

flutter build apk --release

输出文件路径：

build\app\outputs\flutter-apk\app-release.apk

Flutter 常用命令

Docker构建安卓项目参考

services:
  android:
    image: mingc/android-build-box
    container_name: android
    working_dir: /workspace
    stdin_open: true
    tty: true
    volumes:
      - .:/workspace
      - ./gradle-cache:/root/.gradle
      - ./flutter-cache:/root/.pub-cache

• 启动：

docker compose up -d

• 进入：

docker exec -it android bash

• 启动后先检查一下环境：

java -version
gradle -v
flutter --version
sdkmanager --version
adb version

• 然后随便执行：

# Kotlin
./gradlew assembleDebug
./gradlew assembleRelease

# Flutter
flutter doctor -v
flutter pub get
flutter build apk --release

# Android SDK
sdkmanager --list
adb version

🤖Go 项目生成 Android SDK (AAR) 并在 Kotlin 调用

1. 安装 gomobile

go install golang.org/x/mobile/cmd/gomobile@latest
go install golang.org/x/mobile/cmd/gobind@latest
gomobile init

2. 编写 Go 库

• 导出函数首字母必须大写
• 一般只需暴露 Go 项目的启动、停止、重启、日志、生命周期等函数接口即可
• gomobile 生成 Android 绑定后，业务端需要使用小驼峰命名调用
• 默认会生成一个“通用 AAR”，里面会包含所有 Go 支持的多种架构，可在业务端打包时拆分abi

Flutter多平台架构思想

说明：Flutter 负责 UI 和业务编排，Platform Adapter 负责平台差异，Native Core 负责真正运行。

App 启动
↓
初始化依赖注入 / 配置 / 存储
↓
注册当前平台的 RuntimeService
↓
加载 Flutter UI
↓
用户操作 UI
↓
ViewModel 处理状态与交互
↓
UseCase / Repository 执行业务逻辑
↓
调用统一 RuntimeService 接口
↓
Platform Adapter 适配当前平台
↓
调用原生内核
   Android → AAR / .so
   Windows → exe
   Linux → binary
   macOS → binary / framework
   iOS → XCFramework / NetworkExtension
↓
内核回传状态 / 日志 / 错误 / 流量统计
↓
RuntimeService 统一转换为 Dart Model / Stream
↓
ViewModel 更新状态
↓
UI 自动刷新

最简结构

lib/
├── main.dart
├── ui/              # 页面、组件、ViewModel
├── domain/          # Model、UseCase、抽象接口
├── data/            # Repository、Service实现
└── platform/        # Android/Windows/Linux/macOS/iOS 适配器