pod-binary-pack 1.0.0

data/lib/core/hosting/provider.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require 'singleton'
+require_relative '../push'
+
+module Build
+  module Hosting
+    # 代码托管平台的仓库描述
+    # @!attribute id Gitee无数字ID概念，该字段仅GitLab使用
+    # @!attribute full_name 平台上的完整仓库路径，如 xxx/YYModel
+    # @!attribute namespace_path 命名空间路径，如 xxx
+    RepoInfo = Struct.new(:id, :full_name, :namespace_path, keyword_init: true)
+
+    # 代码托管平台抽象层
+    # GitLab/Gitee/不支持平台各自实现该接口，业务层不感知具体平台
+    class Provider
+      # @return [Push] 推送能力
+      def pusher
+        @pusher || Push.instance
+      end
+
+      attr_writer :pusher
+
+      # @return [Boolean] 当前平台的API能力是否可用
+      def available?
+        false
+      end
+
+      # 检查仓库是否存在，不存在则自动创建
+      # @param project_name [String] 组件/仓库名
+      # @param http_url [String] 仓库http地址
+      # @param private [Boolean] 是否私有仓库，固定默认私有
+      # @param description [String] 仓库描述
+      def create_project_if_need(project_name, http_url, private: true, description: nil)
+        raise NotImplementedError
+      end
+
+      # 查询仓库信息
+      # @return [Build::Hosting::RepoInfo, nil]
+      def find_project(pod_name, http_url, can_raise: true)
+        raise NotImplementedError
+      end
+
+      # 锁死(保护)发布分支
+      # @param repo_info [Build::Hosting::RepoInfo]
+      # @param branch [String] 分支名
+      # @param page_url [String] 仓库网页地址
+      # @return [String] 分支保护设置页地址
+      def lock_branch(repo_info, branch, page_url)
+        raise NotImplementedError
+      end
+
+      # 判断分支是否包含某次提交
+      # @return [Boolean]
+      def branch_contain_commit?(repo_info, branch, commit_sha)
+        raise NotImplementedError
+      end
+
+      # 合并组件分支到目标分支
+      def merge_branch(repo_module, target_branch)
+        raise NotImplementedError
+      end
+    end
+
+    # 不支持的平台(非Gitee/GitLab)，所有平台能力静默跳过
+    class NullProvider < Provider
+      include Singleton
+
+      def available?
+        false
+      end
+
+      def create_project_if_need(project_name, http_url, private: true, description: nil)
+        Build.log.info("非受支持的代码托管平台(#{http_url})，跳过仓库检查和创建")
+        nil
+      end
+
+      def find_project(pod_name, http_url, can_raise: true)
+        nil
+      end
+
+      def lock_branch(repo_info, branch, page_url)
+        Build.log.info("非受支持的代码托管平台，跳过分支锁死: #{branch}")
+        nil
+      end
+
+      def branch_contain_commit?(repo_info, branch, commit_sha)
+        false
+      end
+
+      def merge_branch(repo_module, target_branch)
+        Build.log.info("非受支持的代码托管平台，不支持自动合并分支到#{target_branch}")
+      end
+    end
+  end
+end

data/lib/core/hosting.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'uri'
+require_relative 'hosting/provider'
+require_relative 'hosting/gitee_client'
+require_relative 'hosting/gitee_provider'
+require_relative 'hosting/gitlab_provider'
+
+module Build
+  # 代码托管平台工厂：根据仓库地址选择对应的平台Provider
+  module Hosting
+    # 从ssh(scp-like)或http地址中解析host
+    # git@gitee.com:owner/repo.git -> gitee.com
+    # https://gitee.com/owner/repo  -> gitee.com
+    def self.host_of(url)
+      url = url.to_s
+      host =
+        if url.start_with?('git@')
+          url.split('@', 2).last.split(':', 2).first
+        else
+          begin
+            URI(url).host
+          rescue URI::Error
+            nil
+          end
+        end
+      host.to_s.downcase
+    end
+
+    # @param url [String] 仓库ssh或http地址
+    # @return [Build::Hosting::Provider]
+    def self.provider_for(url)
+      host = host_of(url)
+      if host.include?('gitee')
+        GiteeProvider.instance
+      elsif host.include?('gitlab')
+        GitlabProvider.instance
+      else
+        NullProvider.instance
+      end
+    end
+  end
+end

