Flutter for OpenHarmony 环境配置学习笔记
=====================================

一、环境配置概览
             

1. Flutter SDK 安装
     使用 OpenHarmony 定制版 Flutter
     通过 Git 克隆官方仓库：
     git clone https://gitcode.com/openharmony tpc/flutter_flutter.git
     版本信息：Flutter 3.27.5 ohos 1.0.1

2. 环境变量配置
     系统 PATH 包含：
       Java JDK 17: C:\Program Files\Java\jdk 17\bin
       OpenHarmony SDK: D:\DevEco\DevEco Studio\sdk\default\openharmony\toolchains
       Ohpm 包管理器: D:\DevEco\DevEco Studio\tools\ohpm\bin
       Node.js: D:\DevEco\DevEco Studio\tools\node
       Hvigor 构建工具: D:\DevEco\DevEco Studio\tools\hvigor\bin

     重要环境变量：
       DEVECO_SDK_HOME: D:\DevEco\DevEco Studio\sdk
       FLUTTER_STORAGE_BASE_URL: https://storage.flutter io.cn

3. 依赖工具版本
     OpenHarmony SDK: API 20 (default)
     Ohpm: 5.3.2 (包管理器)
     Node.js: v24.11.1
     Java: JDK 17
     Dart: 3.6.2

二、项目创建与构建
               

1. 创建项目注意事项
     包名规范：
       必须使用小写字母、数字和下划线
       不能以数字开头
       不能使用保留字
       正确示例：firstflutter, my_app
       错误示例：FirstFlutter（首字母大写）

     创建命令：
     flutter create   platforms ohos flutter_harmonyos

2. 构建发布版本
     命令：flutter build app   release
     自动从镜像源下载工具和依赖

三、常见问题与解决方案
                 

1. 签名配置问题
     问题：构建时提示需要配置调试签名
     解决方案：
       通过 DevEco Studio 打开 ohos 工程
       进入 File → Project Structure → Signing Configs
       勾选 "Automatically generate signature"

2. 包名规范错误
     问题："FirstFlutter" is not a valid Dart package name
     解决：使用全小写的包名，如 firstflutter

3. 工具下载
     Flutter 工具会自动从镜像源下载
     确保网络连接稳定
     信任镜像源：https://storage.flutter io.cn

四、目录结构说明
             

D:\Flutter\flutter_harmonyos\    # Flutter 项目目录
D:\DevEco\DevEco Studio\sdk\     # OpenHarmony SDK
D:\DevEco\DevEco Studio\tools\   # 开发工具

五、验证环境配置
             

使用以下命令验证环境：
flutter   version
flutter doctor

六、启动模拟器

七、注意事项
         

1. 确保所有路径配置正确
2. 使用 OpenHarmony 定制的 Flutter 版本
3. 项目创建时注意包名规范
4. 发布前配置好签名信息
5. 确保网络通畅，能够从镜像源下载依赖