fastlane-plugin-fastci 0.0.40 → 0.0.41

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5978da99fdc693c5d6f873bee51f791254b236e6eb92d9beaeea064ca730b52
-  data.tar.gz: 70cc23a65e930ee3df7359a10ae751544276fb64b0b9dd1db395033e7a12322b
+  metadata.gz: 834603cf8a0a78c4fec22ee9f17d84a5f491d25770b2972c3e85b0b5ffcfcc27
+  data.tar.gz: a9ded28f219cd9215058581204ac445601479c0978b4e393f99ed0835f6fe461
 SHA512:
-  metadata.gz: a4ec254de949a0c02e98985d29d2d77d958da26c6a4925ecc8c151c3d29c1faa3766a3f11e410d4211fc4c20b9cb3e91e45688958fe6b9ca2b3278f1f23cb6cb
-  data.tar.gz: bc29f33a3c238d6aa61f7d9500c7eb97969b19c63231e321a8758b2adb7df4c7468b978a7fc5bc3a9aa5d516aefd96ca66b83924dcd6bf06145258202469dfc4
+  metadata.gz: ad0be57cc0708ecdf1b920bb1c3ebff28b94a25a10adde0e7be43b4ba967b9bf95a95d3a3946b6c06ba24fec1d05cd84e91a38e8a313d80868d5c4589a0a084e
+  data.tar.gz: b17392ce988cc5279ef375a8a474288cb51183d7dd0a4b8ec4191351162cb0bc6204e1a782af7f53b9505aab27832cd4666c33cf39208923869245dcc5c9ed06

data/README.md

