pindo 5.12.2 → 5.13.2

data/lib/pindo/module/cert/{xcodecerthelper.rb → xcode_cert_helper.rb}

@@ -4,8 +4,139 @@ require 'pindo/base/aeshelper'
 
 module Pindo
 
-    module XcodeCertHelper
-        
+    class XcodeCertHelper
+
+        class << self
+
+        # 标准化构建类型
+        # @param build_type [String, Symbol] 构建类型 ('dev', 'adhoc', 'release', 'development', 'appstore')
+        # @return [String] 标准化后的证书类型 ('development', 'adhoc', 'appstore')
+        def normalize_build_type(build_type)
+            case build_type.to_s.downcase
+            when 'dev', 'development'
+                'development'
+            when 'adhoc'
+                'adhoc'
+            when 'release', 'appstore'
+                'appstore'
+            else
+                raise ArgumentError, "无效的构建类型: #{build_type}，支持的类型: dev/development, adhoc, release/appstore"
+            end
+        end
+
+        # 安装证书并配置 Xcode 工程
+        # @param build_type [String, Symbol] 构建类型 ('dev', 'adhoc', 'release' 或 'development', 'adhoc', 'appstore')
+        # @param platform_type [String] 平台类型 ('ios', 'macos')
+        # @param project_dir [String] 项目目录
+        # @param config_file [String, nil] 配置文件路径（可选，默认从 project_dir 加载）
+        # @param skip_xcode_config [Boolean] 是否跳过 Xcode 配置
+        # @return [Hash] 返回证书信息 { provisioning_info_array:, team_id: }
+        def install_and_config_certs(
+            build_type:,
+            platform_type: 'ios',
+            project_dir: Dir.pwd,
+            config_file: nil,
+            skip_xcode_config: false
+        )
+            # 标准化构建类型
+            cert_type = normalize_build_type(build_type)
+
+            # 配置加载
+            require 'pindo/config/ios_config_parser'
+            config_parser = Pindo::IosConfigParser.instance
+            config_path = config_file || File.join(project_dir, 'config.json')
+            config_parser.load_config(config_file: config_path)
+
+            apple_id = config_parser.apple_id
+            bundle_id_map = config_parser.get_bundle_id_map
+
+            # 安装证书
+            require 'pindo/config/pindoconfig'
+            require 'pindo/base/git_handler'
+            require 'pindo/module/cert/cert_helper'
+
+            pindo_config = Pindoconfig.instance
+
+            cert_git_url = apple_id.eql?(pindo_config.demo_apple_id) ?
+                          pindo_config.dev_cert_giturl :
+                          pindo_config.deploy_cert_giturl
+
+            cert_reponame = cert_git_url.split("/").last.chomp(".git")
+            certs_dir = Pindo::GitHandler.getcode_to_dir(
+                reponame: cert_reponame,
+                remote_url: cert_git_url,
+                path: pindo_config.pindo_dir,
+                new_branch: apple_id
+            )
+
+            # 安装证书和配置文件
+            Pindo::CertHelper.install_certs(
+                cert_url: cert_git_url,
+                certs_dir: certs_dir,
+                cert_type: cert_type,
+                platform_type: platform_type
+            )
+
+            provisioning_info_array = Pindo::CertHelper.install_provisionfiles(
+                cert_url: cert_git_url,
+                certs_dir: certs_dir,
+                bundle_id_map: bundle_id_map,
+                cert_type: cert_type,
+                platform_type: platform_type
+            )
+
+            pindo_config.set_cert_info(dict: provisioning_info_array)
+
+            raise Informative, "未找到证书信息" if provisioning_info_array.nil? || provisioning_info_array.empty?
+
+            team_id = provisioning_info_array.first["team_id"]
+
+            # Swark 授权检查
+            main_bundle_id = config_parser.bundle_id
+            if config_parser.config_json && main_bundle_id
+                require 'pindo/module/build/swark_helper'
+                Pindo::SwarkHelper.add_swark_authorize_json(
+                    build_type: cert_type,
+                    config_json: config_parser.config_json,
+                    team_id: team_id,
+                    bundle_id: main_bundle_id,
+                    deploy_repo_name: main_bundle_id
+                )
+            end
+
+            # 配置 Xcode 工程 (如果需要)
+            unless skip_xcode_config
+                project_fullname = Dir.glob(File.join(project_dir, "/*.xcodeproj")).max_by { |f| File.mtime(f) }
+                if project_fullname && File.exist?(project_fullname)
+                    proj_name = File.basename(project_fullname, ".xcodeproj")
+
+                    Funlog.instance.fancyinfo_start("正在给Xcode配置证书...")
+                    config_project_cert(
+                        new_proj_name: proj_name,
+                        new_project_dir: project_dir,
+                        cert_type: cert_type,
+                        platform_type: platform_type,
+                        team_id_vaule: team_id,
+                        provisioning_info_array: provisioning_info_array
+                    )
+
+                    config_infoplist_cert(
+                        new_proj_name: proj_name,
+                        new_project_dir: project_dir,
+                        icloud_id: config_parser.icloud_id,
+                        group_id: config_parser.group_id,
+                        provisioning_info_array: provisioning_info_array
+                    )
+                    Funlog.instance.fancyinfo_success("Xcode配置证书完成！")
+                end
+            end
+
+            {
+                provisioning_info_array: provisioning_info_array,
+                team_id: team_id
+            }
+        end
+
         def get_target_name_map
             return {
                 "MainTarget" => "bundle_id",
@@ -28,7 +159,9 @@ module Pindo
 
           provisioning_info_array = []
 
-          bundle_id_map = get_bundle_id_map
+          # 使用 IosConfigParser 单例获取 bundle_id_map
+          config_parser = Pindo::IosConfigParser.instance
+          bundle_id_map = config_parser.get_bundle_id_map
           
           bundle_id_map.each do |type, bundle_id_temp|
             provisioning_info = {}
@@ -224,7 +357,29 @@ module Pindo
                         end
 
                         if target.product_type.to_s.eql?(Xcodeproj::Constants::PRODUCT_TYPE_UTI[:application]) then
-                            add_swark_entitlement(entitlements_plist_path:entitlements_plist_path, bundle_id_dict:provisioning_info_array)
+                            # 调用 SwarkHelper 添加权限配置
+                            # 读取 config.json（如果存在）
+                            config_json = nil
+                            config_json_file = File.join(new_project_dir, "config.json")
+                            if File.exist?(config_json_file)
+                              config_json = JSON.parse(File.read(config_json_file))
+                            end
+
+                            # 获取 team_id 和 bundle_id
+                            team_id = provisioning_info_array.first["team_id"] if provisioning_info_array && provisioning_info_array.any?
+                            bundle_id = provisioning_info_array.first["bundle_id"] if provisioning_info_array && provisioning_info_array.any?
+
+                            if config_json && team_id && bundle_id
+                              require 'pindo/module/build/swark_helper'
+                              Pindo::SwarkHelper.add_swark_entitlement(
+                                entitlements_plist_path: entitlements_plist_path,
+                                bundle_id_dict: provisioning_info_array,
+                                config_json: config_json,
+                                team_id: team_id,
+                                bundle_id: bundle_id
+                              )
+                            end
+
                             if !icloud_id.nil?
                               modify_entitlements_plist(entitlements_plist_path:entitlements_plist_path, icloud_id:icloud_id)
                             end
@@ -315,6 +470,7 @@ module Pindo
         end
 
         def create_upload_cert_info(apple_id:nil, cert_type:nil, platform_type:nil)
+            pindo_single_config = Pindoconfig.instance
 
             cert_dest_dir = File.join(Dir.pwd, "cert")
             if !File.exist?(cert_dest_dir)
@@ -483,6 +639,52 @@ module Pindo
             return account_cert_set
         end
 
+        def get_create_cert_match_values(apple_id:nil, bundle_id_array:nil, build_type:nil, platform_type:nil, renew_flag:false)
+            pindo_single_config = Pindoconfig.instance
+
+            if build_type.eql?("appstore") && (apple_id.eql?(pindo_single_config.demo_apple_id))
+              raise Informative, "#{apple_id} 是测试账号，不能创建appstore证书!!!"
+            end
+            if !build_type.eql?("appstore") && !apple_id.eql?(pindo_single_config.demo_apple_id)
+              raise Informative, "账号#{apple_id} 不能创建dev或者adhoc证书!!!"
+            end
+
+            git_url = pindo_single_config.deploy_cert_giturl
+            if apple_id.eql?(pindo_single_config.demo_apple_id)
+              git_url = pindo_single_config.dev_cert_giturl
+            end
+
+            force_for_new_devices_flag = true
+            if build_type.eql?("appstore")
+              force_for_new_devices_flag = false
+            end
+
+            if platform_type.downcase.include?("macos") && build_type.eql?("adhoc")
+              build_type = "developer_id"
+            end
+
+            values = {
+              username:apple_id,
+              app_identifier: bundle_id_array,
+              type: build_type,
+              keychain_password:"goodcert1",
+              git_url: git_url,
+              readonly:!renew_flag,
+              force:renew_flag,
+              clone_branch_directly:!renew_flag,
+              include_mac_in_profiles:true,
+              include_all_certificates:true,
+              generate_apple_certs:true,
+              shallow_clone:!renew_flag,
+              git_branch: apple_id,
+              platform:platform_type,
+              force_for_new_devices:force_for_new_devices_flag
+            }
+            return values
+
+        end
+
+        end  # class << self
 
-    end
-end
+    end  # class XcodeCertHelper
+end  # module Pindo

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