pod-binary-pack 1.0.0

data/lib/core/cli.rb

@@ -0,0 +1,442 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'yaml'
+require 'fileutils'
+
+module Build
+  # 命令行入口：负责参数解析、读取工程配置、加载外部钩子/通知器、装配并启动构建
+  class CLI
+    CONFIG_TEMPLATE = <<~YAML
+      gitee:
+        endpoint: ""
+        access_token: ""
+
+      hooks_file: event.rb
+      sender_file: send.rb
+
+      # 例外组件配置(可选，普通组件无需声明)，key 为组件名；命令行同名参数优先级更高
+      # components:
+      #   SomeLib:
+      #     source_url: git@gitee.com:xxx/actual-repo.git   # 仓名与组件名不一致/一仓多组件
+      #     binary_url: git@gitee.com:xxx/actual-binary.git
+      #     podspec_path: SubDir/SomeLib.podspec                   # podspec不在仓根目录时的相对路径；不配置则自动递归扫描，歧义时报错
+      #     tag_prefix: "SomeLib/"                                # 一仓多组件时源码tag前缀(最终tag SomeLib/1.0.0)，二进制仍一组件一仓无需此前缀
+      #     subspecs: [Core, SQLCipher]                           # 仅集成指定subspec(短名，可含嵌套)，用于互斥subspec组件(如FMDB)；不配置默认集成全部
+
+      profiles:
+        default:
+          # 版本分支前缀：分支名形如 release_1.2.0 / release-1.2.0 时可缺省 --version 自动解析；
+          # 版本号不限段数并支持后缀(如 1.2.2.0 / 1.2.2-fix，含非法字符的不解析)；
+          # 显式传 --version 时必须与分支版本一致。改为其他前缀(如 ver)在此配置
+          release_branch_prefix: release
+          repos:
+            # 壳工程即打包工程：archive 打包与版本回写都在这个工程上完成
+            shell:
+              url: git@gitee.com:xxx/请替换为壳工程仓库.git
+              branch: master
+              workspace: 请替换为壳工程名.xcworkspace
+              scheme: 请替换为壳工程scheme名
+              # archive 仅为提取组件.framework，默认不签名(无需证书/Apple ID)
+              code_signing: false
+              development_team: ""
+            cocoapods_source:
+              url: git@gitee.com:xxx/cocoapods_static_source.git
+              branch: master
+            cocoapods_binary:
+              url: git@gitee.com:xxx/cocoapods_static_binary.git
+              branch: master
+            source_module:
+              # 组件仓地址模板，%{pod} 替换为组件名；命名不符模板的个别组件可用 --source-url 显式指定
+              url_template: "git@gitee.com:xxx/%{pod}.git"
+            binary_module:
+              # 同上，例外组件可用 --binary-url 显式指定
+              url_template: "git@gitee.com:xxx/%{pod}.git"
+              branch: master
+        fork_github:
+          mode: fork_github
+          repos:
+            shell:
+              url: git@gitee.com:xxx/请替换为壳工程仓库.git
+              branch: master
+              workspace: 请替换为壳工程名.xcworkspace
+              scheme: 请替换为壳工程scheme名
+              code_signing: false
+              development_team: ""
+            cocoapods_source:
+              url: git@gitee.com:xxx/cocoapods_static_source.git
+              branch: master
+            cocoapods_binary:
+              url: git@gitee.com:xxx/cocoapods_static_binary.git
+              branch: master
+            # fork 模式下源码镜像仓地址(由工具自动创建/同步上游 GitHub 源码)；例外组件可用 --source-url/--binary-url 显式指定
+            source_module:
+              url_template: "git@gitee.com:xxx/%{pod}.git"
+            binary_module:
+              url_template: "git@gitee.com:xxx/%{pod}.git"
+              branch: master
+    YAML
+
+    DEFAULT_CONFIG_PATH = 'config/build.yml'
+
+    def self.run(argv)
+      new.run(argv)
+    end
+
+    def fail(message)
+      Build.log.error(message)
+      exit(-1)
+    end
+
+    def parse_bool(value, name)
+      case value.to_s.strip.downcase
+      when 'true' then true
+      when 'false' then false
+      else fail "参数 --#{name} 只接受 true 或 false，当前值: #{value}"
+      end
+    end
+
+    def run(argv)
+      options = default_options
+      parser = build_parser(options)
+
+      begin
+        parser.parse!(argv)
+      rescue OptionParser::ParseError => e
+        Build.log.error("参数解析失败: #{e.message}\n\n")
+        puts parser
+        exit(-1)
+      end
+
+      Build.log.debug_enabled = options[:verbose]
+
+      if options[:help]
+        puts parser
+        exit(0)
+      end
+
+      if options[:init]
+        write_template(options[:config])
+        exit(0)
+      end
+
+      # SNAPSHOT 归一化：fork-github 三方库流程不支持 SNAPSHOT 包，
+      # 显式传 true 直接前置报错，未传时固定 false；自研组件未显式指定时默认 true
+      if options[:fork_github]
+        fail 'fork-github 三方库流程不支持 SNAPSHOT 包，请去掉 --snapshot true 或改为 false' if options[:snapshot_explicit] && options[:snapshot]
+        options[:snapshot] = false
+      elsif options[:snapshot].nil?
+        options[:snapshot] = true
+      end
+
+      # --merge-master 未显式指定时，按是否SNAPSHOT推导: SNAPSHOT包不合并，正式包合并
+      options[:merge_master] = !options[:snapshot] if options[:merge_master].nil?
+
+      options[:config] = resolve_config_path(options[:config])
+      yaml = load_yaml(options[:config])
+      config_dir = File.dirname(File.expand_path(options[:config]))
+      setup_token_env(yaml['gitee'])
+      load_extensions(yaml, config_dir)
+      profile = select_profile(yaml, options)
+      apply_component_overrides(options, yaml)
+
+      # 版本号解析依赖profile中的前缀配置，须在profile选定后进行
+      resolve_version(options, profile)
+      validate_options(options)
+
+      start_build(options, profile)
+    end
+
+    # 版本号解析与版本分支一致性校验：
+    #   - 显式传 --version 且分支符合 <前缀>_<版本>/<前缀>-<版本>：二者必须一致，否则报错停止
+    #   - 缺省 --version 且分支符合规则：从分支解析出版本号
+    #   - 其余情况(如master/普通特性分支)：仍要求显式传 --version
+    def resolve_version(options, profile)
+      prefix = profile.is_a?(Array) ? profile[1] : profile
+      prefix_value = prefix.is_a?(Hash) ? prefix['release_branch_prefix'] : nil
+      branch_version = Build::RepoModule.parse_version_from_branch(options[:branch], prefix_value)
+
+      if options[:version].to_s.strip.empty?
+        unless branch_version
+          fail "缺少 --version，且分支 '#{options[:branch]}' 不符合版本分支规则(形如 #{prefix_value || 'release'}_1.2.0 或 #{prefix_value || 'release'}-1.2.0；版本号不限段数并支持后缀，如 1.2.2.0、1.2.2-fix)，无法自动解析版本号"
+        end
+        options[:version] = branch_version
+        Build.log.detail("未传 --version，从版本分支 #{options[:branch]} 解析出版本号 #{branch_version}")
+      elsif branch_version && branch_version != options[:version].strip
+        fail "分支 #{options[:branch]} 解析出版本号 #{branch_version}，与传入的 --version #{options[:version]} 不一致，请保持相同或缺省 --version"
+      end
+    end
+
+    # build.yml 的 components 按组件名声明例外配置(仓名不符/podspec在子目录/一仓多组件/互斥subspec集成集合)，
+    # 命令行显式参数优先级高于配置文件
+    def apply_component_overrides(options, yaml)
+      cfg = (yaml['components'] || {})[options[:pod].to_s]
+      if cfg.is_a?(Hash)
+        { source_url: 'source_url', binary_url: 'binary_url',
+          podspec_path: 'podspec_path', tag_prefix: 'tag_prefix' }.each do |opt_key, cfg_key|
+          cfg_value = cfg[cfg_key].to_s.strip
+          options[opt_key] = cfg_value if options[opt_key].to_s.strip.empty? && !cfg_value.empty?
+        end
+        # subspecs：CLI 数组优先，否则取配置(必须是非空字符串数组)；规范化在 RepoModule 初始化统一处理
+        if options[:subspecs].nil? && cfg['subspecs'].is_a?(Array)
+          cfg_subspecs = cfg['subspecs'].map { |s| s.to_s.strip }.reject(&:empty?)
+          options[:subspecs] = cfg_subspecs unless cfg_subspecs.empty?
+        end
+        Build.log.detail("组件 #{options[:pod]} 命中 build.yml components 例外配置: #{cfg.keys.join('、')}") unless cfg.empty?
+      end
+
+      # tag前缀规范化：非空时统一补尾部'/'，最终源码tag形如 Foo/1.0.0
+      prefix = options[:tag_prefix].to_s.strip
+      options[:tag_prefix] = prefix.empty? || prefix.end_with?('/') ? (prefix.empty? ? nil : prefix) : "#{prefix}/"
+    end
+
+    def default_options
+      {
+        config: DEFAULT_CONFIG_PATH,
+        branch: 'master',
+        # nil 表示用户未显式传 --snapshot，归一化阶段再按组件类型决定默认值
+        # (自研组件默认 true，三方库强制 false)
+        snapshot: nil,
+        snapshot_explicit: false,
+        device: true,
+        simulator: true,
+        # nil 表示用户未显式指定，解析后按 snapshot 推导(SNAPSHOT不合并/正式包合并)
+        merge_master: nil,
+        force_cover: false,
+        publish_shell: false,
+        fork_github: false,
+        # 显式指定组件源码/二进制仓地址，非空时跳过 url_template 的 %{pod} 拼接，
+        # 用于仓库命名不符合模板约定(拼接路径不正确)的个别组件
+        source_url: nil,
+        binary_url: nil,
+        # podspec相对源码仓根目录的路径(podspec不在根目录时使用)；一仓多组件时源码tag前缀(如 Foo/)
+        podspec_path: nil,
+        tag_prefix: nil,
+        # 仅集成指定subspec(数组短名)；nil=默认集成全部，用于互斥subspec组件(如FMDB)
+        subspecs: nil,
+        build_url: '',
+        profile: nil,
+        verbose: false
+      }
+    end
+
+    def build_parser(options)
+      OptionParser.new do |opts|
+        opts.banner = '用法: ruby setup.rb --pod 组件名 --version 版本号 [选项]'
+        opts.on('--pod NAME', '必填，组件名') { |v| options[:pod] = v }
+        opts.on('--version VER', '组件版本号(不带SNAPSHOT)；使用版本分支(如release_1.2.0)时可缺省，自动从分支解析') { |v| options[:version] = v }
+        opts.on('--branch BRANCH', '源码仓库分支/tag，默认 master') { |v| options[:branch] = v }
+        opts.on('--snapshot true|false', '是否SNAPSHOT包，自研组件默认 true；fork-github 三方库流程固定 false，显式传 true 会报错') do |v|
+          options[:snapshot] = parse_bool(v, 'snapshot')
+          options[:snapshot_explicit] = true
+        end
+        opts.on('--device true|false', '是否构建真机包，默认 true') { |v| options[:device] = parse_bool(v, 'device') }
+        opts.on('--simulator true|false', '是否构建模拟器包，默认 true') { |v| options[:simulator] = parse_bool(v, 'simulator') }
+        opts.on('--merge-master true|false', '是否合并到master，默认跟随SNAPSHOT(SNAPSHOT包不合并，正式包合并)') { |v| options[:merge_master] = parse_bool(v, 'merge-master') }
+        opts.on('--force-cover true|false', '是否强制覆盖发布，默认 false') { |v| options[:force_cover] = parse_bool(v, 'force-cover') }
+        opts.on('--publish-shell true|false', '是否发布到壳工程，默认 false') { |v| options[:publish_shell] = parse_bool(v, 'publish-shell') }
+        opts.on('--fork-github', '三方库GitHub fork模式：自动解析podspec并fork上游源码') { options[:fork_github] = true }
+        opts.on('--source-url URL', '显式指定组件源码仓地址，覆盖 source_module.url_template 拼接(用于命名不符合模板的组件/一仓多组件)') { |v| options[:source_url] = v }
+        opts.on('--binary-url URL', '显式指定组件二进制仓地址，覆盖 binary_module.url_template 拼接(用于命名不符合模板的组件)') { |v| options[:binary_url] = v }
+        opts.on('--podspec-path PATH', 'podspec相对源码仓根目录的路径(如 SubDir/Foo.podspec)；不传时根目录约定优先，找不到自动递归扫描，歧义时报错') { |v| options[:podspec_path] = v }
+        opts.on('--tag-prefix PREFIX', '一仓多组件时的源码tag前缀(如 Foo/，最终tag为 Foo/1.0.0)，默认无前缀') { |v| options[:tag_prefix] = v }
+        opts.on('--subspecs A,B', '仅集成指定subspec(逗号分隔短名，如 Core,SQLCipher)，用于互斥subspec组件；默认集成全部') do |v|
+          subspecs = v.to_s.split(/[,.，、]/).map { |s| s.strip }.reject(&:empty?)
+          options[:subspecs] = subspecs unless subspecs.empty?
+        end
+        opts.on('--profile NAME', '使用配置文件中的指定profile，默认按模式自动选择') { |v| options[:profile] = v }
+        opts.on('--build-url URL', '构建地址(用于通知文案跳转，Jenkins作业/web平台触发时各自传入)', ) { |v| options[:build_url] = v }
+        opts.on('--config PATH', "环境配置文件，默认 #{DEFAULT_CONFIG_PATH}") { |v| options[:config] = v }
+        opts.on('--verbose', '输出调试细节(git命令、网络响应等)，也可用环境变量 POD_BINARY_PACK_VERBOSE=1') { options[:verbose] = true }
+        opts.on('--init', '在 --config 指定位置生成配置模板并退出') { options[:init] = true }
+        opts.on('-h', '--help', '查看帮助') { options[:help] = true }
+      end
+    end
+
+    def validate_options(options)
+      missing = []
+      missing << '--pod' if options[:pod].to_s.empty?
+      missing << '--version' if options[:version].to_s.empty?
+      if !missing.empty?
+        Build.log.error("缺少必填参数: #{missing.join('、')}\n\n")
+        puts build_parser(options)
+        exit(-1)
+      end
+
+      fail 'SNAPSHOT包发布不能同时选择合并到master分支(--snapshot=true 时 --merge-master 必须为 false)' if options[:snapshot] && options[:merge_master]
+      fail '版本号里不能带SNAPSHOT，SNAPSHOT请通过 --snapshot true 指定' if options[:version].include?('SNAPSHOT')
+    end
+
+    def write_template(path)
+      fail "配置文件已存在，为避免覆盖请先手动处理: #{path}" if File.exist?(path)
+      FileUtils.mkdir_p(File.dirname(File.expand_path(path)))
+      File.write(path, CONFIG_TEMPLATE)
+      Build.log.success("已生成配置模板: #{File.expand_path(path)}")
+      Build.log.info('   请填写各仓库地址(尤其是 shell.url)后重新执行')
+    end
+
+    def resolve_config_path(path)
+      # 使用默认配置且当前目录找不到时，兼容在上一级目录(如仓库内的 test/ 子目录)运行
+      if path == DEFAULT_CONFIG_PATH && !File.exist?(path) && File.exist?(File.join('..', DEFAULT_CONFIG_PATH))
+        File.join('..', DEFAULT_CONFIG_PATH)
+      else
+        path
+      end
+    end
+
+    def load_yaml(path)
+      fail "环境配置文件不存在: #{path}，可先执行 ruby setup.rb --init 生成模板" unless File.exist?(path)
+      YAML.load_file(path) || {}
+    end
+
+    def setup_token_env(gitee)
+      return unless gitee.is_a?(Hash)
+      ENV['GITEE_ACCESS_TOKEN'] = gitee['access_token'].to_s unless gitee['access_token'].to_s.strip.empty?
+      ENV['GITEE_API_URL'] = gitee['endpoint'].to_s unless gitee['endpoint'].to_s.strip.empty?
+    end
+
+    def load_extensions(yaml, config_dir)
+      hooks_file = yaml['hooks_file'].to_s
+      unless hooks_file.empty?
+        require File.expand_path(hooks_file, config_dir)
+        Build.log.detail("已加载钩子文件: #{hooks_file}")
+      end
+
+      @sender = nil
+      sender_file = yaml['sender_file'].to_s
+      unless sender_file.empty?
+        require File.expand_path(sender_file, config_dir)
+        @sender = Object.const_get('Send').new
+        Build.log.detail("已加载通知器: #{sender_file}")
+      end
+    end
+
+    def select_profile(yaml, options)
+      name = options[:profile] || (options[:fork_github] ? 'fork_github' : 'default')
+      profiles = yaml['profiles'] || {}
+      profile = profiles[name]
+      fail "配置文件中缺少 profile: #{name}" unless profile.is_a?(Hash)
+      [name, profile]
+    end
+
+    def repo_url(profile, key)
+      repo = (profile['repos'] || {})[key]
+      fail "配置文件 profile(#{profile_name_current}) 缺少 repos.#{key}" unless repo.is_a?(Hash)
+      url = repo['url'].to_s
+      fail "请先在配置文件中填写 repos.#{key}.url" if url.strip.empty?
+      repo
+    end
+
+    def repo_template(profile, key)
+      repo = (profile['repos'] || {})[key]
+      fail "配置文件 profile(#{profile_name_current}) 缺少 repos.#{key}" unless repo.is_a?(Hash)
+      template = repo['url_template'].to_s
+      fail "请先在配置文件中填写 repos.#{key}.url_template" if template.strip.empty?
+      repo
+    end
+
+    def profile_name_current
+      @current_profile_name || 'default'
+    end
+
+    # 解析组件仓地址：命令行显式地址优先(用于命名不符合 url_template 约定的组件)，
+    # 未传时按模板用组件名拼接
+    def resolve_module_url(explicit_url, template, pod_name, option_name)
+      url = explicit_url.to_s.strip
+      if url.empty?
+        fail "请在配置文件填写 url_template，或通过 --#{option_name} 显式指定仓库地址" if template.to_s.strip.empty?
+        format(template, pod: pod_name)
+      else
+        Build.log.detail("参数 --#{option_name} 显式指定仓库地址，跳过 url_template 拼接: #{url}")
+        url
+      end
+    end
+
+    def start_build(options, profile_tuple)
+      @current_profile_name, profile = profile_tuple
+      fork_mode = options[:fork_github] || profile['mode'] == 'fork_github'
+
+      cocoapods_source_cfg = repo_url(profile, 'cocoapods_source')
+      cocoapods_binary_cfg = repo_url(profile, 'cocoapods_binary')
+      shell_cfg = repo_url(profile, 'shell')
+      source_cfg = repo_template(profile, 'source_module')
+      binary_cfg = repo_template(profile, 'binary_module')
+
+      shell_workspace = shell_cfg['workspace'].to_s.strip
+      shell_scheme = shell_cfg['scheme'].to_s.strip
+      fail '请在配置文件中填写 repos.shell.workspace(壳工程 xcworkspace 名称)' if shell_workspace.empty?
+      fail '请在配置文件中填写 repos.shell.scheme(壳工程打包 scheme 名称)' if shell_scheme.empty?
+
+      config = Build::Config.instance
+      config.build_url = options[:build_url]
+
+      repo_cocoapods_source = Build::RepoCocoapods.new(
+        config.cocoapods_source_path,
+        cocoapods_source_cfg['url'],
+        cocoapods_source_cfg['branch'] || 'master'
+      )
+      repo_cocoapods_binary = Build::RepoCocoapods.new(
+        config.cocoapods_binary_path,
+        cocoapods_binary_cfg['url'],
+        cocoapods_binary_cfg['branch'] || 'master'
+      )
+      auto_build = Build::AutoBuild.new(config, repo_cocoapods_source, repo_cocoapods_binary)
+
+      pod_name = options[:pod]
+      pod_version = options[:version]
+
+      if fork_mode
+        github_helper = Build::GithubHelper.instance
+        github_helper.request_podspec(config.podspec_github_path, pod_name, pod_version)
+        source_repo_url = resolve_module_url(options[:source_url], source_cfg['url_template'], pod_name, 'source-url')
+        source_repo_branch = github_helper.github_tag
+        # 内部"三方库处理"标记(不锁分支/不改版本tag等)，仅 fork-github 流程启用
+        third = 'true'
+        fork = true
+        snapshot = false
+        merge_master = false
+        Build.log.detail("三方库fork模式：源码 #{source_repo_url} 分支/tag #{source_repo_branch}")
+      else
+        source_repo_url = resolve_module_url(options[:source_url], source_cfg['url_template'], pod_name, 'source-url')
+        source_repo_branch = options[:branch]
+        third = 'false'
+        fork = false
+        snapshot = options[:snapshot]
+        merge_master = options[:merge_master]
+      end
+
+      binary_repo_url = resolve_module_url(options[:binary_url], binary_cfg['url_template'], pod_name, 'binary-url')
+      binary_repo_branch = binary_cfg['branch'] || 'master'
+
+      repo_shell = Build::RepoXCodeShell.new(
+        config.xcode_shell_path, shell_cfg['url'], shell_cfg['branch'] || 'master',
+        shell_workspace, shell_scheme,
+        code_signing: shell_cfg['code_signing'] == true,
+        development_team: shell_cfg['development_team'].to_s.strip.empty? ? nil : shell_cfg['development_team'].to_s.strip
+      )
+      build_item = Build::BuildItem.new(
+        snapshot,
+        options[:device],
+        options[:simulator],
+        merge_master,
+        options[:force_cover],
+        options[:publish_shell],
+        fork
+      )
+      release_prefix = profile.is_a?(Hash) ? profile['release_branch_prefix'] : nil
+      repo_module_source = Build::RepoModuleSource.new(
+        config.module_source_path, source_repo_url, source_repo_branch,
+        pod_name, pod_version, third, build_item,
+        podspec_rel_path: options[:podspec_path], tag_prefix: options[:tag_prefix],
+        release_branch_prefix: release_prefix,
+        build_subspecs: options[:subspecs]
+      )
+      repo_module_binary = Build::RepoModuleBinary.new(
+        config.module_binary_path, binary_repo_url, binary_repo_branch,
+        pod_name, pod_version, third, build_item
+      )
+
+      auto_build.run(repo_shell, repo_module_source, repo_module_binary, build_item, @sender)
+    end
+  end
+end

