能否出一个flutter的构建指导

[chuQwQ]

我尝试通过源码构建apk，出现了vte报错，我尝试了多种方法无果

[heckmon]

好的，我会更新 README.md 文件，添加详细的贡献指南，其中包括本地设置。

[heckmon]

不过它应该可以在本地运行，能否告诉我您操作的步骤？另外，如果可以，请将错误日志粘贴到这里，以便我检查问题所在。

[zhengyuliu047-rgb]

环境信息

• Flutter 版本: Flutter 3.41.7 • channel stable • https://gitee.com/mirrors/Flutter.git
  Framework • revision cc0734ac71 (4 days ago) • 2026-04-15 21:21:08 -0700
  Engine • hash 7a53c052bc4b472cf780b199087e1368e4a9aa8c (revision 59aa584fdf) (4 days ago) •
  2026-04-16 02:32:16.000Z
  Tools • Dart 3.11.5 • DevTools 2.54.2
• Dart 版本: Dart SDK version: 3.11.5 (stable) (Wed Apr 15 00:36:32 2026 -0700) on "windows_x64"
• 操作系统: Windows 11
• 项目路径: D:\windc\roxum-ide-playstore-version

完整错误报告

问题描述

使用 ghostty_vte_flutter 包构建 Release APK 时失败，提示找不到 Ghostty VTE 源码。

相关代码

pubspec.yaml

yaml
dependencies:
ghostty_vte_flutter:
git:
url: https://github.com/heckmon/dart_terminal.git
ref: master
path: pkgs/vte/ghostty_vte_flutter

错误日志

PS D:\windc\roxum-ide-playstore-version> flutter build apk
Resolving dependencies...
Downloading packages...
async 2.13.0 (2.13.1 available)
cross_file 0.3.5+1 (0.3.5+2 available)
dbus 0.7.11 (0.7.12 available)
file_picker 10.3.10 (11.0.2 available)
flutter_inappwebview_internal_annotations 1.2.0 (1.3.0 available)
flutter_json 0.0.6 (0.1.0 available)
flutter_plugin_android_lifecycle 2.0.33 (2.0.34 available)
flutter_web_auth_2 5.0.1 (5.0.2 available)
font_awesome_flutter 10.12.0 (11.0.0 available)
lints 6.0.0 (6.1.0 available)
markdown 7.3.0 (7.3.1 available)
meta 1.17.0 (1.18.2 available)
path_provider_android 2.2.22 (2.3.1 available)
path_provider_foundation 2.5.1 (2.6.0 available)
petitparser 7.0.1 (7.0.2 available)
shared_preferences 2.5.4 (2.5.5 available)
shared_preferences_android 2.4.18 (2.4.23 available)
shared_preferences_platform_interface 2.4.1 (2.4.2 available)
source_span 1.10.1 (1.10.2 available)
test_api 0.7.10 (0.7.11 available)
url_launcher_android 6.3.28 (6.3.29 available)
url_launcher_ios 6.3.6 (6.4.1 available)
url_launcher_web 2.4.1 (2.4.2 available)
vector_graphics 1.1.19 (1.1.21 available)
vector_graphics_compiler 1.1.19 (1.2.0 available)
vector_math 2.2.0 (2.3.0 available)
vm_service 15.0.2 (15.1.0 available)
win32 5.15.0 (6.0.1 available)
Got dependencies!
28 packages have newer versions incompatible with dependency constraints.
Try flutter pub outdated for more information.
注: C:\Users\QwQ\AppData\Local\Pub\Cache\hosted\pub.dev\android_intent_plus-6.0.0\android\src\main\java\dev\fluttercommunity\plus\androidintent\MethodCallHandlerImpl.java使用了未经检查或不安全的操作。
注: 有关详细信息, 请使用 -Xlint:unchecked 重新编译。
Unhandled exception:
Bad state: Unable to locate Ghostty source root.
Expected one of:

• $GHOSTTY_SRC

• third_party/ghostty (git submodule)

• an ancestor directory containing build.zig and include/ghostty/vt.h
  #0 _resolveGhosttySourceRoot (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:482:3)
  arm32? #1 _buildFromSource (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:387:23)
  Editor jumps to neighbouring tabs on enter/backspace press #2 main. (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:98:11)
  Struggling to add custom local model #3 build (package:hooks/src/api/build_and_link.dart:191:18)
  Can't edit saved custom model #4 main (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:19:9)
  Github cloning private repository #5 _delayEntrypointInvocation. (dart:isolate-patch/isolate_patch.dart:312:33)
  Implement this to create Android and Flutter projects! #6 _RawReceivePort._handleMessage (dart:isolate-patch/isolate_patch.dart:193:12)

  Building assets for package:ghostty_vte failed.
  build.dart returned with exit code: 255.
  To reproduce run:
  (cd C:\Users\QwQ\AppData\Local\Pub\Cache\hosted\pub.dev\ghostty_vte-0.1.2; D:\windc\flutter\bin\cache\dart-sdk\bin\dart --packages=D:\windc\roxum-ide-playstore-version.dart_tool\package_config.json D:\windc\roxum-ide-playstore-version.dart_tool\hooks_runner\ghostty_vte\29a0df3d1d\hook.dill --config=D:\windc\roxum-ide-playstore-version.dart_tool\hooks_runner\ghostty_vte\29a0df3d1d\input.json )
  stderr:
  Unhandled exception:
  Bad state: Unable to locate Ghostty source root.
  Expected one of:

• $GHOSTTY_SRC

• third_party/ghostty (git submodule)

• an ancestor directory containing build.zig and include/ghostty/vt.h
  #0 _resolveGhosttySourceRoot (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:482:3)
  arm32? #1 _buildFromSource (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:387:23)
  Editor jumps to neighbouring tabs on enter/backspace press #2 main. (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:98:11)
  Struggling to add custom local model #3 build (package:hooks/src/api/build_and_link.dart:191:18)
  Can't edit saved custom model #4 main (file:///c:/users/qwq/appdata/local/pub/cache/hosted/pub.dev/ghostty_vte-0.1.2/hook/build.dart:19:9)
  Github cloning private repository #5 _delayEntrypointInvocation. (dart:isolate-patch/isolate_patch.dart:312:33)
  Implement this to create Android and Flutter projects! #6 _RawReceivePort._handleMessage (dart:isolate-patch/isolate_patch.dart:193:12)

  stdout:
  Skipping downloaded VTE prebuilt for android-arm because this package is being used from a local checkout.
  Building VTE library from source...

Target dart_build failed: Error: Building native assets failed. See the logs for more details.

FAILURE: Build failed with an exception.

• What went wrong:
  Execution failed for task ':app:compileFlutterBuildRelease'.

Process 'command 'D:\windc\flutter\bin\flutter.bat'' finished with non-zero exit value 1

• Try:

Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.
Get more help at https://help.gradle.org.

BUILD FAILED in 46s
Running Gradle task 'assembleRelease'... 46.9s
Gradle task assembleRelease failed with exit code 1
BUILD FAILED in 14s

复现步骤

1. 创建 Flutter 项目
2. 在 pubspec.yaml 中添加依赖：

yaml
ghostty_vte_flutter:
git:
url: https://github.com/heckmon/dart_terminal.git
ref: master
path: pkgs/vte/ghostty_vte_flutter

3. 执行 flutter pub get
4. 执行 flutter build apk --release

期望行为

能够成功编译 Android APK，VTE native 库能够正确构建。

实际行为

VTE 构建脚本找不到 Ghostty VTE 源码，报错退出。

尝试的解决方式

1. 设置环境变量 GHOSTTY_SRC 指向 Ghostty 源码目录
2. 在项目中创建 third_party/ghostty 子目录并放入源码
3. 均未成功

补充信息

• 直接运行 flutter run (Debug 模式) 同样失败
• 依赖解析阶段 (flutter pub get) 正常完成
• 问题发生在 native assets 构建阶段

[heckmon]

作为临时解决方案，您可以直接从 pub.dev 使用 ghostty_vte: ^0.1.2 版本，而不是 GitHub 版本。我使用这个自定义版本是因为它修复了一些 Android 触摸屏问题。但是，如果您想要流畅构建，请克隆之前的提交版本，而不是最新的提交版本。之前的提交版本使用 xterm 而不是 ghostty，无需任何调整即可直接使用。

[heckmon]

Or clone this：
787acc4

[zhengyuliu047-rgb]

好的，十分感谢，我将尝试一下

[heckmon]

git checkout 787acc4f4cb3e8555f1db126338217c67546dfe6

此外，请注意，您需要使用 bundletool 才能使编译器正常工作，因为编译器是在运行时从应用商店服务器动态下载的。因此，在本地运行时，您需要使用 bundletool 将所有编译器预先打包到您的应用程序中，而不是下载它们。此外，您还需要 git-lfs 来拉取大型编译器。这就是为什么我说会在 README 文件中提供详细的构建配置说明。目前我正在忙于大学考试，所以这需要一些时间。

[zhengyuliu047-rgb]

好的，我想先尝试对main的构建，对于谷歌商店版本的构建我会先暂缓一段，我想进行汉化

[heckmon]

是的，main分支应该无需任何额外操作即可运行。只需运行flutter run即可。但是，main分支中还有一些待实现的功能，例如自定义AI模型的编辑, 终端主题、Gemini 工具调用等。

然而，需要特别注意的是……main 分支中没有 dart、rust、go 和 lua 编译器。

[zhengyuliu047-rgb]

我对这个项目很感兴趣，我的打算是在我的大学水课或者无意义的通识课，进行算法刷题，最大化利用时间，所以我想进行汉化

[heckmon]

我明白了，我会在下一个版本中添加多语言支持。另外，我发现 Google Play 商店在中国大陆地区无法使用。所以我会在 main 分支上进行改进，并在发布部分添加一个 apk 文件，这样就可以直接从 GitHub 下载应用了。正如我之前所说，我现在正忙于大学考试。 等我考试结束之后，我会把这些都做完。

[zhengyuliu047-rgb]

十分感谢

[heckmon]

APK文件已发布，请前往发布页面下载。由于目前我比较忙，我会在即将发布的版本中添加多语言支持。

[zhengyuliu047-rgb]

好的十分感谢