pindo 5.13.1 → 5.13.3

data/lib/pindo/module/task/model/appstore/appstore_task.rb

@@ -0,0 +1,18 @@
+require_relative '../pindo_task'
+
+module Pindo
+  module TaskSystem
+    # App Store 任务基类
+    # 所有 App Store 相关任务的抽象基类
+    # 子类包括：AppStoreUploadIpaTask、AppStoreUploadMetadataTask、AppStoreUploadScreenshotTask
+    class AppStoreTask < PindoTask
+      # 空基类，仅用于类型标识
+      # 所有具体实现由子类完成
+
+      # 任务类型
+      def self.task_type
+        :appstore
+      end
+    end
+  end
+end

data/lib/pindo/module/task/model/appstore/appstore_upload_ipa_task.rb

@@ -0,0 +1,151 @@
+require_relative 'appstore_task'
+require_relative '../task_config'
+
+module Pindo
+  module TaskSystem
+    # App Store IPA 上传任务
+    # 上传 IPA 文件到 App Store Connect
+    class AppStoreUploadIpaTask < AppStoreTask
+      attr_reader :ipa_path, :ipa_file
+
+      # 重试配置
+      def self.default_retry_mode
+        RetryMode::DELAYED  # 延迟重试
+      end
+
+      def self.default_retry_count
+        3  # 默认可以重试 3 次
+      end
+
+      def self.default_retry_delay
+        30  # 默认延迟 30 秒（App Store 上传较慢）
+      end
+
+      # 初始化 IPA 上传任务
+      # @param ipa_path [String] 搜索 IPA 文件的路径
+      # @param ipa_file [String] 要上传的 IPA 文件（nil 表示自动查找）
+      # @param options [Hash] 选项
+      # @option options [String] :apple_id Apple ID（App Store Connect 账号）
+      # @option options [String] :app_password App专用密码或API Key
+      # @option options [String] :bundle_id Bundle ID
+      # @option options [Boolean] :skip_validation 是否跳过验证（默认 false）
+      # @option options [String] :platform 平台（ios/osx，默认 ios）
+      def initialize(ipa_path, ipa_file = nil, options = {})
+        @ipa_path = ipa_path          # 搜索 IPA 文件的路径
+        @ipa_file = ipa_file          # 要上传的 IPA 文件（nil 表示自动查找）
+
+        # App Store Connect 配置
+        @apple_id = options[:apple_id]
+        @app_password = options[:app_password]
+        @bundle_id = options[:bundle_id]
+        @skip_validation = options[:skip_validation] || false
+        @platform = options[:platform] || 'ios'
+
+        # 设置上传任务的优先级为 LOW，确保在构建任务之后执行
+        options[:priority] ||= TaskPriority::LOW
+
+        super("上传 IPA 到 App Store", options)
+      end
+
+      def validate
+        # 验证基本参数
+        unless @ipa_path && !@ipa_path.empty?
+          @error = "缺少必需参数: ipa_path"
+          return false
+        end
+
+        # IPA 文件会在 do_work 中查找，这里不验证
+
+        true
+      end
+
+      protected
+
+      def do_work
+        # 1. 确定上传的 IPA 文件
+        if @ipa_file && !@ipa_file.empty? && File.exist?(@ipa_file)
+          # 使用指定文件
+          file_to_upload = @ipa_file
+          puts "  使用指定的 IPA 文件: #{file_to_upload}"
+        else
+          # 在 ipa_path 下查找最新的 IPA 文件
+          file_to_upload = find_latest_ipa
+          unless file_to_upload && File.exist?(file_to_upload)
+            # 文件不存在，将重试次数设为 0，不再重试
+            @retry_count = 0
+            raise "未找到 IPA 文件（路径: #{@ipa_path}）"
+          end
+          puts "  找到 IPA 文件: #{file_to_upload}"
+        end
+
+        # 2. 上传到 App Store Connect
+        upload_to_appstore(file_to_upload)
+
+        {
+          success: true,
+          ipa_path: file_to_upload
+        }
+      end
+
+      private
+
+      # 在 ipa_path 下查找最新的 IPA 文件
+      def find_latest_ipa
+        search_pattern = File.join(@ipa_path, "**", "*.ipa")
+        ipa_files = Dir.glob(search_pattern)
+
+        if ipa_files.any?
+          # 返回修改时间最新的文件
+          latest_ipa = ipa_files.max_by { |f| File.mtime(f) }
+          return latest_ipa
+        end
+
+        nil
+      end
+
+      # 上传 IPA 到 App Store Connect
+      def upload_to_appstore(ipa_file)
+        puts "\n开始上传 IPA 到 App Store Connect..."
+        puts "  IPA 文件: #{ipa_file}"
+        puts "  Apple ID: #{@apple_id}" if @apple_id
+        puts "  Bundle ID: #{@bundle_id}" if @bundle_id
+        puts "  平台: #{@platform}"
+        puts "  跳过验证: #{@skip_validation}"
+
+        # 使用 xcrun altool 上传
+        upload_with_altool(ipa_file)
+
+        puts "✓ IPA 上传成功"
+      end
+
+      # 使用 xcrun altool 上传 IPA
+      def upload_with_altool(ipa_file)
+        # 构建 altool 命令
+        cmd = ["xcrun", "altool"]
+        cmd << "--upload-app"
+        cmd << "--type" << @platform
+        cmd << "--file" << ipa_file
+
+        # 添加认证参数
+        if @apple_id && @app_password
+          cmd << "--username" << @apple_id
+          cmd << "--password" << @app_password
+        end
+
+        # 跳过验证
+        if @skip_validation
+          cmd << "--skip-validation"
+        end
+
+        # 执行上传命令
+        puts "  执行命令: #{cmd.join(' ')}"
+
+        success = system(*cmd)
+
+        unless success
+          raise "上传失败：xcrun altool 命令执行出错（退出码: #{$?.exitstatus}）"
+        end
+      end
+    end
+  end
+end

