pod-binary-pack 1.0.0

data/lib/core/repo_cocoapods.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative 'repo'
+require_relative 'repo_module'
+
+module Build
+  class RepoCocoapods < Repo
+
+    # @return [RepoModule]
+    attr_accessor :repo_module
+
+    #获取某个pod_name的所有版本号
+    # @return [Array] 返回数组或nil
+    def pod_name_versions(pod_name)
+      pod_name_path = "#{self.path}/#{pod_name}"
+      unless File.directory?(pod_name_path)
+        return nil
+      end
+
+      entries = Dir.entries(pod_name_path)
+      entries.select { |entry| entry != '.' && entry != '..' }
+    end
+
+    def copy_podspec(repo_module)
+      @repo_module = repo_module
+      Build.log.step("拷贝podspec文件到cocoapods中(#{File.basename(self.path)}):")
+
+      # 判断文件夹是否存在
+      pod_name = repo_module.pod_name
+      pod_version_final = repo_module.pod_version_final
+      pod_name_path = "#{self.path}/#{pod_name}"
+
+      unless File.directory?(pod_name_path)
+        Dir.mkdir(pod_name_path)
+      end
+
+      pod_version_path = "#{pod_name_path}/#{pod_version_final}"
+      if File.directory?(pod_version_path)
+        if not repo_module.build_item.snapshot and not repo_module.third
+          error = "#{pod_name}已发布相同版本#{pod_version_final},请更换更高的版本号"
+          pusher.push("❌ 打包失败", error)
+          Process.exit(-1)
+        end
+      else
+        Dir.mkdir(pod_version_path)
+      end
+
+      FileUtils.cp(repo_module.podspec_json_path, pod_version_path)
+
+      # 移除掉已有的podspec文件
+      podspec_path = "#{pod_version_path}/#{pod_name}.podspec"
+      if File.exist?(podspec_path)
+        FileUtils.rm(podspec_path)
+      end
+      Build.log.detail("podspec 拷贝完毕")
+    end
+
+    def git_commit(commit_msg = nil)
+      commit_msg = repo_module.get_commit_msg
+      super commit_msg
+    end
+
+  end
+end

data/lib/core/repo_module.rb