data/lib/core/commit.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+module Build
+  class Commit
+    # @return [String] 最新的提交ID
+    attr_accessor :commit_id
+
+    # @return [String] 最新的提交者
+    attr_accessor :committer
+
+    # @return [String] 最新的提交者邮箱
+    attr_accessor :commit_mail
+
+    # @return [String] 最新的提交信息
+    attr_accessor :commit_msg
+
+    # @return [String] 最新的提交时间
+    attr_accessor :commit_time
+  end
+end

data/lib/core/config.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+require 'singleton'
+
+module Build
+  class Config
+    include Singleton
+
+    # @return [String] 构建地址(通知文案跳转用，由触发方传入：Jenkins作业/web平台构建详情页)
+    attr_accessor :build_url
+
+    def initialize
+      super
+      init_workspace
+    end
+
+    def work_dir
+      FileUtils.pwd + "/BuildWorkspace"
+    end
+
+    # 壳工程(同时承担打包，全流程只 clone 一次)
+    def xcode_shell_path
+      "#{work_dir}/XcodeShell"
+    end
+
+    def cocoapods_source_path
+      "#{work_dir}/CocoapodsSource"
+    end
+
+    def cocoapods_binary_path
+      "#{work_dir}/CocoapodsBinary"
+    end
+
+    def module_source_path
+      "#{work_dir}/ModuleSource"
+    end
+
+    def module_binary_path
+      "#{work_dir}/ModuleBinary"
+    end
+
+    def podspec_github_path
+      "#{work_dir}/PodspecGithub"
+    end
+
+    def module_github_path
+      "#{work_dir}/ModuleGithub"
+    end
+
+    def init_workspace
+      Build.log.step("准备工作目录:#{work_dir}")
+      FileUtils.rm_rf(work_dir)
+      Dir.mkdir(work_dir)
+    end
+
+  end
+end