data/lib/pindo/module/task/model/appstore/appstore_upload_metadata_task.rb

@@ -0,0 +1,250 @@
+require_relative 'appstore_task'
+require_relative '../task_config'
+
+module Pindo
+  module TaskSystem
+    # App Store Metadata 上传任务
+    # 上传应用元数据（名称、描述、关键词等）到 App Store Connect
+    class AppStoreUploadMetadataTask < AppStoreTask
+      attr_reader :app_id, :metadata_path
+
+      # 重试配置
+      def self.default_retry_mode
+        RetryMode::DELAYED  # 延迟重试
+      end
+
+      def self.default_retry_count
+        2  # 默认可以重试 2 次
+      end
+
+      def self.default_retry_delay
+        10  # 默认延迟 10 秒
+      end
+
+      # 初始化 Metadata 上传任务
+      # @param app_id [String] App Store Connect 应用 ID
+      # @param metadata_path [String] 元数据配置文件路径或目录
+      # @param options [Hash] 选项
+      # @option options [String] :apple_id Apple ID（App Store Connect 账号）
+      # @option options [String] :api_key_id API Key ID（使用 API Key 认证）
+      # @option options [String] :api_issuer_id API Issuer ID
+      # @option options [String] :api_key_path API Key 文件路径（.p8 文件）
+      # @option options [Hash] :metadata 元数据内容（如果不从文件读取）
+      # @option options [String] :locale 语言区域（默认 "zh-Hans"）
+      # @option options [Boolean] :skip_screenshots 是否跳过截图上传（默认 false）
+      def initialize(app_id, metadata_path = nil, options = {})
+        @app_id = app_id                  # App Store Connect 应用 ID
+        @metadata_path = metadata_path    # 元数据配置文件路径或目录
+
+        # App Store Connect 认证配置
+        @apple_id = options[:apple_id]
+        @api_key_id = options[:api_key_id]
+        @api_issuer_id = options[:api_issuer_id]
+        @api_key_path = options[:api_key_path]
+
+        # 元数据内容
+        @metadata = options[:metadata] || {}
+        @locale = options[:locale] || "zh-Hans"
+        @skip_screenshots = options[:skip_screenshots] || false
+
+        # 设置上传任务的优先级为 NORMAL
+        options[:priority] ||= TaskPriority::NORMAL
+
+        super("上传 Metadata 到 App Store", options)
+      end
+
+      def validate
+        # 验证基本参数
+        unless @app_id && !@app_id.empty?
+          @error = "缺少必需参数: app_id"
+          return false
+        end
+
+        # 验证认证信息（Apple ID 或 API Key）
+        has_apple_id_auth = @apple_id && !@apple_id.empty?
+        has_api_key_auth = @api_key_id && @api_issuer_id && @api_key_path
+
+        unless has_apple_id_auth || has_api_key_auth
+          @error = "缺少认证信息：需要提供 Apple ID 或 API Key"
+          return false
+        end
+
+        # 验证元数据来源
+        has_metadata_path = @metadata_path && !@metadata_path.empty?
+        has_metadata_content = @metadata && !@metadata.empty?
+
+        unless has_metadata_path || has_metadata_content
+          @error = "缺少元数据：需要提供 metadata_path 或 metadata 内容"
+          return false
+        end
+
+        true
+      end
+
+      protected
+
+      def do_work
+        # 1. 加载元数据
+        metadata_to_upload = load_metadata
+
+        # 2. 上传元数据到 App Store Connect
+        upload_metadata(metadata_to_upload)
+
+        {
+          success: true,
+          app_id: @app_id,
+          locale: @locale
+        }
+      end
+
+      private
+
+      # 加载元数据
+      def load_metadata
+        # 如果已经有元数据内容，直接使用
+        return @metadata unless @metadata.empty?
+
+        # 从文件或目录加载
+        if @metadata_path && File.exist?(@metadata_path)
+          if File.directory?(@metadata_path)
+            load_metadata_from_directory
+          else
+            load_metadata_from_file
+          end
+        else
+          raise "元数据路径不存在: #{@metadata_path}"
+        end
+      end
+
+      # 从目录加载元数据（Fastlane metadata 格式）
+      def load_metadata_from_directory
+        puts "  从目录加载元数据: #{@metadata_path}"
+
+        metadata = {}
+        locale_path = File.join(@metadata_path, @locale)
+
+        unless File.directory?(locale_path)
+          raise "未找到语言目录: #{locale_path}"
+        end
+
+        # 读取各个元数据文件
+        metadata_files = {
+          name: 'name.txt',
+          subtitle: 'subtitle.txt',
+          description: 'description.txt',
+          keywords: 'keywords.txt',
+          marketing_url: 'marketing_url.txt',
+          support_url: 'support_url.txt',
+          privacy_url: 'privacy_policy_url.txt',
+          promotional_text: 'promotional_text.txt',
+          release_notes: 'release_notes.txt'
+        }
+
+        metadata_files.each do |key, filename|
+          file_path = File.join(locale_path, filename)
+          if File.exist?(file_path)
+            content = File.read(file_path).strip
+            metadata[key] = content unless content.empty?
+          end
+        end
+
+        metadata
+      end
+
+      # 从 JSON/YAML 文件加载元数据
+      def load_metadata_from_file
+        puts "  从文件加载元数据: #{@metadata_path}"
+
+        case File.extname(@metadata_path)
+        when '.json'
+          require 'json'
+          JSON.parse(File.read(@metadata_path))
+        when '.yml', '.yaml'
+          require 'yaml'
+          YAML.load_file(@metadata_path)
+        else
+          raise "不支持的元数据文件格式: #{@metadata_path}"
+        end
+      end
+
+      # 上传元数据到 App Store Connect
+      def upload_metadata(metadata)
+        puts "\n开始上传 Metadata 到 App Store Connect..."
+        puts "  App ID: #{@app_id}"
+        puts "  语言区域: #{@locale}"
+        puts "  元数据项: #{metadata.keys.join(', ')}"
+
+        # 使用 Fastlane deliver 或 API 上传元数据
+        if use_api_key?
+          upload_with_api(metadata)
+        else
+          upload_with_fastlane(metadata)
+        end
+
+        puts "✓ Metadata 上传成功"
+      end
+
+      # 判断是否使用 API Key 认证
+      def use_api_key?
+        @api_key_id && @api_issuer_id && @api_key_path
+      end
+
+      # 使用 App Store Connect API 上传
+      def upload_with_api(metadata)
+        puts "  使用 App Store Connect API 上传..."
+
+        # 这里需要调用 App Store Connect API Helper
+        # require 'pindo/module/appstore/appstore_metadata_connect_api_helper'
+
+        # 示例实现（需要根据实际 Helper 调整）
+        # AppstoreMetadataConnectApiHelper.upload_metadata(
+        #   app_id: @app_id,
+        #   api_key_id: @api_key_id,
+        #   api_issuer_id: @api_issuer_id,
+        #   api_key_path: @api_key_path,
+        #   locale: @locale,
+        #   metadata: metadata
+        # )
+
+        # 临时占位实现
+        puts "  TODO: 实现 API 上传逻辑"
+        raise "API 上传功能尚未实现，请使用 Fastlane 方式"
+      end
+
+      # 使用 Fastlane deliver 上传
+      def upload_with_fastlane(metadata)
+        puts "  使用 Fastlane deliver 上传..."
+
+        # 构建 deliver 命令参数
+        fastlane_cmd = ["fastlane", "deliver"]
+        fastlane_cmd << "--app_identifier" << @app_id
+        fastlane_cmd << "--username" << @apple_id if @apple_id
+
+        # 如果有元数据路径，使用路径
+        if @metadata_path && File.exist?(@metadata_path)
+          fastlane_cmd << "--metadata_path" << @metadata_path
+        end
+
+        # 跳过截图
+        if @skip_screenshots
+          fastlane_cmd << "--skip_screenshots"
+        end
+
+        # 跳过二进制文件上传
+        fastlane_cmd << "--skip_binary_upload"
+
+        # 自动提交审核（可选）
+        # fastlane_cmd << "--submit_for_review"
+
+        # 执行命令
+        puts "  执行命令: #{fastlane_cmd.join(' ')}"
+
+        success = system(*fastlane_cmd)
+
+        unless success
+          raise "上传失败：Fastlane deliver 命令执行出错（退出码: #{$?.exitstatus}）"
+        end
+      end
+    end
+  end
+end

