fastlane-plugin-fastci 0.0.30 → 0.0.41

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

@@ -0,0 +1,300 @@
+require 'fastlane/action'
+require 'fastlane/plugin/fastci/helper/app_store_resources_helper'
+include Fastlane::Helper
+
+module Fastlane
+  module Actions
+    # 校验并上传 App Store Connect metadata 和截图
+    class AppStoreResourcesAction < Action
+      # 独立资源入口：准备资源 -> 上传 -> 可选构建选择 -> 可选提交审核，全程不上传 IPA。
+      def self.run(params)
+        return nil unless resources_enabled?(params)
+
+        params = prepare_resources(params)
+        upload_resources(params)
+        select_build_and_submit_review(params)
+      end
+
+      # 总开关先于配置读取和认证检查，单独指定路径或资源子开关不能启用此能力。
+      def self.resources_enabled?(params)
+        return true if params[:app_store_resources_enabled] == true
+
+        UI.message('*************| 商店资源功能未开启，跳过（APP_STORE_RESOURCES_ENABLED=false）|*************')
+        false
+      end
+
+      # 统一读取配置、建立认证并准备资源目录，下载与校验规则由 Helper 负责。
+      def self.prepare_resources(params)
+        params = AppStoreResourcesHelper.load_params(params)
+        params.merge!(AppStoreResourcesHelper.authentication_options(params, other_action))
+        AppStoreResourcesHelper.prepare(params)
+      end
+
+      # 只上传配置指定的资源类别，无资源变化时跳过上传。
+      def self.upload_resources(params)
+        if params[:metadata_changed] || params[:screenshots_changed]
+          UI.message('*************| 开始上传 App Store Connect 资源 |*************')
+          other_action.upload_to_app_store(
+            AppStoreResourcesHelper.resource_options(params, params[:metadata_path], params[:screenshots_path])
+          )
+          UI.success('App Store Connect 资源上传完成')
+        else
+          UI.message('*************| 没有 metadata 或截图变更，跳过资源上传 |*************')
+        end
+      end
+
+      # 资源上传完成后，按配置选择精确构建并提交审核；两个步骤默认均不执行。
+      def self.select_build_and_submit_review(params)
+        # 提交审核也必须先确认精确构建，不能依赖 deliver 自动选择最新 Build。
+        if params[:select_build] || params[:submit_for_review]
+          AppStoreResourcesHelper.select_build(params)
+        end
+
+        if params[:submit_for_review]
+          UI.message('*************| 开始提交 App Store 审核 |*************')
+          other_action.upload_to_app_store(AppStoreResourcesHelper.review_options(params))
+          UI.success('App Store 审核提交完成')
+        end
+      end
+
+      private_class_method :resources_enabled?, :prepare_resources, :upload_resources, :select_build_and_submit_review
+
+      def self.description
+        '校验并上传 App Store Connect metadata 和截图'
+      end
+
+      # JSON 合并后也通过这组参数校验，使文件配置与直接调用拥有相同约束。
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :app_store_resources_enabled,
+            env_name: 'APP_STORE_RESOURCES_ENABLED',
+            description: '商店资源总开关，必须显式开启后才能使用资源上传、下载及发布流程',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :config_path,
+            env_name: 'APP_STORE_RESOURCES_CONFIG_PATH',
+            description: '资源发布 JSON 配置文件路径，显式参数优先于配置文件',
+            optional: true,
+            default_value: nil,
+            # 路径校验由开启后的 load_params 执行，关闭功能时不读取或校验资源文件。
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :app_identifier,
+            description: 'App Store Connect App 的 Bundle ID',
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :app_version,
+            description: '要更新的 App Store 版本号',
+            optional: true,
+            default_value: nil,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :metadata_path,
+            description: 'metadata 目录路径',
+            optional: true,
+            default_value: 'fastlane/metadata',
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :screenshots_path,
+            description: '截图目录路径',
+            optional: true,
+            default_value: 'fastlane/screenshots',
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :metadata_changed,
+            description: '是否上传 metadata',
+            optional: true,
+            default_value: true,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :screenshots_changed,
+            description: '是否上传截图',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :upload_metadata_on_new_version,
+            description: '目标 App Store 版本不存在时是否强制上传 metadata',
+            optional: true,
+            default_value: true,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :download_missing_metadata,
+            description: 'metadata 缺失时是否从 App Store Connect 下载',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :download_missing_screenshots,
+            description: '截图缺失时是否从 App Store Connect 下载',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :use_live_version,
+            description: '下载截图时是否使用线上版本',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :api_key,
+            description: 'App Store Connect API Key Hash',
+            optional: true,
+            sensitive: true,
+            type: Hash,
+            conflicting_options: [:api_key_path]
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :api_key_path,
+            description: 'App Store Connect API Key JSON 文件路径',
+            optional: true,
+            type: String,
+            conflicting_options: [:api_key],
+            verify_block: proc do |value|
+              UI.user_error!("API Key JSON 不存在: #{value}") unless File.file?(value)
+            end
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :username,
+            description: 'Apple ID 用户名，仅在未提供 API Key 时使用',
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :platform,
+            description: 'App Store Connect 平台',
+            optional: true,
+            default_value: 'ios',
+            type: String,
+            verify_block: proc { |value| UI.user_error!('资源上传仅支持 ios 平台') unless value == 'ios' }
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :sync_screenshots,
+            description: '是否让远端截图与本地截图同步',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :overwrite_screenshots,
+            description: '上传前是否清空远端截图',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :submit_for_review,
+            description: '上传资源后是否提交审核',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :automatic_release,
+            description: '审核通过后是否自动发布',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :select_build,
+            description: '是否按 app_version 和 build_number 自动选择构建',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :build_number,
+            description: '要选择的精确 Build Number',
+            optional: true,
+            default_value: nil,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :wait_for_build_processing,
+            description: '选择构建前是否等待 App Store Connect 处理完成',
+            optional: true,
+            default_value: true,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :build_processing_timeout,
+            description: '等待构建处理完成的超时时间，单位秒',
+            optional: true,
+            default_value: 3600,
+            type: Integer,
+            verify_block: proc { |value| UI.user_error!('构建处理超时必须大于 0') unless value.positive? }
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :build_processing_poll_interval,
+            description: '查询构建处理状态的时间间隔，单位秒',
+            optional: true,
+            default_value: 30,
+            type: Integer,
+            verify_block: proc { |value| UI.user_error!('构建轮询间隔必须大于 0') unless value.positive? }
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :build_processing_retry_limit,
+            description: '查询构建处理状态遇到网络错误时的最大重试次数',
+            optional: true,
+            default_value: 3,
+            type: Integer,
+            verify_block: proc { |value| UI.user_error!('构建查询重试次数不能小于 0') if value.negative? }
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :build_processing_retry_interval,
+            description: '查询构建处理状态网络错误后的重试等待时间，单位秒',
+            optional: true,
+            default_value: 15,
+            type: Integer,
+            verify_block: proc { |value| UI.user_error!('构建查询重试间隔不能小于 0') if value.negative? }
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :submission_information,
+            description: 'deliver 提交审核信息，例如出口合规声明',
+            optional: true,
+            default_value: nil,
+            type: Hash
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :release_notes,
+            description: '按语言配置的更新说明；优先于 metadata 中的 release_notes.txt',
+            optional: true,
+            type: Hash
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :force,
+            description: '是否跳过 HTML 预览确认',
+            optional: true,
+            default_value: true,
+            type: Boolean
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        platform == :ios
+      end
+
+      def self.category
+        :production
+      end
+    end
+  end
+end

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