@@ -71,7 +71,7 @@ package(
 	is_detect_duplicity_code: false, # 是否检测重复代码
 	is_detect_unused_code: false, # 是否检测未使用代码
 	is_detect_unused_image: false, # 是否检测未使用图片
-	changelog: options[:changelog], # fir / Zealot 更新日志
+	changelog: options[:changelog], # fir / Zealot 更新日志，也是各平台钉钉通知的更新说明
 	app_store_resources_enabled: options[:app_store_resources_enabled], # 总开关；未传时读取 APP_STORE_RESOURCES_ENABLED，默认 false
 	app_store_resources_config_path: options[:app_store_resources_config_path], # 未传时读取 APP_STORE_RESOURCES_CONFIG_PATH
 	release_notes: options[:release_notes], # JSON 字符串，例如 '{"zh-Hans":"修复问题","en-US":"Bug fixes"}'；仅资源功能开启且上传 metadata 时生效
@@ -401,6 +401,155 @@ sync_zealot_devices(api_key_path: "./app_store_connect_api_key.json")
 
 依赖兼容：Zealot 的 `debug_file` 依赖 `ruby-macho < 3`，不能与 CocoaPods 1.17（依赖 4.x）放在同一 bundle。此类工程应将 CocoaPods 放入独立 Gemfile；使用 Faraday 1 的 Fastlane 工程还应将 `faraday-net_http` 限制为 `~> 1.0`。
 
+### 8. 钉钉通知
+
+`package` 使用统一的 Markdown 模板发送分发结果、失败及检查结果。配置 `DINGDING_TOKEN` 后默认开启，传入 `is_notice_dingding: false` 可关闭本次流程的全部通知。机器人配置参考[钉钉自定义机器人文档](https://open.dingtalk.com/document/robots/custom-robot-access)，关键词可设为 `iOS`。
+
+```dotenv
+DINGDING_TOKEN=
+DINGDING_INCLUDE_INSTALL_PASSWORD=true
+DINGDING_TESTFLIGHT_URL=
+DINGDING_APP_STORE_URL=
+```
+
+| 配置 | 默认值 | 用途 |
+| --- | --- | --- |
+| `DINGDING_TOKEN` | 未设置 | 群机器人的 `access_token`；未配置时不发送 |
+| `is_notice_dingding` | `true` | `package` 参数；`false` 优先于 Token 配置 |
+| `DINGDING_INCLUDE_INSTALL_PASSWORD` | `true` | 是否展示蒲公英 / fir 的安装密码；`false` 时隐藏 |
+| `DINGDING_TESTFLIGHT_URL` | 未设置 | TestFlight 公开测试邀请链接，配置后展示 |
+| `DINGDING_APP_STORE_URL` | 未设置 | App Store 线上应用页面，配置后展示 |
+
+#### 统一内容与发送时机
+
+标题为 `应用 Scheme iOS · 平台 · 状态`。各平台均包含应用、Bundle ID、分发平台、状态、实际版本、Build、打包方式、构建配置、累计耗时和通知时间；时间包含构建机器的时区偏移。`changelog` 有值时追加更新说明，最多展示 1,000 个字符。缺失的可选字段与链接不展示。
+
+更新说明保留输入的逐行内容，LF / CRLF 换行会转换为 Markdown 强制换行，避免多条 Git 提交显示成一段；该格式转换仅用于钉钉展示，不修改上传平台收到的日志原文。
+
+二维码由构建机下载后，以 `data:image/...;base64,...` 内嵌到同一条 Markdown 通知，保留「打开二维码」链接。接受 PNG / JPEG / GIF，单图上限 8 KB，连接超时 5 秒、下载总超时 15 秒；下载失败、格式不符或超过上限时只展示链接，不中断打包。Base64 展示采用当前使用环境已验证的方式；[钉钉官方消息类型文档](https://open.dingtalk.com/document/orgapp/custom-bot-send-message-type)未明确承诺 Data URL 的跨客户端支持。
+
+- IPA 构建并复制完成后仅记录终端日志，不发送钉钉成功通知。
+- 蒲公英、fir、Zealot、TestFlight 和 App Store 在各自上传结束后发送一次平台结果；同时上传多个平台时，每个平台各一条。
+- 商店包缺少上传配置时发送「未上传」，说明 IPA 已生成；未配置测试分发平台且未执行检查时，构建成功不发送通知。
+- 构建、分发、符号上传或检查抛出异常时，发送当前平台和失败阶段，随后保留原有异常处理。原始异常详情仍在构建日志中。
+- Zealot 关闭 `fail_on_error` 后未返回发布结果时，发送「上传未完成」，按原配置继续流程。
+- 只有实际执行了代码检查，才发送检查项目清单；这表示检查执行完成，问题详情查看报告。App Store / TestFlight 跳过检查时不发送检查完成通知。
+- 钉钉发送超时、HTTP 失败或机器人拒绝消息时，只记录提示，不改变打包结果。不再发送「测试一下」。
+
+发送使用系统 `/usr/bin/curl`，保留 HTTPS 证书校验，连接超时 5 秒、整个请求超时 15 秒；Token 与正文通过标准输入传入，不出现在命令参数中。终端会记录发送开始及成功，失败时区分 curl 退出码、HTTP 状态码和钉钉 `errcode`，不打印凭据或原始响应。
+
+通知由 `package` 统一编排；直接调用 `upload_pgy`、`upload_fir`、`upload_zealot`、`upload_store` 或 `app_store_resources` 不额外发送这套通知。
+
+#### 各分发平台内容
+
+下面五份示例使用同一套公共字段；安装密码、链接、二维码只在配置或上传结果提供时出现。示例中的更新说明来自 `package(changelog: "修复问题，优化体验")`，不会自动读取 metadata 目录中的文案。
+
+**蒲公英**：安装页面、安装二维码、安装密码。地址使用上传接口返回的实际地址。
+
+```text
+📦 ExampleApp iOS · 蒲公英 · 上传完成
+应用：ExampleApp
+Bundle ID：com.example.app
+分发平台：蒲公英
+状态：上传完成
+版本：1.2.3
+Build：42
+打包方式：ad-hoc
+构建配置：Release
+安装密码：example-password
+累计耗时：180 秒
+通知时间：2026-11-03 12:00:00 +08:00
+[安装页面]
+[安装二维码]
+更新说明：修复问题，优化体验
+```
+
+**fir**：安装页面、安装密码。当前上传接口不提供二维码，因此不生成二维码链接。
+
+```text
+📦 ExampleApp iOS · fir · 上传完成
+应用：ExampleApp
+Bundle ID：com.example.app
+分发平台：fir
+状态：上传完成
+版本：1.2.3
+Build：42
+打包方式：ad-hoc
+构建配置：Release
+安装密码：example-password
+累计耗时：190 秒
+通知时间：2026-11-03 12:00:10 +08:00
+[安装页面]
+更新说明：修复问题，优化体验
+```
+
+**Zealot**：Release ID、版本详情、安装页面、安装二维码，以及 dSYM 是否上传。开启 dSYM 上传后，等待该步骤结束再发送此平台的结果。
+
+```text
+📦 ExampleApp iOS · Zealot · 上传完成
+应用：ExampleApp
+Bundle ID：com.example.app
+分发平台：Zealot
+状态：上传完成
+版本：1.2.3
+Build：42
+打包方式：ad-hoc
+构建配置：Release
+Release ID：42
+dSYM：已上传
+累计耗时：200 秒
+通知时间：2026-11-03 12:00:20 +08:00
+[版本详情] [安装页面]
+[安装二维码]
+更新说明：修复问题，优化体验
+```
+
+**TestFlight**：App Store Connect 入口、可选测试邀请；明确区分 IPA 上传和 Apple 后续处理。邀请链接不会因为本次上传而保证新构建已可测试。
+
+```text
+📦 ExampleApp iOS · TestFlight · 上传完成
+应用：ExampleApp
+Bundle ID：com.example.app
+分发平台：TestFlight
+状态：上传完成
+版本：1.2.3
+Build：42
+打包方式：testFlight
+构建配置：Release
+说明：IPA 已上传，尚未等待 Apple 处理完成；测试可用性请在 App Store Connect 确认。
+累计耗时：240 秒
+通知时间：2026-11-03 12:01:00 +08:00
+[App Store Connect] [TestFlight 测试邀请]
+更新说明：修复问题，优化体验
+```
+
+**App Store**：App Store Connect 入口、可选线上页面，以及本次元数据、截图、构建选择、提交审核的执行结果。资源总开关关闭时显示「商店资源：未开启，仅上传 IPA」；开启时如下例。
+
+```text
+📦 ExampleApp iOS · App Store · 上传完成
+应用：ExampleApp
+Bundle ID：com.example.app
+分发平台：App Store
+状态：上传完成
+版本：1.2.3
+Build：42
+打包方式：app-store
+构建配置：Release
+说明：上传完成不代表审核通过或已上线；线上页面可能仍为旧版本。
+元数据：已上传
+截图：未上传
+构建选择：已选择本次 Build
+提交审核：已提交
+累计耗时：360 秒
+通知时间：2026-11-03 12:03:00 +08:00
+[App Store Connect] [App Store 线上页面]
+更新说明：修复问题，优化体验
+```
+
+商店资源流程失败时不会发送上述成功消息，而是发送「执行失败」，注明失败阶段和 IPA 是否已经上传；通知本身不会开启商店资源功能。
+
+---
+
 ## 发布到 RubyGems
 
 工作流位于 [`.github/workflows/release.yml`](.github/workflows/release.yml)。使用 `1.0.0` 这样的纯版本标签，无需 `v` 前缀。推送数字开头的标签后，自动校验标签与 `lib/fastlane/plugin/fastci/version.rb` 中的 `VERSION` 完全一致，检查 Ruby 语法、构建 gem 并发布到 RubyGems。
@@ -418,12 +567,12 @@ sync_zealot_devices(api_key_path: "./app_store_connect_api_key.json")
 
 工作流使用官方 OIDC 短期凭据，不需要配置 `RUBYGEMS_API_KEY` 或创建 GitHub Environment。工作流文件在当前仓库内，Workflow Repository 两项留空。若以后设置 Environment，RubyGems 配置与工作流的 `environment` 必须保持一致。
 
-每次发布先修改 `VERSION`，执行 `bundle install` 同步 `Gemfile.lock`，并提交本次拟发布的代码和工作流。然后推送对应标签，例如版本更新为 `0.0.40` 后：
+每次发布先修改 `VERSION`，执行 `bundle install` 同步 `Gemfile.lock`，并提交本次拟发布的代码和工作流。然后推送对应标签，例如版本更新为 `0.0.41` 后：
 
 ```bash
 git push origin main
-git tag -a 0.0.40 -m "Release 0.0.40"
-git push origin 0.0.40
+git tag -a 0.0.41 -m "Release 0.0.41"
+git push origin 0.0.41
 ```
 
 到 GitHub **Actions → Release to RubyGems** 查看结果。已发布版本不能覆盖；失败重跑前先确认该版本是否已经发布。只有打入标签提交的文件会被发布，本地未提交改动不会包含在内。

data/lib/fastlane/plugin/fastci/actions/package_action.rb

@@ -2,6 +2,7 @@ require 'gym'
 require 'fastlane_core'
 require 'fastlane/action'
 require 'fastlane/plugin/fastci/helper/app_store_resources_helper'
+require 'fastlane/plugin/fastci/helper/package_notification_helper'
 include Fastlane::Helper
 
 module Fastlane
@@ -9,27 +10,14 @@ module Fastlane
     # 打包
     class PackageAction < Action
       def self.run(params)
+        notice = PackageNotificationHelper.new(params)
         # 入参配置
         configuration = params[:configuration] || 'Debug'
         export_method = params[:export_method] || 'development'
         build = params[:build] || nil
         version = params[:version] || nil
-        is_analyze_swiftlint = params[:is_analyze_swiftlint] || false
-        is_detect_duplicity_code = params[:is_detect_duplicity_code] || false
-        is_detect_unused_code = params[:is_detect_unused_code] || false
-        is_detect_unused_image = params[:is_detect_unused_image] || false
         store_options = store_upload_options(params, export_method)
         configuration = 'Release' if %w[app-store testFlight].include?(export_method)
-        is_notice_dingding = params[:is_notice_dingding].nil? ? true : params[:is_notice_dingding]
-        # 统一发送钉钉消息匿名函数
-        send_dingding_notice = lambda do |text|
-          if is_notice_dingding
-            DingdingHelper.sendMarkdown(text)
-          else
-            UI.message('*************| 跳过钉钉消息通知（is_notice_dingding=false）|*************')
-          end
-        end
-        send_dingding_notice.call('测试一下')
         # 清理上一次的打包缓存
         FileUtils.rm_rf(Dir.glob("#{Constants.BUILD_LOG_DIR}/*"))
         FileUtils.rm_rf(Dir.glob("#{Constants.IPA_OUTPUT_DIR}/*"))
@@ -53,7 +41,6 @@ module Fastlane
         other_action.update_build_number(
           build: build
         )
-        time = Time.new.strftime('%Y%m%d%H%M')
 
         # 获取版本号
         version_options = { target: scheme }
@@ -66,6 +53,7 @@ module Fastlane
         build = other_action.get_build_number(build_options)
         # 生成ipa包的名字格式
         ipaName = "#{scheme}_#{export_method}_#{version}_#{build}.ipa"
+        notice.build_info(version: version, build: build)
 
         # 获取 Extension 的 Bundle ID（可能有多个，用逗号分隔）
         extension_bundle_ids = Environment.extension_bundle_ids
@@ -120,11 +108,13 @@ module Fastlane
           gym_options[:export_options][:provisioningProfiles] = provisioningProfiles_map
         end
 
+        notice.stage(:local, '构建 IPA')
         other_action.gym(gym_options)
 
         UI.message('*************| 打包完成 |*************')
 
         UI.message('*************| 复制打包产物 |*************')
+        notice.stage(:local, '复制构建产物')
         # 定义桌面路径
         desktop_path = File.expand_path('~/Desktop')
         output_path = File.join(desktop_path, "BuildOutput_#{scheme}")
@@ -141,126 +131,92 @@ module Fastlane
         # system("git reset --hard")
 
         ipa_path = "#{Constants.IPA_OUTPUT_DIR}/#{ipaName}"
-
-        if gym_method == 'app-store'
-          notiText = "🚀🚀🚀🚀🚀🚀\n\n#{scheme}-iOS-打包完成\n\n#{version}_#{build}_#{export_method}\n\n🚀🚀🚀🚀🚀🚀"
-          send_dingding_notice.call(notiText)
-
-          if upload_store_if_configured(store_options, version: version, build: build)
-            notiText = "🚀🚀🚀🚀🚀🚀\n\n#{scheme}-iOS-上传完成\n\n#{version}_#{build}_#{export_method}\n\n🚀🚀🚀🚀🚀🚀"
-            send_dingding_notice.call(notiText)
-          end
-        else
-          # 钉钉通知
-          notiText = "🚀🚀🚀🚀🚀🚀\n\n#{scheme}-iOS-打包完成\n\n#{version}_#{build}_#{export_method}\n\n🚀🚀🚀🚀🚀🚀"
-
-          # 上传蒲公英
-          if CommonHelper.is_validate_string(Environment.pgy_api_key)
-            pgy_upload_info = other_action.upload_pgy
-            qrCode = pgy_upload_info['buildQRCodeURL']
-
-            if CommonHelper.is_validate_string(qrCode)
-              notiText << "\n\n⬇️⬇️⬇️ 扫码安装 ⬇️⬇️⬇️\n\n\n密码: #{Environment.pgy_password}\n![screenshot](#{qrCode})"
-            end
-          end
-
-          # 上传 fir
-          if CommonHelper.is_validate_string(Environment.fir_api_token)
-            fir_upload_info = other_action.upload_fir(
-              changelog: params[:changelog]
-            )
-            download_url = fir_upload_info[:download_url]
-
-            if CommonHelper.is_validate_string(download_url)
-              notiText << "\n\n⬇️⬇️⬇️ 点击链接安装 ⬇️⬇️⬇️\n\n\n密码: #{Environment.fir_password}\n[_点击下载_](#{download_url})"
-            end
-          end
-
-          # 上传 Zealot
-          if CommonHelper.is_validate_string(Environment.zealot_token)
-            zealot_upload_info = other_action.upload_zealot(
-              file: ipa_path,
-              changelog: params[:changelog]
-            )
-            # dSYM 仅在 IPA 上传成功且显式开启时上传。
-            if zealot_upload_info && params[:is_upload_zealot_dsym]
-              other_action.upload_zealot_dsym
-            end
-          end
-
-          send_dingding_notice.call(notiText)
-        end
+        # 构建完成仅记录终端日志，钉钉成功通知由各分发平台上传结果触发。
+        distribute_package(params, notice, store_options, ipa_path: ipa_path, version: version, build: build)
 
         # Sentry 上传 dSYM
         if CommonHelper.is_validate_string(Environment.sentry_auth_token)
+          notice.stage(:sentry, '上传 dSYM')
           other_action.sentry_upload_dsym
         else
           UI.message('*************| 未配置 Sentry 跳过 dSYM 上传 |*************')
         end
 
-        # 代码分析
-        if is_analyze_swiftlint && gym_method != 'app-store'
-          other_action.analyze_swiftlint(
-            is_from_package: true,
-            configuration: configuration
-          )
-          # 结果复制到桌面
-          FileUtils.cp(SWIFTLINT_ANALYZE_HTML_FILE, target_path)
-          UI.message('*************| 代码分析完成 |*************')
-        else
-          UI.message('*************| 跳过代码分析 |*************')
-        end
+        run_package_checks(params, notice, gym_method: gym_method, scheme: scheme,
+                           configuration: configuration, target_path: target_path)
 
-        # 重复代码检查
-        if is_detect_duplicity_code && gym_method != 'app-store'
-          other_action.detect_duplicity_code(
-            is_all: true
-          )
-          # 结果复制到桌面
-          FileUtils.cp(DUPLICITY_CODE_HTML_FILE, target_path)
-          UI.message('*************| 重复代码检查完成 |*************')
-        else
-          UI.message('*************| 跳过重复代码检查 |*************')
-        end
+        UI.message('*************| 脚本完成 |*************')
+      rescue StandardError
+        notice&.failure(store_result: Actions.lane_context[SharedValues::FASTCI_STORE_UPLOAD_RESULT] || {})
+        raise
+      end
 
-        # 无用代码检查
-        if is_detect_unused_code && gym_method != 'app-store'
-          other_action.detect_unused_code(
-            scheme: scheme,
-            is_from_package: true,
-            configuration: configuration
-          )
-          # 结果复制到桌面
-          FileUtils.cp(Constants.UNUSED_CODE_HTML_FILE, target_path)
-          UI.message('*************| 无用代码检查完成 |*************')
+      # 各平台分别发送结果；后一个平台失败时，已经成功的平台仍有明确通知。
+      def self.distribute_package(params, notice, store_options, ipa_path:, version:, build:)
+        if %w[app-store testFlight].include?(params[:export_method])
+          platform = params[:export_method] == 'testFlight' ? :testflight : :app_store
+          notice.stage(platform, '准备商店上传')
+          Actions.lane_context.delete(SharedValues::FASTCI_STORE_UPLOAD_RESULT)
+          if upload_store_if_configured(store_options, version: version, build: build)
+            result = Actions.lane_context[SharedValues::FASTCI_STORE_UPLOAD_RESULT] || {}
+            notice.distribution_completed(platform, { uploaded: true }, store_result: result)
+          else
+            notice.store_skipped(platform)
+          end
         else
-          UI.message('*************| 跳过无用代码检查 |*************')
+          distribute_test_package(params, notice, ipa_path)
         end
+      end
 
-        # 无用图片检查
-        if is_detect_unused_image && gym_method != 'app-store'
-          other_action.detect_unused_image
-          # 结果复制到桌面
-          FileUtils.cp(Constants.UNUSED_IMAGE_HTML_FILE, target_path)
-          UI.message('*************| 无用图片检查完成 |*************')
-        else
-          UI.message('*************| 跳过未使用图片检查 |*************')
+      # 保持原有上传顺序与开关；安装链接的整理交给通知 Helper。
+      def self.distribute_test_package(params, notice, ipa_path)
+        if CommonHelper.is_validate_string(Environment.pgy_api_key)
+          notice.stage(:pgy, '上传 IPA')
+          notice.distribution_completed(:pgy, other_action.upload_pgy)
         end
-
-        if is_analyze_swiftlint ||
-           is_detect_duplicity_code ||
-           is_detect_unused_code ||
-           is_detect_unused_image
-          # 钉钉通知
-          notiText = "🚀🚀🚀🚀🚀🚀\n\n#{scheme}-iOS-代码检查完成\n\n#{version}_#{build}_#{export_method}\n\n🚀🚀🚀🚀🚀🚀"
-          send_dingding_notice.call(notiText)
-        else
-          UI.message('*************| 跳过代码检查 |*************')
+        if CommonHelper.is_validate_string(Environment.fir_api_token)
+          notice.stage(:fir, '上传 IPA')
+          notice.distribution_completed(:fir, other_action.upload_fir(changelog: params[:changelog]))
+        end
+        return unless CommonHelper.is_validate_string(Environment.zealot_token)
+
+        notice.stage(:zealot, '上传 IPA')
+        result = other_action.upload_zealot(file: ipa_path, changelog: params[:changelog])
+        if result && params[:is_upload_zealot_dsym]
+          notice.stage(:zealot, '上传 dSYM（IPA 已上传）')
+          other_action.upload_zealot_dsym
+          result = result.merge(dsym_status: Actions.lane_context[SharedValues::ZEAALOT_ERROR_MESSAGE] ? '上传未完成' : '已上传')
         end
+        notice.distribution_completed(:zealot, result)
+      end
 
-        UI.message('*************| 脚本完成 |*************')
+      # 仅统计实际调用的检查，商店包跳过检查时不发送“检查完成”。
+      def self.run_package_checks(params, notice, gym_method:, scheme:, configuration:, target_path:)
+        return if gym_method == 'app-store'
+
+        checks = [
+          [:is_analyze_swiftlint, 'SwiftLint', :analyze_swiftlint,
+           { is_from_package: true, configuration: configuration }, Constants.SWIFTLINT_ANALYZE_HTML_FILE],
+          [:is_detect_duplicity_code, '重复代码', :detect_duplicity_code,
+           { is_all: true }, Constants.DUPLICITY_CODE_HTML_FILE],
+          [:is_detect_unused_code, '无用代码', :detect_unused_code,
+           { scheme: scheme, is_from_package: true, configuration: configuration }, Constants.UNUSED_CODE_HTML_FILE],
+          [:is_detect_unused_image, '无用图片', :detect_unused_image, {}, Constants.UNUSED_IMAGE_HTML_FILE]
+        ]
+        completed = []
+        checks.each do |key, name, action, options, report|
+          next unless params[key]
+
+          notice.stage(:checks, name)
+          options.empty? ? other_action.public_send(action) : other_action.public_send(action, **options)
+          FileUtils.cp(report, target_path)
+          completed << name
+        end
+        notice.checks_completed(completed)
       end
 
+      private_class_method :distribute_package, :distribute_test_package, :run_package_checks
+
       # 构建前准备商店上传参数，开启资源功能却漏配路径时立即报错。
       def self.store_upload_options(params, export_method)
         config_path = AppStoreResourcesHelper.upload_config_path(params, app_store: export_method == 'app-store')

data/lib/fastlane/plugin/fastci/actions/upload_store_action.rb

@@ -5,15 +5,23 @@ include Fastlane::Helper
 
 module Fastlane
   module Actions
+    module SharedValues
+      FASTCI_STORE_UPLOAD_RESULT = :FASTCI_STORE_UPLOAD_RESULT
+    end
+
     # 上传 AppStore
     class UploadStoreAction < Action
       def self.run(params)
+        # 每次上传重新记录阶段；失败时 package 可区分 IPA 上传与后续资源发布。
+        result = { stage: '准备商店上传', ipa_uploaded: false, resources_enabled: false }
+        Actions.lane_context[SharedValues::FASTCI_STORE_UPLOAD_RESULT] = result
         resource_params, api_key_options = prepare_upload(params)
+        result[:resources_enabled] = !resource_params.nil?
 
         if params[:isTestFlight]
-          upload_testflight(api_key_options)
+          upload_testflight(api_key_options, result)
         else
-          upload_app_store(resource_params, api_key_options)
+          upload_app_store(resource_params, api_key_options, result)
         end
       end
 
@@ -51,23 +59,40 @@ module Fastlane
       end
 
       # TestFlight 沿用现有上传方式，不执行 App Store 资源流程。
-      def self.upload_testflight(api_key_options)
+      def self.upload_testflight(api_key_options, result)
         UI.message('*************| 开始上传 TestFlight |*************')
-        other_action.upload_to_testflight({ skip_waiting_for_build_processing: true }.merge(api_key_options))
+        result[:stage] = '上传 TestFlight IPA'
+        upload_result = other_action.upload_to_testflight({ skip_waiting_for_build_processing: true }.merge(api_key_options))
+        result[:ipa_uploaded] = true
+        upload_result
       end
 
       # 先上传 IPA，再处理已校验的资源；返回 IPA 上传结果以兼容已有 lane。
-      def self.upload_app_store(resource_params, api_key_options)
+      def self.upload_app_store(resource_params, api_key_options, result)
         UI.message('*************| 开始上传 AppStore |*************')
+        result[:stage] = '上传 App Store IPA'
         upload_options = app_store_upload_options(resource_params).merge(api_key_options)
         upload_result = other_action.upload_to_app_store(upload_options)
+        result[:ipa_uploaded] = true
         if resource_params
+          result[:stage] = '发布商店资源 / 选择构建 / 提交审核'
           # 新版本判断已在 IPA 上传前完成，之后直接使用确认过的资源上传开关。
           other_action.app_store_resources(resource_params.merge(upload_metadata_on_new_version: false))
+          record_resource_result(result, resource_params)
         end
         upload_result
       end
 
+      # 仅在整个资源 Action 成功返回后记录完成项，保持原 Action 的返回值不变。
+      def self.record_resource_result(result, params)
+        result.merge!(
+          metadata_uploaded: params[:metadata_changed],
+          screenshots_uploaded: params[:screenshots_changed],
+          build_selected: params[:select_build] || params[:submit_for_review],
+          review_submitted: params[:submit_for_review]
+        )
+      end
+
       # IPA 阶段始终关闭资源上传，避免默认目录或 Deliverfile 绕过资源总开关。
       def self.app_store_upload_options(resource_params)
         options = {
@@ -90,7 +115,7 @@ module Fastlane
       end
 
       private_class_method :prepare_upload, :load_store_resources, :parse_release_notes,
-                           :upload_testflight, :upload_app_store, :app_store_upload_options
+                           :upload_testflight, :upload_app_store, :app_store_upload_options, :record_resource_result
 
       def self.description
         "上传 AppStore"

data/lib/fastlane/plugin/fastci/helper/dingding_helper.rb

@@ -1,35 +1,70 @@
 require 'fastlane_core/ui/ui'
-require 'fileutils'
+require 'json'
+require 'open3'
+require 'uri'
 
 module Fastlane
   module Helper
     class DingdingHelper
 
-      def self.sendMarkdown(text)
-
-        # 检查钉钉 Token 是否存在
-        unless CommonHelper.is_validate_string(Environment.dingdingToken)
-          UI.message("*************| 跳过钉钉消息通知（未配置 Token）|*************")
-          return
+      # 保留原调用入口；JSON 序列化避免更新说明中的引号、换行破坏消息。
+      def self.sendMarkdown(text, title: nil)
+        token = Environment.dingdingToken.to_s.strip
+        if token.empty?
+          UI.message('跳过钉钉通知：未配置 DINGDING_TOKEN')
+          return false
         end
-        
-        UI.message("*************| 开始钉钉消息通知 |*************")
-
-        curl = %Q{
-          curl 'https://oapi.dingtalk.com/robot/send?access_token=#{Environment.dingdingToken}' \
-          -H 'Content-Type:application/json' \
-          -d '{
-            "msgtype":"markdown",
-            "markdown":{
-              "title":"#{Environment.scheme} 打包通知",
-              "text":"#{text}"
-            }
-          }'
+
+        payload = {
+          msgtype: 'markdown',
+          markdown: { title: title || "#{Environment.scheme} 打包通知", text: text }
         }
-        system curl
-        UI.message("")
+        UI.message('开始发送钉钉通知')
+        response = post_message(token, payload)
+        return false unless response
+
+        unless response[:code].between?(200, 299)
+          UI.important("钉钉通知发送失败（HTTP #{response[:code]}），继续原流程")
+          return false
+        end
+
+        result = JSON.parse(response[:body])
+        if result.is_a?(Hash) && result['errcode'] == 0
+          UI.success('钉钉通知发送成功')
+          return true
+        end
+
+        # 不输出响应原文或异常消息，避免机器人 Token 随请求地址进入日志。
+        error_code = result.is_a?(Hash) && result['errcode'].is_a?(Integer) ? result['errcode'] : '未知'
+        UI.important("钉钉拒绝消息（errcode=#{error_code}），请检查机器人配置；继续原流程")
+        false
+      rescue StandardError => error
+        UI.important("钉钉通知发送失败（#{error.class}），请检查网络及机器人配置；继续原流程")
+        false
       end
 
+      # 使用系统 curl 的证书链校验，避开 Ruby OpenSSL 在本机的 CRL 校验错误。
+      # URL 和 JSON 通过 stdin 配置传递，不进入进程参数或 shell；保持 TLS 校验与超时。
+      def self.post_message(token, payload)
+        uri = URI('https://oapi.dingtalk.com/robot/send')
+        uri.query = URI.encode_www_form(access_token: token)
+        # 第二次 JSON 编码只为 curl 配置中的双引号和反斜杠转义，正文仍为原始 JSON。
+        configuration = "url = #{JSON.generate(uri.to_s)}\ndata-binary = #{JSON.generate(JSON.generate(payload))}\n"
+        output, _stderr, status = Open3.capture3(
+          '/usr/bin/curl', '--disable', '--silent', '--show-error',
+          '--connect-timeout', '5', '--max-time', '15',
+          '--header', 'Content-Type: application/json; charset=utf-8',
+          '--write-out', "\n%{http_code}", '--config', '-', stdin_data: configuration
+        )
+        unless status.success?
+          UI.important("钉钉通知网络请求失败（curl exit=#{status.exitstatus}），继续原流程")
+          return nil
+        end
+
+        body, _separator, code = output.rpartition("\n")
+        { code: Integer(code, 10), body: body }
+      end
+      private_class_method :post_message
     end
   end
 end

data/lib/fastlane/plugin/fastci/helper/dingding_image_helper.rb

@@ -0,0 +1,70 @@
+require 'base64'
+require 'json'
+require 'open3'
+require 'tempfile'
+require 'uri'
+require 'fastlane_core/ui/ui'
+
+module Fastlane
+  module Helper
+    # 二维码在构建机下载后内嵌到 Markdown，避免钉钉客户端再次访问分发服务器。
+    class DingdingImageHelper
+      # Base64 会增加约三分之一体积，为通知正文和更新说明留出空间。
+      MAX_IMAGE_BYTES = 8 * 1024
+
+      def self.base64_source(url)
+        uri = URI.parse(url.to_s)
+        return unless %w[http https].include?(uri.scheme) && uri.host && !uri.userinfo
+
+        data = download_image(uri)
+        return unless data
+
+        mime_type = image_mime_type(data)
+        unless mime_type
+          UI.important('二维码响应不是 PNG、JPEG 或 GIF 图片，通知保留图片链接')
+          return nil
+        end
+
+        "data:#{mime_type};base64,#{Base64.strict_encode64(data)}"
+      rescue StandardError => error
+        # 不输出 URL、响应正文或异常原文，避免签名参数进入打包日志。
+        UI.important("二维码内嵌失败（#{error.class}），通知保留图片链接")
+        nil
+      end
+
+      def self.download_image(uri)
+        Tempfile.create(['fastci-dingding-qr', '.image']) do |file|
+          # 不经过 shell；图片地址仅通过 stdin 传递，保留证书校验并限制下载量与耗时。
+          _output, _stderr, status = Open3.capture3(
+            '/usr/bin/curl', '--disable', '--silent', '--show-error', '--fail',
+            '--location', '--max-redirs', '3', '--proto', '=http,https', '--proto-redir', '=http,https',
+            '--connect-timeout', '5', '--max-time', '15', '--max-filesize', MAX_IMAGE_BYTES.to_s,
+            '--output', file.path, '--config', '-', stdin_data: "url = #{JSON.generate(uri.to_s)}\n"
+          )
+          unless status.success?
+            UI.important("二维码下载失败（curl exit=#{status.exitstatus}），通知保留图片链接")
+            return nil
+          end
+
+          # 额外检查实际字节数，兼容未返回 Content-Length 的图片接口。
+          data = File.binread(file.path, MAX_IMAGE_BYTES + 1)
+          if data.empty? || data.bytesize > MAX_IMAGE_BYTES
+            UI.important('二维码为空或超过 8 KB，通知保留图片链接')
+            return nil
+          end
+
+          data
+        end
+      end
+
+      # 按文件签名识别格式，避免把登录页或错误 HTML 当作图片编码发送。
+      def self.image_mime_type(data)
+        return 'image/png' if data.start_with?("\x89PNG\r\n\x1a\n".b)
+        return 'image/jpeg' if data.start_with?("\xff\xd8\xff".b)
+        return 'image/gif' if data.start_with?('GIF87a', 'GIF89a')
+      end
+
+      private_class_method :download_image, :image_mime_type
+    end
+  end
+end

data/lib/fastlane/plugin/fastci/helper/environment.rb

@@ -120,6 +120,19 @@ module Fastlane
         ENV['DINGDING_TOKEN']
       end
 
+      # 商店安装入口由项目配置；上传接口本身不提供 TestFlight 邀请或线上商店地址。
+      def self.dingding_testflight_url
+        ENV['DINGDING_TESTFLIGHT_URL']
+      end
+      def self.dingding_app_store_url
+        ENV['DINGDING_APP_STORE_URL']
+      end
+
+      # 默认兼容原有密码展示，配置 false 后不在群通知中附带安装密码。
+      def self.dingding_include_install_password
+        ENV.fetch('DINGDING_INCLUDE_INSTALL_PASSWORD', 'true').casecmp('true').zero?
+      end
+
       # Sentry 配置
       def self.sentry_auth_token
         ENV['SENTRY_AUTH_TOKEN']

data/lib/fastlane/plugin/fastci/helper/package_notification_helper.rb

@@ -0,0 +1,184 @@
+require 'cgi'
+require 'uri'
+require 'fastlane/plugin/fastci/helper/dingding_helper'
+require 'fastlane/plugin/fastci/helper/dingding_image_helper'
+
+module Fastlane
+  module Helper
+    # 每次 package 独立保存通知上下文，避免多个 lane 之间串用版本或分发结果。
+    class PackageNotificationHelper
+      PLATFORM_NAMES = {
+        local: '本地构建', pgy: '蒲公英', fir: 'fir', zealot: 'Zealot',
+        testflight: 'TestFlight', app_store: 'App Store', checks: '代码检查', sentry: 'Sentry'
+      }.freeze
+
+      def initialize(params)
+        @enabled = params[:is_notice_dingding] != false
+        @scheme = params[:scheme] || Environment.scheme
+        @export_method = params[:export_method] || 'development'
+        @configuration = %w[app-store testFlight].include?(@export_method) ? 'Release' : (params[:configuration] || 'Debug')
+        @version, @build = params[:version], params[:build]
+        @changelog = params[:changelog]
+        @started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        stage(:local, '准备构建')
+      end
+
+      # 在构建前记录实际版本，失败通知也能定位到本次产物。
+      def build_info(version:, build:)
+        @version, @build = version, build
+      end
+
+      def stage(platform, name)
+        @platform, @stage = platform, name
+      end
+
+      # 各渠道只转换自己的返回字段，公共标题与正文始终使用同一模板。
+      def distribution_completed(platform, result = {}, store_result: {})
+        stage(platform, '上传分发包')
+        if !result.is_a?(Hash) || result.empty?
+          return notify('上传未完成', details: { '说明' => '上传接口未返回成功结果，请查看构建日志。' }, failed: true)
+        end
+
+        fields = distribution_fields(platform, result, store_result)
+        notify('上传完成', **fields)
+      end
+
+      def store_skipped(platform)
+        stage(platform, '上传分发包')
+        notify('未上传', details: { '说明' => 'IPA 已生成，未配置商店上传认证。' })
+      end
+
+      def checks_completed(names)
+        return if names.empty?
+
+        stage(:checks, '代码检查')
+        notify('检查执行完成', details: {
+          '已执行' => names.join('、'), '说明' => '检查已执行，发现的问题请查看本次生成的报告。'
+        })
+      end
+
+      # 失败消息只说明阶段，不把可能含凭据、个人路径的原始异常发送到群里。
+      def failure(store_result: {})
+        details = { '失败阶段' => @stage, '说明' => '本次流程已中断，请查看构建日志。' }
+        if [:testflight, :app_store].include?(@platform) && !store_result.empty?
+          details['失败阶段'] = store_result[:stage]
+          details['IPA'] = store_result[:ipa_uploaded] ? '已上传' : '尚未确认上传完成'
+        end
+        notify('执行失败', details: details, failed: true)
+      end
+
+      private
+
+      def distribution_fields(platform, result, store_result)
+        case platform
+        when :pgy
+          {
+            links: { '安装页面' => value(result, :fastlaneAddedWholeVisitUrl) },
+            qr_code: value(result, :buildQRCodeURL), password: Environment.pgy_password
+          }
+        when :fir
+          { links: { '安装页面' => value(result, :download_url) }, password: Environment.fir_password }
+        when :zealot
+          {
+            links: { '版本详情' => value(result, :release_url), '安装页面' => value(result, :install_url) },
+            qr_code: value(result, :qrcode_url),
+            details: { 'Release ID' => value(result, :release_id), 'dSYM' => value(result, :dsym_status) || '未开启' }
+          }
+        when :testflight
+          {
+            links: store_links.merge('TestFlight 测试邀请' => Environment.dingding_testflight_url),
+            details: { '说明' => 'IPA 已上传，尚未等待 Apple 处理完成；测试可用性请在 App Store Connect 确认。' }
+          }
+        when :app_store
+          { links: store_links.merge('App Store 线上页面' => Environment.dingding_app_store_url), details: store_details(store_result) }
+        else
+          {}
+        end
+      end
+
+      def store_links
+        { 'App Store Connect' => 'https://appstoreconnect.apple.com/apps' }
+      end
+
+      # 使用上传流程确认过的结果，不从配置推断资源已上传或审核已通过。
+      def store_details(result)
+        details = { '说明' => '上传完成不代表审核通过或已上线；线上页面可能仍为旧版本。' }
+        unless result[:resources_enabled]
+          return details.merge('商店资源' => '未开启，仅上传 IPA')
+        end
+
+        details.merge(
+          '元数据' => result[:metadata_uploaded] ? '已上传' : '未上传',
+          '截图' => result[:screenshots_uploaded] ? '已上传' : '未上传',
+          '构建选择' => result[:build_selected] ? '已选择本次 Build' : '未执行',
+          '提交审核' => result[:review_submitted] ? '已提交' : '未提交'
+        )
+      end
+
+      def value(result, key)
+        result[key] || result[key.to_s]
+      end
+
+      # 不写空链接、空密码；安装密码开关默认保留旧版的展示行为。
+      def notify(status, details: {}, links: {}, qr_code: nil, password: nil, failed: false)
+        return unless @enabled && !Environment.dingdingToken.to_s.strip.empty?
+
+        platform = PLATFORM_NAMES.fetch(@platform)
+        title = "#{@scheme} iOS · #{platform} · #{status}"
+        fields = {
+          '应用' => @scheme, 'Bundle ID' => Environment.bundleID, '分发平台' => platform,
+          '状态' => status, '版本' => @version, 'Build' => @build,
+          '打包方式' => @export_method, '构建配置' => @configuration
+        }.merge(details)
+        if Environment.dingding_include_install_password
+          fields['安装密码'] = password
+        end
+        fields['累计耗时'] = "#{(Process.clock_gettime(Process::CLOCK_MONOTONIC) - @started_at).round} 秒"
+        fields['通知时间'] = Time.now.strftime('%Y-%m-%d %H:%M:%S %:z')
+        sections = ["### #{failed ? '❌' : '📦'} #{markdown(title)}"]
+        sections << fields.map { |key, val| "- **#{key}**：#{markdown(val)}" unless val.to_s.strip.empty? }.compact.join("\n")
+        sections.concat(link_sections(links, qr_code))
+        unless @changelog.to_s.strip.empty?
+          # 为长更新日志留出消息空间；截断的是展示文案，不影响平台上传内容。
+          notes = @changelog.to_s[0, 1000]
+          notes += '…（更新说明已截断）' if @changelog.to_s.length > 1000
+          # 普通换行会被 Markdown 合并成段落；两个行尾空格明确要求换行。
+          # 仅格式化通知展示，兼容 CRLF，平台上传继续使用原始 changelog。
+          formatted_notes = markdown(notes).gsub(/\r\n?/, "\n").gsub("\n", "  \n")
+          sections << "**更新说明**\n\n#{formatted_notes}"
+        end
+        DingdingHelper.sendMarkdown(sections.join("\n\n"), title: title)
+      end
+
+      def link_sections(links, qr_code)
+        sections = links.map do |label, url|
+          safe = web_url(url)
+          "[#{label}](#{safe})" if safe
+        end.compact
+        qr_url = web_url(qr_code)
+        if qr_url
+          image_source = DingdingImageHelper.base64_source(qr_url)
+          sections << "**扫码安装**\n\n![安装二维码](#{image_source})" if image_source
+          sections << "[打开二维码](#{qr_url})"
+        end
+        sections
+      end
+
+      # 仅允许普通网页地址，避免返回值中的括号或凭据破坏 Markdown 链接。
+      def web_url(value)
+        url = value.to_s.strip
+        uri = URI.parse(url)
+        return unless %w[https http].include?(uri.scheme) && uri.host && !uri.userinfo
+        return if url.match?(/[\s<>]/)
+
+        url.gsub('(', '%28').gsub(')', '%29')
+      rescue URI::InvalidURIError
+        nil
+      end
+
+      def markdown(value)
+        CGI.escapeHTML(value.to_s).gsub(/[\\`*_\[\]#]/) { |char| "\\#{char}" }
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/fastci/version.rb

@@ -1,5 +1,5 @@
 module Fastlane
   module Fastci
-    VERSION = "0.0.40"
+    VERSION = "0.0.41"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-fastci
 version: !ruby/object:Gem::Version
-  version: 0.0.40
+  version: 0.0.41
 platform: ruby
 authors:
 - watermelon
@@ -107,9 +107,11 @@ files:
 - lib/fastlane/plugin/fastci/helper/common_helper.rb
 - lib/fastlane/plugin/fastci/helper/constants.rb
 - lib/fastlane/plugin/fastci/helper/dingding_helper.rb
+- lib/fastlane/plugin/fastci/helper/dingding_image_helper.rb
 - lib/fastlane/plugin/fastci/helper/environment.rb
 - lib/fastlane/plugin/fastci/helper/fastci_zealot_helper.rb
 - lib/fastlane/plugin/fastci/helper/fir_helper.rb
+- lib/fastlane/plugin/fastci/helper/package_notification_helper.rb
 - lib/fastlane/plugin/fastci/version.rb
 - lib/fastlane/plugin/python/generate_duplicity_code_html.py
 - lib/fastlane/plugin/python/generate_lint_html.py