data/lib/pindo/module/task/model/appstore/appstore_upload_screenshot_task.rb

@@ -0,0 +1,276 @@
+require_relative 'appstore_task'
+require_relative '../task_config'
+
+module Pindo
+  module TaskSystem
+    # App Store Screenshot 上传任务
+    # 上传应用截图到 App Store Connect
+    class AppStoreUploadScreenshotTask < AppStoreTask
+      attr_reader :app_id, :screenshot_path
+
+      # 重试配置
+      def self.default_retry_mode
+        RetryMode::DELAYED  # 延迟重试
+      end
+
+      def self.default_retry_count
+        2  # 默认可以重试 2 次
+      end
+
+      def self.default_retry_delay
+        15  # 默认延迟 15 秒
+      end
+
+      # 初始化 Screenshot 上传任务
+      # @param app_id [String] App Store Connect 应用 ID
+      # @param screenshot_path [String] 截图目录路径
+      # @param options [Hash] 选项
+      # @option options [String] :apple_id Apple ID（App Store Connect 账号）
+      # @option options [String] :api_key_id API Key ID（使用 API Key 认证）
+      # @option options [String] :api_issuer_id API Issuer ID
+      # @option options [String] :api_key_path API Key 文件路径（.p8 文件）
+      # @option options [String] :locale 语言区域（默认 "zh-Hans"）
+      # @option options [Array<String>] :device_types 设备类型（如 ["iPhone 6.5", "iPad Pro"]）
+      # @option options [Boolean] :overwrite 是否覆盖已有截图（默认 false）
+      def initialize(app_id, screenshot_path, options = {})
+        @app_id = app_id                      # App Store Connect 应用 ID
+        @screenshot_path = screenshot_path    # 截图目录路径
+
+        # App Store Connect 认证配置
+        @apple_id = options[:apple_id]
+        @api_key_id = options[:api_key_id]
+        @api_issuer_id = options[:api_issuer_id]
+        @api_key_path = options[:api_key_path]
+
+        # 截图配置
+        @locale = options[:locale] || "zh-Hans"
+        @device_types = options[:device_types] || []
+        @overwrite = options[:overwrite] || false
+
+        # 设置上传任务的优先级为 LOW（截图上传可以最后执行）
+        options[:priority] ||= TaskPriority::LOW
+
+        super("上传 Screenshot 到 App Store", options)
+      end
+
+      def validate
+        # 验证基本参数
+        unless @app_id && !@app_id.empty?
+          @error = "缺少必需参数: app_id"
+          return false
+        end
+
+        unless @screenshot_path && !@screenshot_path.empty?
+          @error = "缺少必需参数: screenshot_path"
+          return false
+        end
+
+        # 验证截图路径
+        unless File.directory?(@screenshot_path)
+          @error = "截图路径不存在或不是目录: #{@screenshot_path}"
+          return false
+        end
+
+        # 验证认证信息（Apple ID 或 API Key）
+        has_apple_id_auth = @apple_id && !@apple_id.empty?
+        has_api_key_auth = @api_key_id && @api_issuer_id && @api_key_path
+
+        unless has_apple_id_auth || has_api_key_auth
+          @error = "缺少认证信息：需要提供 Apple ID 或 API Key"
+          return false
+        end
+
+        true
+      end
+
+      protected
+
+      def do_work
+        # 1. 扫描截图文件
+        screenshots = scan_screenshots
+
+        if screenshots.empty?
+          puts "  警告: 未找到任何截图文件"
+          return {
+            success: true,
+            app_id: @app_id,
+            screenshot_count: 0
+          }
+        end
+
+        # 2. 上传截图到 App Store Connect
+        upload_screenshots(screenshots)
+
+        {
+          success: true,
+          app_id: @app_id,
+          locale: @locale,
+          screenshot_count: screenshots.size
+        }
+      end
+
+      private
+
+      # 扫描截图文件
+      def scan_screenshots
+        puts "  扫描截图目录: #{@screenshot_path}"
+
+        screenshots = []
+
+        # 支持的截图格式
+        valid_extensions = ['.png', '.jpg', '.jpeg']
+
+        # 扫描目录结构
+        # 标准 Fastlane 结构: screenshots/{locale}/{device_type}/*.png
+        locale_path = File.join(@screenshot_path, @locale)
+
+        if File.directory?(locale_path)
+          # 有语言目录
+          scan_locale_directory(locale_path, screenshots, valid_extensions)
+        else
+          # 直接扫描根目录
+          scan_root_directory(@screenshot_path, screenshots, valid_extensions)
+        end
+
+        puts "  找到 #{screenshots.size} 个截图文件"
+        screenshots
+      end
+
+      # 扫描语言目录
+      def scan_locale_directory(locale_path, screenshots, valid_extensions)
+        # 遍历设备类型目录
+        Dir.glob(File.join(locale_path, "*")).each do |device_dir|
+          next unless File.directory?(device_dir)
+
+          device_type = File.basename(device_dir)
+
+          # 如果指定了设备类型，跳过不匹配的
+          unless @device_types.empty?
+            next unless @device_types.include?(device_type)
+          end
+
+          # 扫描设备目录下的截图
+          Dir.glob(File.join(device_dir, "*")).each do |file|
+            next unless File.file?(file)
+            next unless valid_extensions.include?(File.extname(file).downcase)
+
+            screenshots << {
+              path: file,
+              device_type: device_type,
+              locale: @locale,
+              filename: File.basename(file)
+            }
+          end
+        end
+      end
+
+      # 扫描根目录（无语言/设备分类）
+      def scan_root_directory(root_path, screenshots, valid_extensions)
+        Dir.glob(File.join(root_path, "**", "*")).each do |file|
+          next unless File.file?(file)
+          next unless valid_extensions.include?(File.extname(file).downcase)
+
+          screenshots << {
+            path: file,
+            device_type: 'unknown',
+            locale: @locale,
+            filename: File.basename(file)
+          }
+        end
+      end
+
+      # 上传截图到 App Store Connect
+      def upload_screenshots(screenshots)
+        puts "\n开始上传 Screenshot 到 App Store Connect..."
+        puts "  App ID: #{@app_id}"
+        puts "  语言区域: #{@locale}"
+        puts "  截图数量: #{screenshots.size}"
+        puts "  覆盖模式: #{@overwrite}"
+
+        # 按设备类型分组
+        screenshots_by_device = screenshots.group_by { |s| s[:device_type] }
+
+        screenshots_by_device.each do |device_type, device_screenshots|
+          puts "\n  上传 #{device_type} 截图 (#{device_screenshots.size} 张)..."
+
+          device_screenshots.each_with_index do |screenshot, index|
+            puts "    [#{index + 1}/#{device_screenshots.size}] #{screenshot[:filename]}"
+          end
+        end
+
+        # 使用 Fastlane deliver 或 API 上传截图
+        if use_api_key?
+          upload_with_api(screenshots)
+        else
+          upload_with_fastlane(screenshots)
+        end
+
+        puts "✓ Screenshot 上传成功"
+      end
+
+      # 判断是否使用 API Key 认证
+      def use_api_key?
+        @api_key_id && @api_issuer_id && @api_key_path
+      end
+
+      # 使用 App Store Connect API 上传
+      def upload_with_api(screenshots)
+        puts "  使用 App Store Connect API 上传..."
+
+        # 这里需要调用 App Store Connect API Helper
+        # require 'pindo/module/appstore/appstore_metadata_connect_api_helper'
+
+        # 示例实现（需要根据实际 Helper 调整）
+        # screenshots.each do |screenshot|
+        #   AppstoreMetadataConnectApiHelper.upload_screenshot(
+        #     app_id: @app_id,
+        #     api_key_id: @api_key_id,
+        #     api_issuer_id: @api_issuer_id,
+        #     api_key_path: @api_key_path,
+        #     locale: screenshot[:locale],
+        #     device_type: screenshot[:device_type],
+        #     screenshot_path: screenshot[:path],
+        #     overwrite: @overwrite
+        #   )
+        # end
+
+        # 临时占位实现
+        puts "  TODO: 实现 API 上传逻辑"
+        raise "API 上传功能尚未实现，请使用 Fastlane 方式"
+      end
+
+      # 使用 Fastlane deliver 上传
+      def upload_with_fastlane(screenshots)
+        puts "  使用 Fastlane deliver 上传..."
+
+        # 构建 deliver 命令参数
+        fastlane_cmd = ["fastlane", "deliver"]
+        fastlane_cmd << "--app_identifier" << @app_id
+        fastlane_cmd << "--username" << @apple_id if @apple_id
+
+        # 截图路径
+        fastlane_cmd << "--screenshots_path" << @screenshot_path
+
+        # 覆盖已有截图
+        if @overwrite
+          fastlane_cmd << "--overwrite_screenshots"
+        end
+
+        # 跳过元数据上传
+        fastlane_cmd << "--skip_metadata"
+
+        # 跳过二进制文件上传
+        fastlane_cmd << "--skip_binary_upload"
+
+        # 执行命令
+        puts "  执行命令: #{fastlane_cmd.join(' ')}"
+
+        success = system(*fastlane_cmd)
+
+        unless success
+          raise "上传失败：Fastlane deliver 命令执行出错（退出码: #{$?.exitstatus}）"
+        end
+      end
+    end
+  end
+end