data/lib/core/logger.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Build
+  # 统一构建日志，替代散落各处的 puts。
+  #
+  # 级别:
+  #   step    阶段标题(⏩，前置空行)，如 clone仓库、pod update、开始编译
+  #   info    普通信息
+  #   detail  细节说明/阶段性完成(-> 前缀)；流程内各步骤完成统一用此级别
+  #   success 成功提示(✅)；仅用于整条命令/流程的最终关键结果，阶段步骤不要用，避免满屏✅
+  #   warn    警告(⚠️，输出到 stderr，不中断流程)
+  #   error   错误(❌，输出到 stderr；是否退出由调用方决定)
+  #   debug   调试细节(命令回显/响应体等)，仅 --verbose 或环境变量开启时输出
+  class Logger
+    DEBUG_ENV = 'POD_BINARY_PACK_VERBOSE'
+
+    attr_writer :debug_enabled
+
+    def initialize
+      @debug_enabled = !ENV.fetch(DEBUG_ENV, '').strip.empty?
+    end
+
+    def debug_enabled?
+      !!@debug_enabled
+    end
+
+    def step(message)
+      write($stdout, "\n⏩ #{message}")
+    end
+
+    def info(message = '')
+      write($stdout, message.to_s)
+    end
+
+    def detail(message)
+      write($stdout, "-> #{message}")
+    end
+
+    def success(message)
+      write($stdout, "✅ #{message}")
+    end
+
+    def warn(message)
+      write($stderr, "⚠️ #{message}")
+    end
+
+    def error(message)
+      write($stderr, "❌ #{message}")
+    end
+
+    def debug(message)
+      write($stdout, "· #{message}") if debug_enabled?
+    end
+
+    private
+
+    def write(io, message)
+      io.puts(message)
+    end
+  end
+
+  # @return [Build::Logger] 全局构建日志实例
+  def self.log
+    @log ||= Logger.new
+  end
+end

