pod-binary-pack 1.0.0

data/lib/core/github_helper.rb

@@ -0,0 +1,334 @@
+# frozen_string_literal: true
+
+require 'digest'
+require 'json'
+require 'net/http'
+require 'uri'
+require_relative 'push'
+require 'singleton'
+
+module Build
+  class GithubHelper
+    include Singleton
+
+    attr_accessor :path
+    attr_accessor :pod_name
+    attr_accessor :pod_version
+    attr_accessor :third
+    attr_accessor :pusher
+    attr_accessor :github_tag
+    attr_accessor :github_url
+    attr_accessor :github_ssh_url
+    attr_accessor :podspec_content
+
+    # 是否为http归档组件(podspec source为{http: 归档地址}形态，无git源码仓)
+    attr_accessor :http_source
+    # http归档下载地址(source.http声明的原始地址)
+    attr_accessor :archive_url
+    # 归档类型(zip/tar.gz/tgz/tar.bz2/tar.xz)
+    attr_accessor :archive_type
+    # source.http中声明的校验摘要(未声明时为nil)
+    attr_accessor :archive_sha256_declared
+    attr_accessor :archive_sha1_declared
+    # 下载后实际计算的sha256(下载阶段写入，供发布podspec的build_metadata溯源)
+    attr_accessor :archive_sha_actual
+    # 是否解压后上移顶层目录(source.http.flatten=true)
+    attr_accessor :archive_flatten
+    # 下载到本地的podspec.json绝对路径(播种到归档目录时使用)
+    attr_accessor :podspec_json_path
+
+    def initialize
+      @http_source = false
+    end
+
+    def request_podspec(path, pod_name, pod_version)
+      @path = path
+      @pod_name = pod_name
+      @pod_version = pod_version
+      @pusher = Push.instance
+
+      download_podspec
+      analyzer_tag
+    end
+
+    # http归档信息汇总(http归档git化流程使用)；非http组件返回nil
+    # @return [Hash, nil] {url:, type:, sha256:, sha1:, flatten:, version:}
+    def archive_info
+      return nil unless @http_source
+
+      {
+        url: @archive_url,
+        type: @archive_type,
+        sha256: @archive_sha256_declared,
+        sha1: @archive_sha1_declared,
+        flatten: @archive_flatten,
+        version: @github_tag
+      }
+    end
+
+    private
+    def download_podspec
+      Build.log.step("(#{File.basename(self.path)})从github上下载podspec文件")
+
+      unless Dir.exist?(self.path)
+        Dir.mkdir(self.path)
+      end
+
+      podspec_json_path = "#{self.path}/#{pod_name}.podspec.json"
+
+      pod_name_md5 = Digest::MD5.hexdigest(pod_name)
+      pod_name_md5_0 = pod_name_md5[0..0]
+      pod_name_md5_1 = pod_name_md5[1..1]
+      pod_name_md5_2 = pod_name_md5[2..2]
+      # 存为实例变量：analyzer_tag 方法也要用该路径打印所有版本 podspec 地址，
+      # 不能用局部变量(跨方法不可见会被解析为 self.split_path 方法调用并报 NameError)
+      @split_path = "#{pod_name_md5_0}/#{pod_name_md5_1}/#{pod_name_md5_2}"
+      # podspec 下载源候选地址，按可用性优先级排列，请求失败自动切换下一个
+      raw_json_url = "https://raw.githubusercontent.com/CocoaPods/Specs/master/Specs/#{@split_path}/#{pod_name}/#{pod_version}/#{pod_name}.podspec.json"
+      podspec_json_urls = [
+        # jsDelivr Fastly 线路(CDN，命中的文件速度快；源上不存在时可能 301 回源 raw)
+        "https://fastly.jsdelivr.net/cocoa/Specs/#{@split_path}/#{pod_name}/#{pod_version}/#{pod_name}.podspec.json",
+        # jsDelivr GCore 线路
+        "https://gcore.jsdelivr.net/cocoa/Specs/#{@split_path}/#{pod_name}/#{pod_version}/#{pod_name}.podspec.json",
+        # ghproxy.net 代理(国内可达，如实透传 GitHub raw 的 200/404，版本不存在时可据此准确判定)
+        "https://ghproxy.net/#{raw_json_url}",
+        # gh-proxy.com 代理(同上，备用)
+        "https://gh-proxy.com/#{raw_json_url}"
+      ]
+
+      Build.log.detail("组件md5裁切：#{@split_path}")
+
+      # GitHub 上该组件的 podspec 目录(人工核对组件名大小写/版本是否存在时用)
+      specs_page_url = "https://github.com/CocoaPods/Specs/tree/master/Specs/#{@split_path}/#{pod_name}"
+
+      # 依次尝试候选下载源，任一成功即停止，全部失败才终止打包
+      podspec_content = nil
+      podspec_json_url = nil
+      not_found_count = 0
+      podspec_json_urls.each_with_index do |candidate_url, index|
+        begin
+          # 跟随 301/302：jsDelivr 对源上不存在的文件会 301 回源 raw.githubusercontent，
+          # 必须跟随到最终地址，以最终状态码判断是否真的 404
+          response = fetch_with_redirect(candidate_url)
+          # 非 2xx 状态码视为该下载源不可用，切换下一个下载源
+          unless response.is_a?(Net::HTTPSuccess)
+            not_found_count += 1 if response.code == '404'
+            Build.log.detail("下载源(#{index + 1}/#{podspec_json_urls.size})返回状态码 #{response.code}：#{candidate_url}")
+            next
+          end
+          podspec_content = JSON.parse(response.body)
+          podspec_json_url = candidate_url
+          break
+        rescue => exception
+          Build.log.detail("下载源(#{index + 1}/#{podspec_json_urls.size})请求失败：#{exception.message}")
+          Build.log.detail("  地址：#{candidate_url}")
+        end
+      end
+
+      unless podspec_content
+        # 各源尝试时已逐个打印过具体 URL，失败块不再重复罗列，只给结论和权威核对地址
+        if not_found_count > 0
+          Build.log.error("有下载源返回 404，GitHub Specs 上大概率不存在组件 '#{pod_name}' 的 #{pod_version} 版本，请核对组件名大小写(如 fmdb 应为 FMDB)与版本号")
+        else
+          Build.log.error("所有podspec下载源均未成功(可能是网络不可达或镜像回源失败)，请检查网络后重试；若网络正常仍失败，通常是组件名/版本不存在")
+        end
+        Build.log.error("请打开以下 GitHub 地址确认组件/版本是否存在：#{specs_page_url}")
+        Process.exit(-1)
+      end
+
+      Build.log.detail("当前版本podspec地址: #{podspec_json_url}")
+
+      res_pod_name = podspec_content["name"]
+      unless res_pod_name == pod_name
+        error = "获取到的podspec的名字#{res_pod_name}!= #{pod_name}"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      podspec_content.delete("license")
+      podspec_content.delete("module_map")
+
+      # swift使用静态库
+      unless podspec_content.has_key?("swift_version")
+        podspec_content.delete("static_framework")
+      end
+
+      # 记录变量
+      @podspec_content = podspec_content
+
+      ## 写文件
+      new_file = File.new(podspec_json_path, "w+")
+      if new_file
+        new_file.syswrite(JSON.pretty_generate(podspec_content))
+      end
+      # 记录下载产物路径(http归档组件播种podspec到归档目录时使用)
+      @podspec_json_path = File.expand_path(podspec_json_path)
+
+    end
+
+    # 发起 GET 并自动跟随 301/302 重定向(最多 5 次)，返回最终响应。
+    # jsDelivr 对源上不存在的文件会 301 回源 raw.githubusercontent，
+    # 只有跟随到终点拿到的状态码才能准确反映文件是否存在(404)。
+    def fetch_with_redirect(url, limit = 5)
+      raise '重定向次数超过上限' if limit <= 0
+
+      uri = URI(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == 'https')
+      # 设置10秒连接/读取超时，避免慢速镜像/被墙地址长时间卡住打包流程
+      http.open_timeout = 10
+      http.read_timeout = 10
+      response = http.request_get(uri.request_uri)
+
+      if response.is_a?(Net::HTTPRedirection) && response['location']
+        next_url = URI.join(uri, response['location']).to_s
+        Build.log.detail("  跟随重定向(#{response.code})：#{next_url}")
+        return fetch_with_redirect(next_url, limit - 1)
+      end
+
+      response
+    end
+
+    def analyzer_tag
+
+      source = podspec_content["source"]
+      unless source
+        error = "podspec指定的 source字段为空"
+        pusher.push("❌ 解析失败", error)
+        Process.exit(-1)
+      end
+
+      # 复位http归档状态，避免同进程重复解析时残留上一次的归档信息
+      @http_source = false
+      @archive_url = nil
+      @archive_type = nil
+      @archive_sha256_declared = nil
+      @archive_sha1_declared = nil
+      @archive_flatten = false
+
+      # source.http 归档形态走归档git化流程，git 形态走原fork流程
+      if source["http"]
+        analyzer_http_archive(source)
+      else
+        analyzer_git_source(source)
+      end
+    end
+
+    # git源组件解析(source.git + tag/branch/commit)，即原analyzer_tag逻辑
+    def analyzer_git_source(source)
+      @github_url = source["git"]
+      @github_tag = if source["tag"]
+                      source["tag"]
+                    else
+                      source["branch"] ? source["branch"] : source["commit"]
+                    end
+      unless @github_url
+        error = "podspec文件未使用source[git]，暂未支持"
+        pusher.push("❌ 失败", error)
+        Process.exit(-1)
+      end
+
+      unless @github_tag
+        error = "podspec未使用source[tag] source[branch] source[commit], 暂未支持"
+        pusher.push("❌ 解析失败", error)
+        Process.exit(-1)
+      end
+
+      # 转成ssh地址
+      @github_ssh_url = @github_url.http_to_ssh
+
+      Build.log.detail("所有版本podspec地址：https://github.com/CocoaPods/Specs/tree/master/Specs/#{@split_path}/#{pod_name}")
+      Build.log.detail("当前版本源码地址: #{@github_url}")
+      Build.log.detail("当前版本源码tag: #{@github_tag}")
+    end
+
+    # http归档组件解析(source.http)：
+    # 归档没有上游git仓，fork阶段会把下载解压后的归档就地git化并推送镜像仓，
+    # 因此这里不解析git地址，镜像仓克隆引用统一取版本号(与git化时打的tag一致)
+    # 支持两种source形态:
+    #   字符串: "http": "https://xxx.zip"
+    #   对象:   "http": {"url": "...", "type": "zip", "sha256": "...", "flatten": true}
+    def analyzer_http_archive(source)
+      @http_source = true
+
+      entry = source["http"]
+      url = nil
+      declared_type = ''
+      sha256 = nil
+      sha1 = nil
+      flatten = false
+      case entry
+      when String
+        url = entry
+      when Hash
+        url = entry["url"].to_s
+        declared_type = entry["type"].to_s.strip
+        sha256 = entry["sha256"].to_s.strip
+        sha256 = nil if sha256.empty?
+        sha1 = entry["sha1"].to_s.strip
+        sha1 = nil if sha1.empty?
+        flatten = entry["flatten"] == true
+      end
+
+      if url.to_s.strip.empty?
+        error = "source[http]归档地址为空，无法解析下载地址"
+        pusher.push("❌ 解析失败", error)
+        Process.exit(-1)
+      end
+      url = url.strip
+
+      # 已知不支持的归档附加配置(如headers需携带鉴权下载、subdir需子目录裁切)，直接明确报错
+      extra_keys = entry.is_a?(Hash) ? entry.keys - %w[url type sha256 sha1 flatten] : []
+      unless extra_keys.empty?
+        error = "source[http]归档使用了暂不支持的配置项: #{extra_keys.join('、')}(目前支持url/type/sha256/sha1/flatten)"
+        pusher.push("❌ 解析失败", error)
+        Process.exit(-1)
+      end
+
+      # 归档类型：显式声明优先，否则按URL扩展名推断
+      @archive_type = declared_type.strip.downcase
+      @archive_type = infer_archive_type(url) if @archive_type.empty?
+      unless %w[zip tar.gz tgz tar.bz2 tbz tbz2 tar.xz txz].include?(@archive_type)
+        error = "不支持的归档类型: #{@archive_type}，目前支持 zip/tar.gz/tgz/tar.bz2/tar.xz，可使用source.http.type显式声明"
+        pusher.push("❌ 解析失败", error)
+        Process.exit(-1)
+      end
+
+      @archive_url = url
+      @archive_sha256_declared = sha256
+      @archive_sha1_declared = sha1
+      @archive_flatten = flatten
+
+      # 镜像仓克隆引用取版本号：git化时在镜像仓打的tag即版本号，后续git_clone/podspec改写均复用该引用
+      @github_tag = pod_version
+
+      Build.log.detail("所有版本podspec地址：https://github.com/CocoaPods/Specs/tree/master/Specs/#{@split_path}/#{pod_name}")
+      Build.log.detail("当前版本为http归档组件(无git源码仓)，将下载归档后git化到镜像仓")
+      Build.log.detail("归档地址: #{@archive_url}")
+      Build.log.detail("归档类型: #{@archive_type} flatten: #{@archive_flatten}")
+      Build.log.detail("归档摘要声明: sha256=#{sha256} sha1=#{sha1}")
+      Build.log.detail("镜像仓tag(取版本号): #{@github_tag}")
+    end
+
+    # 按URL路径扩展名推断归档类型(忽略query串)
+    # @return [String] 识别不出返回空串，由调用方报错
+    def infer_archive_type(url)
+      path = begin
+        URI.parse(url).path
+      rescue StandardError
+        url
+      end
+      lower = path.to_s.downcase
+      if lower.end_with?('.zip') then 'zip'
+      elsif lower.end_with?('.tar.gz') then 'tar.gz'
+      elsif lower.end_with?('.tgz') then 'tgz'
+      elsif lower.end_with?('.tar.bz2') then 'tar.bz2'
+      elsif lower.end_with?('.tbz') || lower.end_with?('.tbz2') then 'tar.bz2'
+      elsif lower.end_with?('.tar.xz') then 'tar.xz'
+      elsif lower.end_with?('.txz') then 'tar.xz'
+      else ''
+      end
+    end
+
+  end
+end