data/lib/core/cost.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+module Build
+
+  class Cost
+    # @return [Integer] 耗时 单位秒
+    attr_accessor :duration
+
+    # @return [String] 描述
+    attr_accessor :description
+
+    def initialize(description, duration)
+      @description = description
+      @duration= duration
+    end
+
+  end
+
+  class Log
+
+    attr_accessor :cost_array
+
+    attr_accessor :last_time
+
+    attr_accessor :start_time
+
+    # @return [Integer] 总体耗费时间
+    attr_accessor :cost_time
+
+    def initialize
+      @cost_array = Array.new
+      @start_time = Time.now.getutc.to_i
+      @last_time = Time.now.getutc.to_i
+    end
+
+    # 添加一条耗时
+    def record_time(description)
+
+      current_time =  Time.now.getutc.to_i
+      duration = current_time - last_time
+
+      cost = Cost.new(description, duration)
+      cost_array << cost
+
+      @last_time = current_time
+
+    end
+
+    def end_record_time(description)
+      current_time =  Time.now.getutc.to_i
+      duration = current_time - start_time
+      @cost_time = duration
+
+      cost = Cost.new(description, duration)
+      cost_array << cost
+
+      @last_time = current_time
+    end
+
+    # 打印耗时
+    def print_cost
+      Build.log.step("打印各阶段耗时:")
+      cost_array.each do |cost|
+        Build.log.info("#{cost.description}耗时: #{cost.duration}秒")
+      end
+    end
+
+  end
+end