pod-binary-pack 1.0.0

data/lib/core/repo_module_source.rb

@@ -0,0 +1,506 @@
+# frozen_string_literal: true
+require 'fileutils'
+require 'json'
+require 'shellwords'
+require 'pathname'
+require_relative 'podspec'
+require_relative 'repo_module'
+require_relative 'github_helper'
+require_relative 'util/string'
+require_relative 'util/file_helper'
+
+module Build
+  class RepoModuleSource < RepoModule
+    # podspec未声明Swift版本时补全的默认版本：部分含Swift的三方库(如LookinServer)root未声明
+    # swift_version，纯OC壳工程target又未设SWIFT_VERSION，不补会导致 pod install 报
+    # "Unable to determine Swift version"；Swift 5 语法在 Xcode 16/27 均可编译
+    DEFAULT_SWIFT_VERSION = '5.0'.freeze
+
+    # 最低支持版本
+    attr_accessor :ios_version
+
+    # 上次发布该版本时podspec.json中记录的commitID(无历史版本时为nil)
+    attr_accessor :last_released_commit_id
+
+    # 源码仓库的校验逻辑
+    def validate
+      super
+
+      branch_version = self.class.parse_version_from_branch(branch, release_branch_prefix)
+
+      # 分支是版本分支(前缀可配置)：分支里的版本号必须与打包版本号一致
+      if branch_version
+        if branch_version != pod_version
+          error = "版本分支#{branch}解析出版本号#{branch_version}，与传入的打包版本号#{pod_version}不一致，请保持二者相同(或直接缺省--version由分支解析)"
+          pusher.push("❌ 打包失败", error)
+          Process.exit(-1)
+        end
+      end
+
+      # 标准发布版本号(纯数字二/三/四段式，如 1.2 / 1.2.0 / 1.2.2.0)只能在
+      # master 分支或版本分支(<定制前缀>_x.y.z)上打包；
+      # 非 master、非版本前缀的普通特性分支不允许打标准版本号。
+      # 单段、五段及以上、带后缀的版本(如 1.2.2-fix / 1.2.0-beta.1)不属于标准发布版本，不做此约束
+      if self.branch != "master" and self.branch != self.pod_version and not self.third #特殊处理
+        if standard_release_version?(pod_version) and branch_version.nil?
+          error = "标准版本号(#{pod_version}，二段/三段/四段式)只能在 master 分支或版本分支上打包，" \
+                  "请将分支命名为 #{release_branch_prefix}_#{pod_version} 或 #{release_branch_prefix}-#{pod_version}(前缀可在 build.yml 配置)，" \
+                  "当前分支 #{self.branch} 不符合规则；带后缀的版本号(如 1.2.0-fix)不受此限制"
+          pusher.push("❌ 打包失败", error)
+          Process.exit(-1)
+        end
+      end
+
+    end
+
+    # 是否为标准发布版本号：纯数字且恰为 2~4 段(1.2 / 1.2.3 / 1.2.3.4)
+    def standard_release_version?(version)
+      version.to_s.match?(/\A\d+\.\d+(?:\.\d+){0,2}\z/)
+    end
+
+    # @api 锁死分支
+    def lock_branch_if_need
+      if build_item.snapshot
+        Build.log.info("当前源码仓库为SNAPSHOT包，无需锁死分支")
+        return
+      end
+
+      if third
+        Build.log.info("当前打包为三方库，无需锁死分支")
+        return
+      end
+
+      unless hosting.available?
+        Build.log.info("当前组件仓库非受支持的代码托管平台, 跳过锁死分支, url = #{ssh_url}")
+        return
+      end
+
+      unless repo_info
+        Build.log.info("未查询到仓库信息，跳过锁死分支 #{branch}")
+        return
+      end
+
+      Build.log.info("当前源码仓库(#{repo_info.full_name})打包模式为正式包，需锁死分支 #{branch}")
+      setting_url = hosting.lock_branch(repo_info, branch, page_url)
+
+      # 推送
+      pusher.push("【✅组件分支已锁死无法提交】", "配置地址 #{setting_url}")
+
+    end
+    # @api force_cover这个字段的检测
+    def force_cover_validate(repo_cocoapods_source)
+
+      # http归档git化组件：每次构建基于官方归档重新生成单提交历史，commit不延续，
+      # 上次发布的commit不可能包含在本次历史中，包含校验对这类组件无意义
+      if Build::GithubHelper.instance.http_source
+        Build.log.info("不校验commit信息是否包含上次，原因：http归档组件每次按官方归档重建，commit不延续历史")
+        return
+      end
+
+      # 强制覆盖的话 则不需要commit校验
+      if build_item.force_cover
+        Build.log.info("不校验commit信息是否包含上次，原因：force_cover = false")
+        return
+      end
+
+      # 非受支持平台地址  不校验
+      unless hosting.available?
+        Build.log.info("不校验commit信息是否包含上次，原因：当前组件仓库非受支持的代码托管平台, url = #{ssh_url}")
+        return
+      end
+
+      # 未查询到仓库信息 不校验
+      unless repo_info
+        Build.log.info("不校验commit信息是否包含上次，原因：未查询到当前组件的仓库信息")
+        return
+      end
+
+      # 判断cocoapods_source里文件夹是否存在
+      pod_name_path = "#{repo_cocoapods_source.path}/#{pod_name}"
+      unless File.directory?(pod_name_path)
+        Build.log.info("不校验commit信息是否包含上次，原因：repo_cocoapods_source没有当前组件文件夹")
+        return
+      end
+
+      # 判断json文件是否存在
+      pod_version_path = "#{pod_name_path}/#{pod_version_final}"
+      unless File.directory?(pod_version_path)
+        Build.log.info("不校验commit信息是否包含上次，原因：repo_cocoapods_source组件文件夹没有当前版本文件夹")
+        return
+      end
+
+      podspec_json_path = "#{pod_version_path}/#{pod_name}.podspec.json"
+      # 文件不存在 不校验了
+      unless File.exist?(podspec_json_path)
+        Build.log.info("不校验commit信息是否包含上次，原因：repo_cocoapods_source组件文件夹没有podspec.json文件")
+        return
+      end
+
+      json = File.read(podspec_json_path)
+      podspec_content = JSON.parse(json)
+      # 扩展信息统一读取 build_metadata 嵌套字段
+      metadata = podspec_content[PODSPEC_METADATA_KEY] || {}
+      commit_id = metadata["commit_id"]
+      committer = metadata["committer"]
+      commit_msg = metadata["commit_message"]
+      commit_time = metadata["commit_time"]
+      unless commit_id
+        Build.log.info("不校验commit信息是否包含上次，原因：repo_cocoapods_source的podspec.json build_metadata.commit_id为空")
+        return
+      end
+
+      # 记录上次发布的commit，供后续判断"本次是否有新提交"
+      @last_released_commit_id = commit_id
+
+      # 校验
+      contain = self.hosting.branch_contain_commit?(repo_info, branch, commit_id)
+      Build.log.step("(#{File.basename(self.path)})上次发布的commit信息:")
+      Build.log.detail("#{commit_id} #{commit_msg} #{commit_time}")
+      if contain
+        Build.log.detail("校验上次发布 commit 包含关系：通过")
+      else
+        error = "当前发布分支#{branch}不包含上次发布的#{committer}提交, 请先合并分支再打包或手动选择强制覆盖"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+    end
+
+    # 本次打包的源码是否与上次发布完全一致(当前HEAD就是上次发布的commit)。
+    # 一致时源码仓/二进制仓的版本tag无需删除后重新推送(tag仍指向同一个commit)。
+    # 三方库(走上游版本tag)、强制覆盖、无历史版本记录时不做该判定。
+    def no_new_commit_since_last_release?
+      return false if third
+      return false if build_item.force_cover
+      return false if last_released_commit_id.to_s.empty?
+
+      same_commit?(last_released_commit_id, last_commit.commit_id)
+    end
+
+    # 比较两个commit标识是否指向同一提交(兼容完整SHA与短SHA互相比较)
+    def same_commit?(sha_a, sha_b)
+      a = sha_a.to_s.strip.downcase
+      b = sha_b.to_s.strip.downcase
+      return false if a.empty? || b.empty? || a.length < 7 || b.length < 7
+
+      a == b || a.start_with?(b) || b.start_with?(a)
+    end
+
+    # podspec所在目录：子目录podspec时以该目录为文件匹配根(与CocoaPods :podspec 语义一致)，
+    # 默认仍是仓库根目录。必须在 podspec 定位完成(update_podspec)后才有值
+    def component_root_dir
+      @source_podspec_entry ? File.dirname(@source_podspec_entry) : path
+    end
+
+    # podspec是否位于仓库根目录：false时打包生成的LocalDependencies需用podspec:指向具体文件
+    def podspec_at_repo_root?
+      source_podspec_entry
+      File.dirname(@source_podspec_entry) == File.expand_path(path)
+    end
+
+    # podspec中全部subspec的短名(去掉root前缀)，含嵌套subspec；无subspec时返回空数组。
+    # json中的name形如 "BSDebugPlugins/DLAM" / "Root/A/B"，统一取最后一段
+    def podspec_subspec_names
+      collect_subspec_names(podspec_content && podspec_content["subspecs"])
+    end
+
+    def collect_subspec_names(subspecs)
+      Array(subspecs).flat_map do |subspec|
+        name = subspec["name"].to_s.split("/").last
+        children = collect_subspec_names(subspec["subspecs"])
+        name.empty? ? children : [name] + children
+      end
+    end
+
+    # 本次打包实际集成的subspec短名列表(须在podspec定位完成后调用)：
+    # - 显式指定(build.yml components.<组件>.subspecs 或 --subspecs)时校验存在性后按指定值，
+    #   用于互斥subspec组件(如FMDB)，全量合并编译必然冲突的场景
+    # - 未指定时默认集成podspec全部subspec
+    def resolved_build_subspecs
+      all = podspec_subspec_names
+      return all if all.empty? || build_subspecs.nil?
+
+      unknown = build_subspecs - all
+      unless unknown.empty?
+        error = "subspec配置指定了podspec中不存在的名称: #{unknown.join('、')}；" \
+                "组件#{pod_name}可用的subspec: #{all.join('、')}"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+      build_subspecs
+    end
+
+    # root及所有(含嵌套)subspec的扁平化列表
+    def all_podspec_specs
+      collect_specs(podspec_content)
+    end
+
+    def collect_specs(spec)
+      return [] unless spec.is_a?(Hash)
+      [spec] + Array(spec["subspecs"]).flat_map { |child| collect_specs(child) }
+    end
+
+    # 全部resource_bundles的bundle名(root+subspecs，去重)
+    def all_resource_bundle_names
+      all_podspec_specs.flat_map do |spec|
+        bundles = spec["resource_bundles"] || spec["resource_bundle"]
+        bundles.is_a?(Hash) ? bundles.keys : []
+      end.uniq
+    end
+
+    # 全部resources/resource声明的glob(root+subspecs，去重)
+    def all_resource_globs
+      all_podspec_specs.flat_map do |spec|
+        resources = spec["resources"] || spec["resource"]
+        case resources
+        when Array then resources
+        when nil then []
+        else [resources]
+        end
+      end.uniq
+    end
+
+    # 定位源码仓内的podspec文件(.podspec或.podspec.json的绝对路径)
+    # 优先级: 显式配置(--podspec-path/build.yml) > 根目录<组件名>.podspec约定 > 递归自动扫描(唯一命中)
+    def source_podspec_entry
+      return @source_podspec_entry if @source_podspec_entry
+
+      root_podspec = File.join(path, "#{pod_name}.podspec")
+      if podspec_rel_path
+        explicit = File.expand_path(podspec_rel_path, path)
+        unless File.exist?(explicit)
+          error = "配置的podspec路径不存在: #{podspec_rel_path}(相对源码仓根目录)，仓库: #{ssh_url}"
+          pusher.push("❌ 打包失败", error)
+          Process.exit(-1)
+        end
+        @source_podspec_entry = explicit
+        Build.log.detail("使用显式配置的podspec: #{podspec_rel_path}")
+        return @source_podspec_entry
+      end
+
+      if File.exist?(root_podspec)
+        @source_podspec_entry = root_podspec
+        return @source_podspec_entry
+      end
+
+      # 自动扫描：兼容podspec不在根目录/一仓多组件，排除.git与Pods目录
+      candidates = Dir.glob(File.join(path, '**', "#{pod_name}.podspec{,.json}"))
+                      .reject { |p| p.include?('/.git/') || p.include?('/Pods/') }
+                      .sort_by { |p| p.end_with?('.podspec.json') ? 1 : 0 }
+      if candidates.size == 1
+        @source_podspec_entry = candidates.first
+        rel = Pathname.new(@source_podspec_entry).relative_path_from(Pathname.new(File.expand_path(path))).to_s
+        Build.log.detail("根目录未找到podspec，自动扫描命中: #{rel}")
+        return @source_podspec_entry
+      elsif candidates.size > 1
+        rel_list = candidates.map { |p| Pathname.new(p).relative_path_from(Pathname.new(File.expand_path(path))).to_s }
+        error = "扫描到多个#{pod_name}的podspec(#{rel_list.join('、')})，无法自动确定，请通过 --podspec-path 或 build.yml components.#{pod_name}.podspec_path 显式指定"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      error = "podspec文件不存在：源码仓根目录及子目录均未找到 #{pod_name}.podspec(.json)，如podspec命名特殊请通过 --podspec-path 指定"
+      pusher.push("❌ 打包失败", error)
+      Process.exit(-1)
+    end
+
+    # @api podspec文件更新
+    def update_podspec
+
+      entry = source_podspec_entry
+
+      if entry.end_with?('.podspec.json')
+        # 仓库内本就是json podspec，直接使用不做转换
+        @podspec_json_path = entry
+      else
+        # .podspec 生成对应的json(生成后从工作副本删除.podspec，与既有行为一致)
+        @podspec_json_path = "#{entry}.json"
+        FileUtils.rm_f(@podspec_json_path)
+        command = "pod ipc spec #{Shellwords.escape(entry)} >> #{Shellwords.escape(podspec_json_path)}"
+        res = system command
+        unless res == true
+          error = "命令执行失败: #{command}"
+          pusher.push("❌ 打包失败", error)
+          Process.exit(-1)
+        end
+        FileUtils.rm_rf(entry)
+      end
+
+      unless File.exist?(podspec_json_path)
+        error = "podspec文件不存在"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      # 处理json文件
+      podspec = Podspec.new(podspec_json_path)
+      podspec_content = podspec.podspec_content
+
+      # 显式指定集成subspec(build.yml components.<组件>.subspecs 或 --subspecs)时，
+      # 把本地podspec同步剪裁为该集合后再写回：
+      # - 互斥subspec组件(如FMDB)即使声明:subspecs，CocoaPods仍会激活default_subspecs
+      #   指向的subspec(如standard的libraries: sqlite3)，把系统libsqlite3混入
+      #   SQLCipher加密版产物的链接，必须从spec源头剪掉
+      # - default_subspecs指向被剪subspec时一并移除，默认=保留的全部subspec
+      removed_subspec_names = []
+      if build_subspecs.is_a?(Array) && podspec_content["subspecs"].is_a?(Array)
+        all_names = collect_subspec_names(podspec_content["subspecs"])
+        unknown = build_subspecs - all_names
+        unless unknown.empty?
+          error = "subspec配置指定了podspec中不存在的名称: #{unknown.join('、')}；" \
+                  "组件#{pod_name}可用的subspec: #{all_names.join('、')}"
+          pusher.push("❌ 打包失败", error)
+          Process.exit(-1)
+        end
+        kept = podspec_content["subspecs"].select do |subspec|
+          names = [subspec["name"].to_s.split("/").last] + collect_subspec_names(subspec["subspecs"])
+          (names & build_subspecs).any?
+        end
+        if kept.size < podspec_content["subspecs"].size
+          removed_subspec_names = (podspec_content["subspecs"] - kept).map { |s| s["name"] }
+          Build.log.detail("本地podspec按配置剪掉未集成的subspec: #{removed_subspec_names.join('、')}")
+          podspec_content["subspecs"] = kept
+          defaults = case podspec_content["default_subspecs"]
+                     when String then podspec_content["default_subspecs"].split(",").map { |d| d.to_s.split("/").last.strip }
+                     when Array then podspec_content["default_subspecs"].map { |d| d.to_s.split("/").last.strip }
+                     else []
+                     end.reject(&:empty?)
+          podspec_content.delete("default_subspecs") unless defaults.empty? || (defaults - build_subspecs).empty?
+        end
+      end
+
+      podspec_content.delete("license")
+
+      # source改写：
+      # - http归档git化组件(克隆内podspec仍带source.http)：整体替换为镜像仓git+tag引用，
+      #   避免http与git两种来源并存导致CocoaPods解析冲突；tag即git化时在镜像仓打的版本tag
+      # - git源组件：替换git地址；非三方库再补version/tag(三方库沿用上游tag)
+      if podspec_content["source"].is_a?(Hash) && podspec_content["source"]["http"]
+        podspec_content["source"] = {"git" => ssh_url, "tag" => version_tag}
+        Build.log.detail("http归档组件source已改写为镜像仓引用: #{ssh_url} (tag: #{version_tag})")
+      else
+        podspec_content["source"]["git"] = ssh_url
+
+        unless self.third
+          podspec_content["version"] = pod_version_final
+          # 一仓多组件时tag带组件名前缀(Foo/1.0.0)，默认无前缀
+          podspec_content["source"]["tag"] = version_tag
+        end
+      end
+
+      # 含Swift源码但未声明Swift版本的podspec补全默认版本，避免纯OC壳工程 pod install 失败
+      ensure_swift_version(podspec_content)
+
+      # 处理有些库因为缺少配置导致的编译问题
+      if pod_name == "CocoaHTTPServer"
+        podspec_content["pod_target_xcconfig"] = {'GCC_PREPROCESSOR_DEFINITIONS' => ['$(inherited)', 'DD_LEGACY_MACROS=1']}
+      elsif pod_name == "Protobuf"
+        podspec_content["pod_target_xcconfig"] = {'GCC_PREPROCESSOR_DEFINITIONS' => ['$(inherited)', 'GPB_USE_PROTOBUF_FRAMEWORK_IMPORTS=1']}
+      end
+
+      # 处理MLeaksFinder公开头文件
+      if pod_name == "MLeaksFinder"
+        podspec_content["public_header_files"] << "MLeaksFinder/MLeaksMessenger.h"
+      end
+
+      # 工具生成的扩展信息统一收敛到 build_metadata 字段，
+      # 嵌套对象会被 CocoaPods 整体忽略，避免自定义key污染/冲突官方podspec属性
+      metadata = {
+        "address" => http_url,
+        "committer" => last_commit.committer,
+        "commit_id" => last_commit.commit_id,
+        "commit_message" => last_commit.commit_msg,
+        "commit_time" => last_commit.commit_time,
+        "commit_email" => last_commit.commit_mail,
+        "tool_version" => Pod::BinaryPack::VERSION,
+        "note" => "这是一份自动生成的文件, 请勿手动修改"
+      }
+
+      # http归档git化组件补充归档溯源信息(原始归档地址与实际计算的sha256)
+      github_helper = Build::GithubHelper.instance
+      if github_helper.http_source
+        metadata["archive_url"] = github_helper.archive_url
+        metadata["archive_sha256"] = github_helper.archive_sha_actual if github_helper.archive_sha_actual
+      end
+
+      # 与官方原始podspec存在subspec集合差异(互斥subspec按配置剪裁)时显式说明，
+      # 该字段会随podspec_content一并带入二进制spec的build_metadata
+      if removed_subspec_names.any?
+        metadata["subspec_note"] = "该组件subspec存在互斥关系，本spec与官方原始podspec存在差异：" \
+          "按配置仅集成 #{build_subspecs.join('、')}，剪掉 #{removed_subspec_names.join('、')}，" \
+          "default_subspecs 已同步调整；如需其他subspec组合请调整 build.yml components.subspecs 后重新打包"
+      end
+
+      podspec_content[PODSPEC_METADATA_KEY] = metadata
+
+      # 更新属性
+      @podspec_content = podspec_content
+      __update_framework_name(podspec_content)
+
+      # 更新最低版本号
+      platforms = podspec_content["platforms"]
+      if platforms and platforms.class == Hash and platforms["ios"]
+        @ios_version = platforms["ios"]
+      end
+
+      ## 重写文件
+      new_file = File.new(podspec_json_path, "w+")
+      if new_file
+        new_file.syswrite(JSON.pretty_generate(podspec_content))
+      end
+    end
+
+    private
+
+    # podspec本身未声明 swift_version/swift_versions，且root或任一(含嵌套)subspec确实包含
+    # .swift源文件时，补全默认Swift版本。纯OC组件/已声明版本的组件不改动
+    def ensure_swift_version(spec)
+      return if spec['swift_version'] || spec['swift_versions']
+      return unless contains_swift_sources?(spec)
+
+      spec['swift_version'] = DEFAULT_SWIFT_VERSION
+      Build.log.detail("podspec未声明swift_version/swift_versions，但root或subspec中检测到Swift源文件，" \
+                       "已自动补全 swift_version=#{DEFAULT_SWIFT_VERSION}（否则纯OC壳工程集成时pod install无法确定Swift版本）")
+    end
+
+    # root及全部subspec的source_files中是否存在.swift文件
+    def contains_swift_sources?(spec)
+      collect_specs(spec).any? do |sub_spec|
+        Array(sub_spec['source_files']).any? do |pattern|
+          FileHelper.source_files_under(File.join(component_root_dir, pattern))
+             .any? { |file_path| File.extname(file_path).downcase == '.swift' }
+        end
+      end
+    end
+
+    def __update_framework_name(podspec_content)
+      # 如果指定了module_name 就取这个名字，否则就取pod_name作为framework_name
+      framework_name = podspec_content["module_name"]
+      header_dir = podspec_content["header_dir"]
+      if framework_name.nil?
+        # 如果没有，就取一下head_dir试试
+        framework_name = header_dir ? header_dir : pod_name
+      end
+
+      # 解决pod库名字中+ 和- 被转成_的问题
+      framework_name = framework_name.gsub("-", "_")
+      framework_name = framework_name.gsub("+", "_")
+
+      @framework_name = framework_name
+    end
+
+    public def git_tag
+      # http归档组件：版本tag在fork阶段就地git化时已处理(镜像仓同名tag默认跳过/force_cover强制覆盖)，
+      # 且克隆处于tag检出的detached状态，无法走"拉取+打tag"常规流程，直接跳过
+      return if Build::GithubHelper.instance.http_source
+
+      unless self.third
+        super
+      end
+
+      if self.third and build_item.force_cover
+        super
+      end
+
+    end
+  end
+end

data/lib/core/repo_xcode.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+require_relative 'repo'
+require 'xcodeproj'
+
+module Build
+  class RepoXCode < Repo
+    attr_reader :xcworkspace
+    attr_reader :scheme
+    # @return [Boolean] archive 时是否启用代码签名
+    attr_reader :code_signing
+    # @return [String, nil] 签名团队ID(仅 code_signing=true 时生效)
+    attr_reader :development_team
+
+    def initialize(path, ssh_url, branch, xcworkspace = nil, scheme = nil,
+                   code_signing: false, development_team: nil)
+      super(path, ssh_url, branch)
+      @xcworkspace = xcworkspace
+      @scheme = scheme
+      @code_signing = code_signing
+      @development_team = development_team
+    end
+
+    def pod_update
+      current = FileUtils.pwd
+      Dir.chdir(self.path)
+      dir_name = File.basename(self.path)
+
+      command = "pod update"
+      Build.log.step("(#{dir_name})执行pod命令")
+      Build.log.debug(command)
+      res = system command
+      unless res == true
+        error = "pod命令执行失败: #{command}"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      Dir.chdir(current)
+    end
+  end
+end