Flutter-OH 3.35.7 开发技巧&仓库拉取指南
Flutter-OH 3.35.7 现已正式更新，其适配 OpenHarmony 的开发分支 oh-3.35.7-dev 处于持续迭代状态，会每日进行 bug 修复与功能优化。不管你是刚配置好该版本环境，还是已经在基于它开发，这里分享一套实用的环境检查、版本验证技巧，同时附上仓库的完整拉取步骤，帮大家高效使用最新版本开发。
一、已配置环境：检查与版本验证
若你已经拉取过仓库并配置好 Flutter-OH 3.35.7 环境，每次开发前可通过以下步骤检查环境状态、确认版本是否为最新，避免因版本滞后遇到已修复的问题。
1. 拉取最新代码，同步仓库更新
进入本地 flutter_flutter 仓库目录，执行 git pull 拉取 oh-3.35.7-dev 分支的最新代码，终端会显示代码同步的详细日志（含文件变更、版本迭代信息）：
git pull
remote: Enumerating objects: 106, done.
remote: Counting objects: 100% (65/65), done.
remote: Compressing objects: 100% (57/57), done.
remote: Total 106 (delta 19), reused 4 (delta 3), pack-reused 41 (from 1)
Receiving objects: 100% (106/106), 99.81 KiB | 1.81 MiB/s, done.
Resolving deltas: 100% (25/25), completed with 2 local objects.
From gitcode.com:openharmony-tpc/flutter_flutter
b15356702b..419a77c140 oh-3.35.7-dev -> origin/oh-3.35.7-dev
c32b189588..861551e934 3.22.0-ohos -> origin/3.22.0-ohos
56cf6e29b2..c9aed89bdf 3.22.0-ohos-release -> origin/3.22.0-ohos-release
c63b40bce0..6313b0cffd dev -> origin/dev
ea2820a86a..0b72369f35 oh-3.27.0-release -> origin/oh-3.27.0-release
c18a193ae8..1d693d1c5b oh-3.27.4-dev -> origin/oh-3.27.4-dev
c06e970add..9a658da965 oh-3.32.4-dev -> origin/oh-3.32.4-dev
* [new tag] 3.22.1-ohos-1.0.9 -> 3.22.1-ohos-1.0.9
* [new tag] 3.27.5-ohos-1.0.3 -> 3.27.5-ohos-1.0.3
Updating b15356702b..419a77c140
Fast-forward
bin/internal/engine.ohos.har.version | 2 +-
bin/internal/engine.ohos.version | 2 +-
engine/src/flutter/shell/platform/ohos/background_resource_cleanup.h | 95 +++++++++++++++++++++++++++++++++++++++++++++
engine/src/flutter/shell/platform/ohos/napi/platform_view_ohos_napi.cpp | 6 ++-
engine/src/flutter/shell/platform/ohos/ohos_surface_gl_skia.cpp | 60 ++++++++++++++++++++++++----
engine/src/flutter/shell/platform/ohos/platform_view_ohos.cpp | 286 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
engine/src/flutter/shell/platform/ohos/platform_view_ohos.h | 101 ++++++++++++++++++++++++++++++++++++++++++++++-
7 files changed, 539 insertions(+), 13 deletions(-)
create mode 100644 engine/src/flutter/shell/platform/ohos/background_resource_cleanup.h
2. 检查环境完整性
执行 flutter doctor -v 检查本地 Flutter-OH 环境的依赖、工具链、设备连接等状态，确认无关键异常（非核心问题如Xcode/CocoaPods可忽略，不影响OpenHarmony开发）：
flutter doctor -v
示例输出（已同步最新代码的正常状态）：
Downloading Darwin arm64 Dart SDK from Flutter engine b15356702b41d3bd6a857d588ab21e85e54c174a...
dart-sdk-url: https://flutter-ohos.obs.cn-south-1.myhuaweicloud.com/flutter_infra_release/flutter/b15356702b41d3bd6a857d588ab21e85e54c174a/dart-sdk-darwin-arm64.zip
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 197M 100 197M 0 0 32.3M 0 0:00:06 0:00:06 --:--:-- 35.4M
Building flutter tool...
Resolving dependencies...
Downloading packages...
Got dependencies.
Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source!
Downloading darwin-arm64 tools... 1,108ms
[!] Flutter (Channel [user-branch], 3.35.8-ohos-0.0.1-canary1, on macOS 15.2 24C103 darwin-arm64, locale zh-Hans-CN) [730ms]
! Flutter version 3.35.8-ohos-0.0.1-canary1 on channel [user-branch] at /Users/jianguo/Desktop/harmony/flutter/flutter_flutter
Currently on an unknown channel. Run `flutter channel` to switch to an official channel.
If that doesn't fix the issue, reinstall Flutter by following instructions at https://flutter.dev/setup.
• Upstream repository git@gitcode.com:openharmony-tpc/flutter_flutter.git
• FLUTTER_GIT_URL = git@gitcode.com:openharmony-tpc/flutter_flutter.git
• Framework revision 419a77c140 (23 minutes ago), 2026-01-23 09:50:03 +0800
• Engine revision 035316565a
• Dart version 3.9.2
• DevTools version 2.48.0
• Pub download mirror https://pub.flutter-io.cn
• Flutter download mirror https://storage.flutter-io.cn
• Feature flags: enable-ohos, enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop, enable-android, enable-ios, cli-animations, enable-native-assets, enable-lldb-debugging
• If those were intentional, you can disregard the above warnings; however it is recommended to use "git" directly to perform update checks and upgrades.
[✓] HarmonyOS toolchain - develop for HarmonyOS devices
• OpenHarmony Sdk at /Users/jianguo/Library/OpenHarmony/Sdk, available api versions has [20:20]
• Ohpm version 6.0.1
• Node version v23.11.0
• Hvigorw binary at /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw
[✓] Android toolchain - develop for Android devices (Android SDK version 36.1.0-rc1) [5.7s]
• Android SDK at /Users/jianguo/Library/Android/sdk
• Emulator version unknown
• Platform android-36, build-tools 36.1.0-rc1
• Java binary at: /Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/java
This is the JDK bundled with the latest Android Studio installation on this machine.
To manually set the JDK path, use: `flutter config --jdk-dir="path/to/jdk"`.
• Java version OpenJDK Runtime Environment (build 21.0.6+-13391695-b895.109)
• All Android licenses accepted.
[!] Xcode - develop for iOS and macOS (Xcode 16.3) [820ms]
• Xcode at /Applications/Xcode.app/Contents/Developer
• Build 16E140
✗ Unable to get list of installed Simulator runtimes.
✗ CocoaPods not installed.
CocoaPods is a package manager for iOS or macOS platform code.
Without CocoaPods, plugins will not work on iOS or macOS.
For more info, see https://flutter.dev/to/platform-plugins
For installation instructions, see https://guides.cocoapods.org/using/getting-started.html#installation
[✓] Chrome - develop for the web [51ms]
• Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
[✓] Android Studio (version 2025.1) [51ms]
• Android Studio at /Applications/Android Studio.app/Contents
• Flutter plugin can be installed from:
🔨 https://plugins.jetbrains.com/plugin/9212-flutter
• Dart plugin can be installed from:
🔨 https://plugins.jetbrains.com/plugin/6351-dart
• Java version OpenJDK Runtime Environment (build 21.0.6+-13391695-b895.109)
[✓] VS Code (version 1.106.3) [50ms]
• VS Code at /Applications/Visual Studio Code.app/Contents
• Flutter extension can be installed from:
🔨 https://marketplace.visualstudio.com/items?itemName=Dart-Code.flutter
[✓] Connected device (2 available) [9.8s]
• macOS (desktop) • macos • darwin-arm64 • macOS 15.2 24C103 darwin-arm64
• Chrome (web) • chrome • web-javascript • Google Chrome 144.0.7559.61
[✓] Network resources [2.3s]
• All expected network resources are available.
! Doctor found issues in 2 categories.
3. 确认当前Flutter-OH版本
执行 flutter --version 查看当前使用的版本号，确认已同步到仓库最新版本：
flutter --version
示例输出（最新迭代版本）：
Flutter 3.35.8-ohos-0.0.1-canary1 • channel [user-branch] • git@gitcode.com:openharmony-tpc/flutter_flutter.git
Framework • revision 419a77c140 (65 minutes ago) • 2026-01-23 09:50:03 +0800
Engine • hash 6b24e1b529bc46df7ff397667502719a2a8b6b72 (revision 035316565a) (3 months ago) • 2025-10-21 14:28:01.000Z
Tools • Dart 3.9.2 • DevTools 2.48.0
二、全新配置：拉取OpenHarmony版Flutter仓库
若你还未拉取过 Flutter-OH 3.35.7 对应的仓库，可通过以下步骤直接拉取 oh-3.35.7-dev 分支代码，全程无需登录AtomGit，公开仓库可直接访问。
1. 切换本地存放目录
打开终端（Windows用PowerShell、Mac/Linux用Terminal），切换到你想要存放仓库的目录（示例为桌面，可根据自身需求修改）：
# Windows（PowerShell）
cd C:\Users\你的用户名\Desktop
# Mac/Linux
cd ~/Desktop
2. 克隆指定分支仓库
执行以下Git命令，直接拉取 oh-3.35.7-dev 分支（避免拉取默认分支导致版本不符）：
git clone -b oh-3.35.7-dev https://atomgit.com/openharmony-tpc/flutter_flutter.git
命令简单说明：
clone：将远程仓库完整克隆到本地；-b oh-3.35.7-dev：指定克隆的目标分支；- 后续URL为官方AtomGit仓库地址，确保代码来源可靠。
3. 验证拉取结果
克隆完成后，本地目标目录会生成 flutter_flutter 文件夹，进入该文件夹并检查当前分支，确认拉取无误：
# 进入仓库目录
cd flutter_flutter
# 查看当前分支
git branch
终端输出 * oh-3.35.7-dev 即表示拉取成功，当前已处于正确的开发分支。
三、开发必备：定期同步最新代码
由于 oh-3.35.7-dev 是开发分支，官方会每日进行bug修复、问题优化，为了避免开发中遇到已解决的问题，建议大家每次开发前/定期在 flutter_flutter 目录下执行以下命令，同步仓库最新更新：
git pull
同步完成后，即可基于最新的Flutter-OH 3.35.7版本进行OpenHarmony相关开发，保证开发环境的稳定性。
拉取并配置好最新环境后，即可正常进行Flutter-OH的开发工作，祝大家开发顺利！
