请注意，本文撰写于173天前，最后修改于171天前，部分信息可能已过时。

前言

我写了一篇关于“使用 Fastforge 为 HarmonyOS NEXT / OpenHarmony 构建 Flutter 应用”的文章

但作为一个懒人，我突然想到构建完成后还得上传到应用商店——App Gallery，这还是挺麻烦的。

然后我发现 App Gallery 支持通过 Publishing API（应用程序编程接口） 上传已构建的应用，于是我为 Fastforge 添加了上传到 App Gallery 的支持。

该 PR 已合并并发布在 Releases 0.6.5 中

Fastforge | 让您的应用分发变得轻松简单。

如何使用：

1. 创建 Connect API 客户端

根据文档 Create an AppGallery Connect API Client 创建 API 客户端并获取 client_id 和 client_secret，如下所示

2025-08-25T10:48:26.png

2. 安装 Fastforge

你可以参考上一篇文章中的安装教程

使用 Fastforge 为 HarmonyOS NEXT / OpenHarmony 构建 Flutter 应用

3. 使用说明

在环境中暴露 Connect API 的 client id 和 client secret

export APP_GALLERY_CLIENT_ID="your client id"
export APP_GALLERY_CLIENT_SECRET="your client secret"

然后在项目中执行以下命令将其上传到 App Gallery；其中 app-id 是 App Gallery 中的应用 APP ID

fastforge publish \
  --path dist/1.0.0+1/hello_world-1.0.0+1-ohos.app \
  --targets appgallery \
  --appgallery-app-id

--appgallery-app-id 将参数传递给发布者。你也可以在 distribute_options.yaml 中配置相同的 app-id（参见下面的示例）

如上所述，你实际上可以先构建应用再上传，你可以参考以下配置快速构建并上传到 App Gallery。

output: dist/
variables:
  FLUTTER_ROOT: ./.fvm/flutter_sdk # 由于我项目使用 FVM 托管 SDK
  APP_GALLERY_CLIENT_ID: 'your client id'
  APP_GALLERY_CLIENT_SECRET: 'your client secret'
releases:
  - name: ohos-release
    jobs:
      - name: release-ohos-app
        package:
          platform: ohos
          # 应用市场仅支持 'app' 格式
          target: app
          build_args:
            # 可选，默认为 default, 对应 ohos 中的 product name
            flavor: release
        publish:
          target: appgallery
          args:
            # 应用在 AppGallery Connect 上的 APP ID
            app-id: 'your app id'

4. 演示

如果你没有全局的 Dart/Flutter 环境，可以临时使用项目中 FVM Flutter SDK（软件开发工具包） 的 DART

$env:PATH += ";$PWD\.fvm\flutter_sdk\bin" # Windows(powershell)
export PATH=$PATH:$PWD/.fvm/flutter_sdk/bin # Linux / macOS

假设在 distribute_options.yaml 中配置了一个名为 ohos-release 的配置项，执行 releases

fastforge release --name ohos-release --skip-clean

2025-08-25T11:46:18.png

打开 App Gallery Connect 平台，你会看到应用包已经上传

来源：使用 Fastforge 自动构建 OHOS Flutter 应用并发布到 App Gallery - Night Glass Stack

关于此帖的讨论

准备好了解更多了吗？

转载声明：本文为转载整理，原文版权归原作者及原站点所有。

原文来源：Harmony Developers Feed

原创地址：https://www.harmony-developers.com/p/use-fastforge-to-automatically-build