data/lib/core/hook_manager.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'singleton'
+
+module Status
+  # 打包工程拷贝yaml文件后
+  XCODE_PACKAGE_COPY_YAML = "XCODE_PACKAGE_COPY_YAML".downcase
+end
+
+class HookManager
+
+  include Singleton
+
+  def initialize
+    @hooks = {}
+  end
+
+  # 提供注册钩子的方法
+  def register_hook(status, &block)
+    @hooks[status] ||= []
+    @hooks[status] << block
+  end
+
+  # 触发钩子的方法
+  def trigger_hook(status, *args)
+    if @hooks[status]
+      Build.log.debug("执行hook阶段#{status}逻辑")
+      @hooks[status].each { |hook| hook.call(*args) }
+    end
+  end
+
+end

data/lib/core/hosting/gitee_client.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'net/http'
+require 'openssl'
+require 'cgi'
+
+module Build
+  # Gitee OpenAPI v5 的极简HTTP客户端(基于Net::HTTP，无额外gem依赖)
+  # 接口文档: https://gitee.com/api/v5/swagger
+  class GiteeClient
+    class Error < StandardError; end
+
+    # 资源不存在(404)
+    class NotFound < Error; end
+
+    # 令牌无效/权限不足(401/403)
+    class Unauthorized < Error; end
+
+    # @param endpoint [String] 如 https://gitee.com/api/v5
+    # @param token [String] 私人令牌(access_token)
+    def initialize(endpoint, token)
+      @endpoint = endpoint.to_s.sub(/\/\z/, '')
+      @token = token.to_s
+    end
+
+    def get(path, params = {})
+      request('GET', path, params)
+    end
+
+    def post(path, params = {})
+      request('POST', path, params)
+    end
+
+    def patch(path, params = {})
+      request('PATCH', path, params)
+    end
+
+    def put(path, params = {})
+      request('PUT', path, params)
+    end
+
+    def delete(path, params = {})
+      request('DELETE', path, params)
+    end
+
+    # 对URL path段进行转义
+    def self.escape_segment(value)
+      CGI.escape(value.to_s)
+    end
+
+    private
+
+    def request(method, path, params)
+      params = (params || {}).reject { |_k, v| v.nil? }
+
+      uri = URI("#{@endpoint}#{path}")
+      request_class = Net::HTTP.const_get(method.capitalize)
+
+      if %w[GET DELETE].include?(method)
+        uri.query = URI.encode_www_form(params.merge(access_token: @token))
+        req = request_class.new(uri.request_uri)
+      else
+        # Gitee v5 同时接受 query 中的 access_token 和表单 body
+        uri.query = URI.encode_www_form(access_token: @token)
+        req = request_class.new(uri.request_uri)
+        req.set_form_data(params) unless params.empty?
+      end
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      if uri.scheme == 'https'
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      end
+      http.open_timeout = 15
+      http.read_timeout = 30
+
+      res = http.request(req)
+      parse_response(res)
+    end
+
+    def parse_response(res)
+      code = res.code.to_i
+      data = parse_body(res.body)
+
+      return data if (200..299).cover?(code)
+
+      message = extract_message(data)
+      exception =
+        case code
+        when 404 then NotFound
+        when 401, 403 then Unauthorized
+        else Error
+        end
+      raise exception, "Gitee API请求失败(#{code}): #{message}"
+    end
+
+    def parse_body(body)
+      return {} if body.nil? || body.to_s.strip.empty?
+
+      JSON.parse(body)
+    rescue JSON::ParserError
+      {}
+    end
+
+    def extract_message(data)
+      if data.is_a?(Hash)
+        data['message'] || data['error'] || data.to_s
+      else
+        data.to_s
+      end
+    end
+  end
+end