data/lib/core/podspec.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+require 'fileutils'
+require 'json'
+
+module Build
+  class Podspec
+    # @return [String] podspec文件路径
+    attr_accessor :path
+
+    # @return [JSON] 更新后的内容
+    attr_accessor :podspec_content
+
+    def initialize(path)
+      @path = path
+      @podspec_content = update_need_framework
+    end
+
+    private
+    # 添加必要的framework
+    def update_need_framework
+      code_path = File.dirname(self.path)
+
+      json = File.read(self.path)
+      podspec_content = JSON.parse(json)
+
+      need_adds = []
+
+      framework1 = "CoreServices"
+      contain1 = code_contain_framework(code_path, framework1)
+      if contain1
+        need_adds << framework1
+        Build.log.warn("源码podspec缺少依赖:s.frameworks '#{framework1}', 已为自动添加")
+      end
+
+      # 遍历添加
+      need_adds.each do |framework|
+        unless podspec_content["frameworks"]
+          podspec_content["frameworks"] = []
+          podspec_content["frameworks"] << framework
+        end
+
+        if podspec_content["frameworks"].class == String
+          origin = podspec_content["frameworks"]
+          if origin != framework
+            podspec_content["frameworks"] = [origin]
+            podspec_content["frameworks"] << framework
+          end
+        end
+
+        if podspec_content["frameworks"].class == Array
+          origin = podspec_content["frameworks"]
+          unless origin.include?(framework)
+            podspec_content["frameworks"] << framework
+          end
+        end
+      end
+
+      podspec_content
+
+    end
+
+    def code_contain_framework(code_path, framework)
+      files = Dir["#{code_path}/**/*"]
+
+      # 组件里所有依赖的其他组件
+      all_reference_pods = []
+      files.each do |file_path_str|
+        file_path = Pathname(file_path_str)
+        extend_name = file_path.extname
+        if not extend_name == ".h" and
+          not extend_name == ".m" and
+          not extend_name == ".mm" and
+          not extend_name == ".pch" and
+          not extend_name == ".c" and
+          not extend_name == ".cc" and
+          not extend_name == ".hpp" and
+          not extend_name == ".cpp"
+          next
+        end
+        reference_pods = pod_in_file(file_path)
+        all_reference_pods = all_reference_pods | reference_pods
+      end
+
+      all_reference_pods.include?(framework)
+    end
+
+    # 获取某个文件里引用的依赖库名字
+    # @param file_path 文件路径
+    # @return reference_pods
+    def pod_in_file(file_path)
+      reference_pods = []
+      if File.directory?(file_path)
+        return reference_pods
+      end
+
+      safe_readlines(file_path).each { |line|
+        # 兼容 #import <A/B.h> 与 #import<A/B.h>(无空格)两种写法，
+        # 无空格写法漏识别会导致framework依赖检测遗漏
+        match = line.match(/\A#\s*import\s*<([^>]+)>/)
+        next unless match
+
+        import_path = match[1]
+        next unless import_path.include?("/")
+
+        # 取第一段作为组件名，处理 #import <A/B/C.h> 多级子模块的情况
+        real_module_name = import_path.split("/").first
+
+        unless reference_pods.include?(real_module_name)
+          reference_pods << real_module_name
+        end
+      }
+      reference_pods
+    end
+
+    # 容错读取源码行：历史组件源码可能存在GBK等非UTF-8文件。
+    # 直接IO.readlines按默认编码读，后续start_with?/match遇到非法字节会抛
+    # invalid byte sequence中断整个打包流程；先按二进制读取再显式做一次
+    # 同编码转换替换非法字节
+    def safe_readlines(file_path)
+      content = File.read(file_path, mode: 'rb')
+      content.encode!('UTF-8', 'UTF-8', invalid: :replace, undef: :replace, replace: '?')
+      content.lines
+    end
+
+  end
+end

data/lib/core/push.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require_relative 'config'
+require_relative 'repo_module'
+require_relative 'repo_xcode_package'
+require_relative 'repo_xcode_shell'
+require 'singleton'
+
+module Build
+  class Push
+    include Singleton
+
+    # @return [Object] 消息发送器
+    attr_accessor :sender
+
+    # @return [RepoModule] 打包的组件
+    attr_accessor :repo_module
+
+    # @return [RepoXCodeShell] 壳工程(即打包工程)
+    attr_accessor :repo_xcode_shell
+
+    def setup(sender = nil, repo_module = nil, repo_xcode_shell = nil)
+      @sender = sender
+      @repo_module = repo_module
+      @repo_xcode_shell = repo_xcode_shell
+
+    end
+
+    # 发送推送消息
+    # @param title [String] 推送标题
+    # @param summary [String] 推送简要描述
+    def push(title, summary = nil)
+
+      # 未初始化时 拿不到推送给谁 就不推  只打印
+      if not repo_module or not repo_module.last_commit.committer
+        Build.log.warn("未获取到仓库信息或提交者信息，不推送以下内容：")
+        Build.log.info(title)
+        Build.log.info(summary.to_s)
+        return
+      end
+
+      to = repo_module.last_commit.committer
+      content = create_push_content(summary)
+
+      Build.log.step("开始推送通知流程")
+      log_content = "#{title}\n#{content}\n"
+
+      # 发送渠道
+      Build.log.debug("即将推送给#{to}如下内容:\n#{log_content}")
+      if @sender
+        @sender.send_msg(to.upcase, title, content.to_s)
+        Build.log.detail("推送通知完毕")
+      else
+        Build.log.warn("未提供推送配置，不进行推送")
+      end
+
+    end
+
+    def create_push_content(summary = nil)
+
+      shell_http_url = repo_xcode_shell ? repo_xcode_shell.http_url : "null"
+      shell_branch = repo_xcode_shell ? repo_xcode_shell.branch : "null"
+      build_url = Build::Config.instance.build_url
+
+      content = ""
+      content += "🔹组件: #{repo_module.pod_name}\n"
+      content += "🔹版本: #{repo_module.pod_version_final}\n"
+      content += "🔹分支: #{repo_module.branch}\n"
+      content += "🔹提交: #{repo_module.last_commit.commit_msg}\n"
+      content += "🔹组件 地址: #{repo_module.http_url}\n"
+      content += "🔹壳工程地址: #{shell_http_url}\n"
+      content += "🔹壳工程分支: #{shell_branch}\n"
+      content += "🔹构建地址: #{build_url}\n"
+      content += summary ? "🔸摘要: #{summary}\n\n" : "\n"
+      content += "🔹#{Time.new.strftime("%Y-%m-%d %H:%M:%S")}\n"
+
+    end
+
+  end
+end

data/lib/core/repo.rb

@@ -0,0 +1,284 @@
+# frozen_string_literal: true
+require 'git'
+require 'fileutils'
+require_relative 'hosting'
+require_relative 'commit'
+require_relative 'push'
+require_relative 'git_helper'
+require_relative 'util/file_helper'
+
+module Build
+  class Repo
+    attr_reader :page_url
+    attr_reader :http_url
+    attr_reader :ssh_url
+    attr_reader :branch
+
+    # @return [Build::Hosting::Provider] 当前仓库对应的代码托管平台能力
+    def hosting
+      @hosting ||= Hosting.provider_for(ssh_url)
+    end
+
+    attr_writer :hosting
+
+    # @return [Push] 推送能力
+    attr_accessor :pusher
+
+    # @return [String] 仓库提交时的用户名
+    attr_accessor :user_name
+
+    # @return [String] 仓库提交时的邮箱
+    attr_accessor :user_email
+
+    # @return [Pathname] 仓库所在本机的路径
+    attr_accessor :repo_path
+
+    # @return [String] 仓库所在本机的路径
+    attr_accessor :path
+
+    # @return [Commit] 最新的提交信息
+    attr_accessor :last_commit
+
+    # @return [Integer] 当前仓库的大小 KB
+    attr_accessor :size
+
+    # @return [String] 当前仓库的大小
+    attr_accessor :size_format
+
+    def initialize(path, ssh_url, branch = nil)
+      @ssh_url = ssh_url.to_s
+      @branch = branch.to_s
+      @path = path.to_s
+      @repo_path = Pathname.new(path.to_s)
+      @user_name = "jenkins"
+      @user_email = "jenkins@jenkins.com"
+      @last_commit = Commit.new
+      @pusher = Push.instance
+
+      __validate
+    end
+
+    public
+    # 根据url去clone
+    # @param only_head: only_head
+    def git_clone(only_head)
+      Build.log.info("(#{File.basename(self.path)})下载[#{self.ssh_url}] [#{self.branch}] [#{only_head ? "深度1" : "全量"}]")
+      
+      # clone(git gem 5.x: depth/branch 均为 clone 的直接选项，不再支持嵌套 options:)
+      clone_options = {}
+      clone_options[:branch] = self.branch unless self.branch.to_s.empty?
+      clone_options[:depth] = 1 if only_head
+      begin
+        Git.clone(self.ssh_url, self.repo_path.to_s, **clone_options)
+      rescue Git::FailedError => e
+        # 常见克隆失败转成可读提示，避免直接抛git原始堆栈；
+        # git gem 5.x: e.result 为 CommandLine::Result，stderr 取不到时回退错误消息全文
+        stderr = if e.respond_to?(:result) && e.result.respond_to?(:stderr)
+                   e.result.stderr.to_s
+                 else
+                   e.message.to_s
+                 end
+        friendly =
+          if stderr.include?('not found in upstream origin')
+            "分支/tag '#{self.branch}' 在远端仓库中不存在，请检查分支名是否正确(区分大小写)，或先在远端创建该分支/tag"
+          elsif stderr.include?('Repository not found') || stderr.include?('Permission denied') ||
+                stderr.include?('Could not read from remote')
+            "仓库不存在或当前账号无访问权限，请检查仓库地址与SSH公钥配置"
+          end
+        fatal_line = stderr.lines.find { |line| line.strip.start_with?('fatal:') }.to_s.strip
+        error = +"克隆仓库失败: #{self.ssh_url} (分支/tag: #{self.branch.to_s.empty? ? '默认' : self.branch})"
+        error << "\n-> #{friendly}" if friendly
+        error << "\n-> #{fatal_line}" unless fatal_line.empty?
+        pusher.push("❌ 打包失败", error)
+        Build.log.error(error)
+        Process.exit(-1)
+      end
+
+      repo = Git.open(self.repo_path)
+      repo.config_set('user.name', user_name)
+      repo.config_set('user.email', user_email)
+
+      Build.log.detail("下载完成")
+
+      # 打印最近提交记录(git gem 5.x: repo.log.execute)
+      log = repo.log(30).execute.first
+
+      if log
+        committer = log.committer
+        Build.log.detail("最近提交记录: [#{log.sha}] [#{log.message}] [#{committer.date}] [#{committer.name}] [#{committer.email}]")
+
+        last_commit.commit_id = log.sha
+        last_commit.commit_msg = log.message
+        last_commit.committer = committer.name
+        last_commit.commit_mail = committer.email
+        last_commit.commit_time = committer.date.strftime("%Y-%m-%d %H:%M:%S")
+
+      end
+    end
+
+    # 获取是否有变更
+    def git_status
+      GitHelper.status(self.path)
+    end
+
+    # 拉代码
+    def git_pull
+      GitHelper.pull(self.path)
+    end
+
+    # 添加到暂存区
+    def git_add_stag
+      GitHelper.add_stag(self.path)
+    end
+
+    # 仅暂存指定文件
+    def git_add_files(files)
+      GitHelper.add_files(self.path, files)
+    end
+
+    # 指定文件是否有改动
+    def git_file_changed?(file)
+      GitHelper.file_changed?(self.path, file)
+    end
+
+    # 提交代码
+    def git_commit(commit_msg = nil)
+      GitHelper.commit(self.path, commit_msg)
+    end
+
+    def git_push
+      GitHelper.push(self.path, self.branch)
+    end
+
+    def git_push_f
+      GitHelper.push_f(self.path, self.branch)
+    end
+
+    def git_push_tags
+      GitHelper.push_tags(self.path)
+    end
+
+    # 重置仓库
+    def git_reset_hard
+      GitHelper.reset_hard(self.path)
+    end
+
+    # 查询变更
+    def git_fetch
+      GitHelper.fetch(self.path)
+    end
+
+    # 检出分支
+    def git_checkout(checkout_branch)
+      GitHelper.checkout(self.path, checkout_branch)
+    end
+
+    # 删除本地标签
+    def git_tag_delete_local(tag)
+      GitHelper.tag_delete_local(self.path, tag)
+    end
+
+    # 删除远端标签
+    def git_tag_delete_origin(tag)
+      GitHelper.tag_delete_origin(path, tag)
+    end
+
+    # 本地仓库打标签
+    def git_tag_local(tag)
+      GitHelper.tag_local(self.path, tag)
+    end
+
+    # 远程仓库打标签
+    def git_tag_origin(tag)
+      GitHelper.tag_origin(self.path, tag)
+    end
+
+    # 丢弃修改并拉取代码
+    def discard_pull
+      current = Dir.pwd
+      Dir.chdir(self.path)
+      Build.log.info("丢弃修改并拉取代码")
+      git_add_stag
+      git_reset_hard
+      git_fetch
+      git_checkout(branch)
+      git_pull
+      Dir.chdir(current)
+    end
+
+    # 一条龙服务
+    # @return [Boolean] 本次是否真的产生并推送了新提交(无变更返回false)
+    def push_code
+      Build.log.step("推送产物(#{File.basename(self.path)})")
+
+      git_pull
+      if git_status
+        git_add_stag
+        git_commit(nil)
+        git_push
+        true
+      else
+        false
+      end
+    end
+
+    # 清空仓库(保留.git及隐藏文件，与原ls行为一致；Ruby原生实现避免空格文件名被shell切分)
+    def clear
+      current = Dir.pwd
+      Dir.chdir(self.path)
+      Build.log.debug("清空仓库(#{File.basename(self.path)})")
+      Dir.children('.').each do |entry|
+        next if entry.start_with?('.')
+        FileUtils.rm_rf(entry)
+      end
+      Dir.chdir(current)
+    end
+
+    def page_url
+      http_url.gsub(".git","")
+    end
+
+    def http_url
+      if ssh_url.start_with?"git@"
+        repo_url = ssh_url.gsub(":","/")
+        repo_url = repo_url.gsub("git@","http://")
+        return repo_url
+      end
+      ssh_url
+    end
+
+    def size
+      file_array = Array.new
+      FileHelper.recursion_files(self.path, file_array)
+
+      size = 0
+      file_array.each { |file|
+        size += File.size(file)
+      }
+
+      @size = size*0.001
+    end
+
+    def size_format
+      self.size > 1024 ? "#{(self.size * 0.001).round(1).to_s}MB": "#{self.size.round(0).to_s}KB"
+    end
+
+    private
+    # 参数校验
+    def __validate
+      if ssh_url.to_s.empty? or not ssh_url.to_s.start_with?("git@")
+        error = "repo初始化参数ssh_url必须不能为空, 且是ssh地址"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      if path.to_s.empty?
+        error = "目标路径为空， 请先设置路径"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+    end
+
+  end
+end