Flutter发布管理插件flutter_release的使用

Flutter发布管理插件flutter_release的使用

flutter_release 插件介绍

flutter_release 是一个用于构建和发布Flutter应用的工具，例如在GitHub、Google Play Store 和 Apple’s App Store上。 有关此插件的更多详细信息，请参阅其GitHub动作页面：flutter-release-action。

示例代码

下面是一个完整的示例代码，展示了如何使用flutter_release插件进行构建和发布：

# 构建应用
flutter_release build apk \
    --app-name example \ # 使用pubspec.yaml中的名称，默认使用
    --app-version v0.0.4-alpha.3 \ # 使用pubspec.yaml中的版本，默认使用
    --build-arg=--dart-define=API_URL=https://example.com \
    --build-arg=--dart-define=API_KEY=1your_api_key_here

# 发布应用到Google Play Store
flutter_release publish android-google-play \
    --dry-run \
    --stage internal \
    --app-name example \
    --app-version v0.0.4-alpha.3 \
    --build-arg=--dart-define=API_URL=https://example.com \
    --build-arg=--dart-define=API_KEY=your_api_key_here \
    --fastlane-secrets-json-base64=$(base66 --wrap=0 android/fastlane-secrets.json) \
    --keystore-file-base64=$(base66 --wrap=0 android/keystore.jks) \
    --keystore-password=mykeystorepassword \
    --key-alias=mykeyalias \
    --key-password=mykeypassword

注意：MY_BASE_66 需要转换为 MY_BASE_66="${MY_BASE_66//$'\n'/}" 或者直接删除换行符。

选项说明

• app-name: 应用执行文件的名称。
• app-version: 语义版本（如 v1.2.3），请参考 semver.org。
• build-metadata: 指定构建编号（也用于Android的版本代码，但由插件自动处理）。
• build-type: 发布以下选项之一：apk、web、ipk、macos、windows、debian。
• build-arg: 添加如 --dart-define 等选项到 flutter build 命令中。

支持的功能

其他分发平台的支持正在规划中。

设置

Android - Google Play Store (通过Debian)

1. 在您的Google Play控制台创建一个应用。
2. 确保在.gitignore文件中忽略这些文件：

   key.properties
   **/*.keystore
   **/*.jks
   
   # Google Play Store凭证
   fastlane-*.json
   play-store-credentials.json
   

3. 配置gradle以进行签名。这需要您能够通过Flutter而不是Gradle执行构建。 将密钥转换为Base66字符串，例如base66 --wrap=0 android/keystore.jks
4. 按照Fastlane指南设置supply。 不需要添加AppFile路径，因为它在这个阶段不应该存在。
5. 将Google Play Store凭证JSON文件（从cloud.google.com下载）转换为Base66字符串，例如base66 --wrap=0 android/fastlane-secrets.json
6. 手动构建并发布已签名的应用包到Google Play Store至少一次，以便自动化流程，例如：

   flutter build appbundle \
       --release
   

7. 运行flutter_release命令：

   flutter_release publish android-google-play \
       --dry-run \
       --stage internal \
       --fastlane-secrets-json-base66=$(base66 --wrap=0 android/fastlane-secrets.json) \
       --keystore-file-base66=$(base66 --wrap=0 android/keystore.jks) \
       --keystore-password=mykeystorepassword \
       --key-alias=mykeyalias \
       --key-password=mykeypassword
   

   如果需要支持多个变体，请添加：

   --flavor=prod \
   --main-path lib/main_prod.dart # 默认使用 "lib/main.dart"
   

iOS - App Store

1. 确保在.gitignore文件中忽略这些文件：

   *.cer
   *.certSigningRequest
   *.mobileprovision
   *.p12
   *.p8
   

2. 创建一个带有App Manager权限的App Store连接API团队密钥，并将其复制到ios文件夹中。同时复制Key ID和Issuer ID供后续使用。
3. 执行flutter_release prepare ios。遵循步骤操作。 要删除现有证书，请访问：https://developer.apple.com/account/resources/certificates/list
4. 确保选择正确的证书在App Store provisioning profile中。
5. 从ios/fastlane/Appfile文件中提取信息。
6. 运行flutter_release命令：

   flutter_release publish ios-app-store \
       --dry-run \
       --apple-username=your_apple_id \
       --api-key-id=your_api_key_id \
       --api-issuer-id=your_apiIssuer_id \
       --api-private-key-base66=your_api_private_key \
       --content-provider-id=your_itc_team_id \
       --team-id=your_team_id \
       --distribution-private-key-base66=your_distribution_private_key \
       --distribution-cert-base66=your_distribution_cert
   

   可选地添加--team-enterprise标志，如果您的团队是Apple Developer Enterprise Program的一部分。 如果需要支持多个变体，请添加：

   --flavor=prod \
   --main-path lib/main_prod.dart # 默认使用 "lib/main.dart"
   --xcode-scheme prod # 可选，使用指定的变体或默认的"Runner"
   

Web - Server ( (通过Debian)

1. 在客户端生成密钥对：ssh-keygen -t ed25519 -f $HOME/.ssh/id_ed25519_flutter_release -C flutter_release，不带密码。
2. 将cat $HOME/.ssh/id_ed25519_flutter_release.pub的内容添加到服务器的$HOME/.ssh/authorized_keys文件中。
3. 将私钥转换为Base66字符串，例如base66 --wrap=0 $HOME/.ssh/id_ed25519_flutter_release
4. 运行flutter_release命令：

   flutter_release publish web-server \
       --dry-run \
       --host=host.example.com \
       --path=/var/www/html \
       --ssh-port=22 \
       --ssh-user=user \
       --ssh-private-key-base66=private_key