@@ -1,6 +1,8 @@
 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
@@ -8,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
-        release_notes = params[:release_notes] || ''
+        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}/*"))
@@ -52,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 }
@@ -65,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
@@ -119,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}")
@@ -140,139 +131,153 @@ 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 CommonHelper.is_validate_string(Environment.connect_key_id) && CommonHelper.is_validate_string(Environment.connect_issuer_id)
-            # 根据 export_method 决定是否为 TestFlight
-            is_test_flight = export_method == 'testFlight'
-
-            other_action.upload_store(
-              release_notes: release_notes,
-              isTestFlight: is_test_flight
-            )
-            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 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
 
-        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('*************| 跳过代码检查 |*************')
+      # 仅统计实际调用的检查，商店包跳过检查时不发送“检查完成”。
+      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
 
-        UI.message('*************| 脚本完成 |*************')
+      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')
+        options = {
+          release_notes: params[:release_notes] || '',
+          isTestFlight: export_method == 'testFlight',
+          # 显式透传 false，避免下层 Action 从环境变量重新开启本次已关闭的功能。
+          app_store_resources_enabled: !config_path.nil?
+        }
+        options[:app_store_resources_config_path] = config_path if config_path
+        options
+      end
+
+      # 根据凭据或已开启的资源配置判断是否上传，单独存在资源路径不能触发上传。
+      def self.store_upload_configured?(options)
+        has_p8_key = CommonHelper.is_validate_string(Environment.connect_key_id) &&
+          CommonHelper.is_validate_string(Environment.connect_issuer_id)
+        has_api_key_json = CommonHelper.is_validate_string(Environment.app_store_connect_api_key_path)
+        has_p8_key || has_api_key_json || options[:app_store_resources_enabled]
       end
 
+      # 上传本次产物，并返回是否执行了上传，供主流程决定是否发送完成通知。
+      def self.upload_store_if_configured(options, version:, build:)
+        return false unless store_upload_configured?(options)
+
+        upload_options = options.dup
+        if upload_options[:app_store_resources_enabled]
+          # 使用真实产物信息覆盖资源配置，避免选中 JSON 中残留的旧版本或 Build。
+          upload_options.merge!(
+            app_identifier: Environment.bundleID,
+            app_version: version.to_s,
+            build_number: build.to_s
+          )
+        end
+        other_action.upload_store(upload_options)
+        true
+      end
+
+      private_class_method :store_upload_options, :store_upload_configured?, :upload_store_if_configured
+
       def self.description
         '打包'
       end
 
       def self.available_options
         [
+          FastlaneCore::ConfigItem.new(
+            key: :app_store_resources_enabled,
+            env_name: 'APP_STORE_RESOURCES_ENABLED',
+            description: '商店资源总开关，默认关闭，仅 app-store 打包时生效',
+            optional: true,
+            default_value: false,
+            type: Boolean
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :app_store_resources_config_path,
+            env_name: 'APP_STORE_RESOURCES_CONFIG_PATH',
+            description: 'App Store 资源发布 JSON 路径，开启商店资源总开关后必填',
+            optional: true,
+            type: String
+          ),
           FastlaneCore::ConfigItem.new(
             key: :is_upload_zealot_dsym,
             env_name: 'ZEALOT_UPLOAD_DSYM',