@@ -0,0 +1,281 @@
+# frozen_string_literal: true
+
+require_relative 'repo'
+require_relative 'build_item'
+
+module Build
+
+  class RepoModule < Repo
+    # podspec 扩展字段：构建期写入的元数据(源码commit信息/产物架构/校验和等)。
+    # 命名刻意与 gem 名解耦，工具后续重命名不影响该数据契约；
+    # 未知嵌套字段会被 CocoaPods 整体忽略，不会与官方 podspec 属性冲突。
+    PODSPEC_METADATA_KEY = 'build_metadata'.freeze
+
+    # 版本分支默认前缀(build.yml 可在 profile 中通过 release_branch_prefix 定制)
+    DEFAULT_RELEASE_BRANCH_PREFIX = 'release'.freeze
+
+    # 分支中可解析的版本号规则(不限制段数)：
+    #   主体: 至少两段点分数字，如 1.2 / 1.2.0 / 1.2.2.0
+    #   后缀(可选): 以 - 或 + 起始的字母数字串(内部允许 . -)，如 1.2.2-fix / 1.2.2-beta.1 / 1.2.0+build.3
+    VERSION_PATTERN = '\\d+(?:\\.\\d+)+(?:[-+][0-9A-Za-z](?:[0-9A-Za-z.-]*[0-9A-Za-z])?)?'.freeze
+
+    # 从版本分支名解析出版本号，不符合规则返回nil。
+    # 规则: <前缀> + 可选分隔符(_/-) + 版本号(如 release_1.2.0 / release-1.2.2-fix)。
+    # 前缀本身已带分隔符(如 "release/")也兼容；版本部分须符合 VERSION_PATTERN，乱七八糟的字符不解析
+    # @param branch [String] 分支名
+    # @param prefix [String, nil] 前缀，空则用默认 release
+    # @return [String, nil]
+    def self.parse_version_from_branch(branch, prefix = nil)
+      p = prefix.to_s.strip
+      p = DEFAULT_RELEASE_BRANCH_PREFIX if p.empty?
+      match = branch.to_s.match(/\A#{Regexp.escape(p)}([_-]?)(#{VERSION_PATTERN})\z/)
+      match && match[2]
+    end
+
+    # @return [BuildItem] 构建参数
+    attr_accessor :build_item
+    attr_accessor :pod_name
+    attr_accessor :pod_version
+    # 内部三方库处理标记(不锁分支/不改版本tag/允许同版本重复发布等)。
+    # 已无对外 --third 入口，仅 fork-github 流程由 CLI 内部置为 true，自研组件恒为 false
+    attr_accessor :third
+    attr_accessor :snapshot
+    attr_accessor :pod_version_final
+
+    # @return [String] podspec_json路径
+    attr_accessor :podspec_json_path
+
+    # @return [JSON] podspec_content
+    attr_accessor :podspec_content
+
+    # @return [String] 区别于pod_name， 特指打包后的framework的名字
+    attr_accessor :framework_name
+
+    # @return [Build::Hosting::RepoInfo] 代码托管平台上的仓库信息(Gitee为full_name，GitLab为数字ID)
+    attr_accessor :repo_info
+
+    # @return [String, nil] podspec相对仓库根目录的路径(podspec不在根目录时使用，如 Sub/Foo.podspec)
+    attr_accessor :podspec_rel_path
+
+    # @return [Array<String>, nil] 显式指定的打包集成subspec短名列表(nil=默认集成全部)。
+    # 用于互斥subspec组件(如FMDB的standard/standalone/SQLCipher是不同sqlite后端，全量合并编译必冲突)，
+    # 经 build.yml components.<组件>.subspecs 或 --subspecs 声明
+    attr_accessor :build_subspecs
+
+    # @return [String, nil] 一仓多组件时的源码tag前缀(如 "Foo/")，最终tag为 Foo/1.0.0；二进制一组件一仓不使用
+    attr_accessor :tag_prefix
+
+    # @return [String] 版本分支前缀(分支名形如 release_1.2.0 时可从中解析版本号)
+    attr_accessor :release_branch_prefix
+
+    def initialize(path, ssh_url, branch, pod_name, pod_version, third, build_item,
+                   podspec_rel_path: nil, tag_prefix: nil, release_branch_prefix: nil,
+                   build_subspecs: nil)
+      super(path, ssh_url, branch)
+      @pod_name = pod_name
+      @pod_version = pod_version
+      @third = third.to_s.downcase == "true"
+      @build_item = build_item
+      @podspec_rel_path = podspec_rel_path.to_s.strip
+      @podspec_rel_path = nil if @podspec_rel_path && @podspec_rel_path.empty?
+      # subspec覆盖列表：规范化为去空白的短名数组，全空视为未指定(nil=集成全部)
+      @build_subspecs = Array(build_subspecs).map { |s| s.to_s.strip }.reject(&:empty?)
+      @build_subspecs = nil if @build_subspecs.empty?
+      prefix = tag_prefix.to_s.strip
+      @tag_prefix = if prefix.empty? || prefix.end_with?('/')
+                      prefix.empty? ? nil : prefix
+                    else
+                      "#{prefix}/"
+                    end
+      custom_prefix = release_branch_prefix.to_s.strip
+      @release_branch_prefix = custom_prefix.empty? ? DEFAULT_RELEASE_BRANCH_PREFIX : custom_prefix
+      validate
+      analyzer
+    end
+
+    def validate
+
+      if pod_name.empty?or pod_version.empty?
+        error = "pod_name pod_version 均不能为空"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      if pod_name == "xxx" or pod_version == "xxx" or ssh_url == "xxx" or branch == "xxx"
+        error = "pod_name pod_version ssh_url branch 任一个都不能为xxx"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      if pod_version.include?("SNAPSHOT")
+        error = "版本号里不能带SNAPSHOT，如需SNAPSHOT请使用snapshot参数"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      if self.third and self.build_item.snapshot
+        error = "三方库不能打SNAPSHOT包"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+    end
+
+    def analyzer
+      @pod_version_final = self.build_item.snapshot ? pod_version+"-SNAPSHOT" : pod_version
+    end
+
+    # 打在组件仓上的实际tag名：一仓多组件时带组件名前缀(Foo/1.0.0)避免共仓tag冲突，
+    # 默认无前缀即裸版本号；二进制一组件一仓，前缀始终为空
+    def version_tag
+      "#{tag_prefix}#{pod_version_final}"
+    end
+
+    # 组件文件匹配根目录(实现文件/资源的相对路径基准)，默认仓库根目录；
+    # podspec在子目录时由RepoModuleSource覆写为podspec所在目录(CocoaPods :podspec 语义一致)
+    def component_root_dir
+      path
+    end
+
+    # 是否构建了二进制
+    def build_binary
+      build_item.real_device or build_item.simulator
+    end
+
+    def update_binary
+      # Array()+dup 避免直接持有podspec_content内部的数组引用被后续append污染
+      source_files_array = Array(podspec_content["source_files"]).dup
+
+      sub_specs = podspec_content["subspecs"]
+      if sub_specs
+        sub_specs.each do |sub_spec|
+          # Array(nil)=[]，subspec未声明source_files时安全跳过；元素统一展平为一维
+          source_files_array.concat(Array(sub_spec["source_files"]))
+        end
+      end
+
+      # 定制组件：不编译framework，也不发布二进制(名单见BuildItem::NO_BINARY_PODS)
+      if Build::BuildItem::NO_BINARY_PODS.include?(pod_name)
+        build_item.real_device = false
+        build_item.simulator = false
+        build_item.header_only = false
+        warn_msg = "定制组件#{pod_name}不需要打二进制"
+        Build.log.warn(warn_msg)
+        pusher.push("【⚠️组件不构建二进制提醒】", warn_msg)
+        return
+      end
+
+      have_implementation = false
+      have_header = false
+      # 包含子模块的所有；source_files 可能是 glob、单个文件，也可能直接指向目录
+      source_files_array.each do |source_files|
+        source_files_path = "#{component_root_dir}/#{source_files}"
+        if FileHelper.have_implementation_files(source_files_path)
+          have_implementation = true
+          break
+        end
+        # 记录是否至少匹配到头文件(纯头文件组件判定)
+        have_header = true if FileHelper.have_header_files(source_files_path)
+      end
+
+      if not have_implementation
+        build_item.real_device = false
+        build_item.simulator = false
+        if have_header
+          # 纯头文件组件：不编译framework，但仍发布头文件形态的二进制podspec，
+          # 保证二进制spec源也能解析到该组件(App默认优先二进制源)
+          build_item.header_only = true
+          warn_msg = "当前组件无实现文件(纯头文件组件)，不编译framework，但仍发布头文件形态的二进制podspec"
+          Build.log.warn(warn_msg)
+          pusher.push("【⚠️纯头文件组件提醒】", warn_msg)
+        else
+          build_item.header_only = false
+          warn_msg = "当前组件无实现文件也无头文件，不构建二进制"
+          Build.log.warn(warn_msg)
+          pusher.push("【⚠️组件不构建二进制提醒】", warn_msg)
+        end
+      end
+    end
+
+    # 按配置裁剪了subspec的组件(update_podspec 会在build_metadata写入subspec_note)，
+    # 各仓库提交信息据此追加关键字，便于在提交历史中快速识别与检索
+    def subspec_pruned?
+      metadata = podspec_content[PODSPEC_METADATA_KEY] || {}
+      !metadata["subspec_note"].to_s.empty?
+    end
+
+    # 各仓库提交信息的关键字前缀：裁剪subspec / 模拟器产物裁剪arm64架构，可同时存在；
+    # 统一放在提交信息最前边，git log 列表展示被截断时也能看到
+    def commit_keyword_prefix
+      prefix = +""
+      prefix << "[裁剪subspec] " if subspec_pruned?
+      prefix << "[裁剪架构] " if build_item.respond_to?(:simulator_exclude_arm64) && build_item.simulator_exclude_arm64
+      prefix
+    end
+
+    def get_commit_msg
+      # 扩展信息统一读取 build_metadata 嵌套字段
+      metadata = podspec_content[PODSPEC_METADATA_KEY] || {}
+      committer = metadata["committer"]
+      commit_time = metadata["commit_time"]
+      # 提交信息里的 SHA 仅供人工溯源，对齐 CocoaPods 官方 Specs 仓惯例取 7 位短哈希；
+      # 注意：build_metadata.commit_id(podspec.json 内)必须保留完整 40 位，
+      # 发布校验需拿它与 Gitee/GitLab API 返回的完整 SHA 精确比对，不可一并缩短
+      short_commit_id = metadata["commit_id"].to_s[0, 7]
+      "#{commit_keyword_prefix}#{self.pod_name} #{self.pod_version_final} (#{committer} #{commit_time} #{short_commit_id})"
+    end
+
+    # 重写父类方法
+    def git_commit(commit_msg = nil)
+      commit_msg = get_commit_msg
+      super commit_msg
+    end
+    
+    # 打标签
+    def git_tag
+      current = Dir.pwd
+      Dir.chdir(self.path)
+
+      dir_name = File.basename(self.path)
+      Build.log.step("推送版本号tag(#{dir_name})")
+
+      # 丢弃修改并拉取代码
+      discard_pull
+
+      tag = version_tag
+
+      # snapshot和三方库 需要删除老的标签
+      if self.build_item.snapshot or self.third
+        # 删除本地标签
+        git_tag_delete_local(tag)
+
+        # 删除远端标签
+        git_tag_delete_origin(tag)
+      end
+
+      # 本地打标签
+      git_tag_local(tag)
+
+      # 推送到远端
+      git_tag_origin(tag)
+
+      Dir.chdir(current)
+    end
+
+    # 重写父类方法 clone完毕后获取仓库信息
+    def git_clone(only_head)
+      super
+      info = hosting.find_project(pod_name, http_url, can_raise: true)
+
+      unless info
+        return
+      end
+
+      @repo_info = info
+      Build.log.info("查询(#{http_url})仓库信息: #{info.full_name} 命名空间:#{info.namespace_path}")
+
+    end
+
+  end
+
+end