pod-binary-pack 1.0.0

data/lib/core/repo_module_binary.rb

@@ -0,0 +1,439 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'json'
+require 'digest'
+require_relative 'repo_module'
+require_relative 'util/file_helper'
+
+module Build
+  class RepoModuleBinary < RepoModule
+
+    attr_accessor :framework_binary_path
+
+    # 合并二进制
+    def copy_framework(repo_xcode_package, repo_module_source)
+      build_real_device = build_item.real_device
+      build_simulator = build_item.simulator
+      if not build_real_device and not build_simulator
+        return
+      end
+
+      @framework_name = repo_module_source.framework_name
+
+      origin_framework_real_device = "#{repo_xcode_package.real_device_archive_path}/Products/Library/Frameworks/#{framework_name}.framework"
+      origin_framework_simulator = "#{repo_xcode_package.simulator_archive_path}/Products/Library/Frameworks/#{framework_name}.framework"
+
+      if build_real_device and not File.exist?(origin_framework_real_device)
+        error = "真机架构framework不存在"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      if build_simulator and not File.exist?(origin_framework_simulator)
+        error = "模拟器架构framework不存在"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      @framework_binary_path = "#{self.path}/#{framework_name}.xcframework"
+
+      command = "xcodebuild -create-xcframework"
+
+      if build_real_device
+        command += " -framework \"#{origin_framework_real_device}\""
+      end
+
+      if build_simulator
+        command += " -framework \"#{origin_framework_simulator}\""
+      end
+
+      command += " -output \"#{framework_binary_path}\""
+
+      Build.log.step("合并并拷贝framework(#{File.basename(self.path)})")
+      Build.log.debug(command)
+
+      res = system command
+
+      unless res == true
+        error = "合并framework失败"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+    end
+
+    def copy_resources(repo_xcode_package, repo_module_source)
+      Build.log.step("拷贝资源文件到framework中(#{File.basename(self.path)})")
+      bundle_path_array = repo_xcode_package.resource_bundles_paths
+      resource_paths = repo_xcode_package.resource_paths
+
+      if bundle_path_array.length == 0
+        Build.log.detail("源码podspec里未指定resource_bundles")
+      end
+      if resource_paths.length == 0
+        Build.log.detail("源码podspec里未指定resource")
+      end
+
+      result_array = bundle_path_array + resource_paths
+      result_array.each { |p| Build.log.debug("资源文件: #{p}") }
+      if result_array.length == 0
+        Build.log.detail("无资源文件，不拷贝")
+        return
+      end
+
+      # 获取framework路径
+      framework_path_array = Array.new
+      framework = "#{repo_module_source.framework_name}.framework"
+      FileHelper.recursion_find(self.path, framework, framework_path_array)
+      framework_path_array.each { |p| Build.log.debug("目标framework: #{p}") }
+
+      # 拷贝到目标路径
+      framework_path_array.each { |framework_path|
+        result_array.each { |bundle_path|
+          bundle_name = File.basename(bundle_path)
+          des_bundle_path = "#{framework_path}/#{bundle_name}"
+          # 如果不存在 则拷贝
+          unless File.exist?(des_bundle_path)
+            FileUtils.cp_r(bundle_path, framework_path)
+          end
+        }
+      }
+      Build.log.detail("资源文件拷贝完成")
+    end
+
+    def copy_podspec(repo_xcode_package, repo_module_source)
+
+      build_real_device = build_item.real_device
+      build_simulator = build_item.simulator
+      if not build_real_device and not build_simulator
+        return
+      end
+
+      Build.log.step("拷贝podspec文件到framework中(#{File.basename(self.path)})")
+      @podspec_json_path = "#{self.path}/#{self.pod_name}.podspec.json"
+
+      # xcframework 内 slice 目录名不固定(不同Xcode/构建参数产物不同)，必须动态解析:
+      #   真机: 通常 ios-arm64
+      #   模拟器: 旧Intel-only为 ios-x86_64-simulator；Apple Silicon fat为 ios-arm64_x86_64-simulator；仅arm64为 ios-arm64-simulator
+      # 本方法返回的是 podspec resources glob 用的 slice 目录名(真机/模拟器二选一)
+      source_files_dir = xcframework_slice_dir(device: build_real_device, simulator: build_simulator)
+      unless source_files_dir
+        error = "无法在#{framework_binary_path}中解析到#{build_real_device ? '真机' : '模拟器'}slice目录"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      # 原始podspec
+      @podspec_content = repo_module_source.podspec_content
+
+      podspec_content.delete("license")
+      podspec_content.delete("module_map")
+      podspec_content.delete("public_header_files")
+      podspec_content.delete("private_header_files")
+      podspec_content.delete("exclude_files")
+      podspec_content.delete("prefix_header_file")
+      # 二进制包仅含 xcframework，没有源码，prepare_command 既无意义也无处执行；
+      # 保留会导致安装期(如 SQLCipher 的 ./configure)在二进制仓 checkout 目录
+      # 因脚本不存在直接报错，因此所有组件的二进制 spec 统一移除
+      podspec_content.delete("prepare_command")
+
+      podspec_content["source"] = {} #二进制后, 只从tag读取，去除其他的标志信息
+      podspec_content["source"]["git"] = self.ssh_url
+      podspec_content["source"]["tag"] = self.pod_version_final
+
+      podspec_content["source_files"] = "**/*/#{source_files_dir}/*.framework/Headers/*.h"
+      podspec_content["version"] = self.pod_version_final
+      podspec_content["vendored_frameworks"] = "*.xcframework"
+
+      # 资源统一汇总root及所有subspec(多subspec整包构建后资源都在同一个framework内)
+      podspec_content["resources"] = []
+
+      # 1) 松散resources/resource glob：按glob在源码工作副本中找到真实文件后映射进framework
+      repo_module_source.all_resource_globs.each do |resource|
+        # 子目录podspec时先按podspec所在目录匹配，再回退仓库根目录
+        search_roots = [repo_module_source.component_root_dir, repo_module_source.path].uniq
+        real_paths = search_roots.flat_map { |root| Dir["#{root}/#{resource}"] }.uniq
+        real_paths.each do |real_path|
+          resource_name = File.basename(real_path)
+          podspec_content["resources"] << "**/*/#{source_files_dir}/*.framework/#{resource_name}"
+        end
+      end
+      podspec_content.delete("resource")
+
+      # 2) resource_bundles：root及各subspec声明的bundle名(整包构建后均在framework内)
+      repo_module_source.all_resource_bundle_names.each do |bundle_name|
+        podspec_content["resources"] << "**/*/#{source_files_dir}/*.framework/#{bundle_name}.bundle"
+      end
+      podspec_content.delete("resource_bundles")
+      podspec_content.delete("resource_bundle")
+      podspec_content["resources"].uniq!
+
+      # 资源文件-podspec
+      podspec_content["resources"] << "**/*/#{source_files_dir}/*.framework/*.podspec.json"
+
+      # 二进制扩展信息：源码podspec已带build_metadata基础字段，这里补充产物相关信息
+      metadata = podspec_content[PODSPEC_METADATA_KEY] || {}
+      # 代码地址改为二进制仓库地址
+      metadata["address"] = self.http_url
+      metadata["archive"] = repo_xcode_package.debug_mode ? "Debug" : "Release"
+      # 组件在整体App包中的实际占用体积(只统计真机slice的framework，排除dSYM/模拟器slice/podspec)
+      metadata["framework_size"] = framework_size_format
+      # 是否SNAPSHOT包
+      metadata["snapshot"] = build_item.snapshot
+      # xcframework实际包含的CPU架构，按真机/模拟器分类
+      metadata["architectures"] = xcframework_architectures
+      # 构建所用Xcode版本，如 16.4 (16F6)
+      metadata["xcode_version"] = xcode_version
+      # xcframework产物中是否包含dSYM调试符号
+      metadata["include_dsym"] = include_dsym?
+      # xcframework内Mach-O二进制的SHA256，用于产物完整性校验/比对
+      metadata["framework_checksum"] = xcframework_checksum
+      podspec_content[PODSPEC_METADATA_KEY] = metadata
+
+      # swift
+      if podspec_content.has_key?("swift_version")
+        podspec_content["pod_target_xcconfig"] = {"BUILD_LIBRARY_FOR_DISTRIBUTION": true}
+      end
+
+      # 处理子仓库
+      subspecs = podspec_content["subspecs"]
+      if subspecs.respond_to?(:each)
+        subspecs.each do |subspec|
+          subspec.delete("resources")
+          subspec.delete("resource_bundles")
+          subspec.delete("exclude_files")
+          subspec.delete("public_header_files")
+          subspec.delete("project_header_files")
+          if subspec["ios"] and subspec["ios"].class == Hash
+            sun = subspec["ios"]
+            sun.delete("resources")
+            sun.delete("resource_bundles")
+            sun.delete("exclude_files")
+            sun.delete("public_header_files")
+            sun.delete("project_header_files")
+            sun.delete("source_files")
+          end
+          subspec["source_files"] = "placeholder.m"
+        end
+      end
+
+      ## 重写文件
+      new_file = File.new(podspec_json_path, "w+")
+      if new_file
+        new_file.syswrite(JSON.pretty_generate(podspec_content))
+      end
+
+      # 拷贝podspec文件到实际存在的真机/模拟器slice(目录名动态解析)
+      [xcframework_slice_dir(device: true), xcframework_slice_dir(simulator: true)].compact.uniq.each do |slice_dir|
+        framework_slice_path = File.join(framework_binary_path, slice_dir, "#{framework_name}.framework")
+        FileUtils.cp(podspec_json_path, framework_slice_path) if File.directory?(framework_slice_path)
+      end
+      Build.log.detail("framework 产物拷贝完成")
+    end
+
+    # 从xcframework的Info.plist解析真机/模拟器slice的目录名(LibraryIdentifier)。
+    # 兼容三种命名: ios-arm64(真机) / ios-x86_64-simulator(旧Intel) /
+    # ios-arm64_x86_64-simulator(fat) / ios-arm64-simulator(仅arm64)
+    # @return [String, nil] slice目录名
+    def xcframework_slice_dir(device: false, simulator: false)
+      @xcframework_slices ||= parse_xcframework_slices
+      if simulator
+        @xcframework_slices[:simulator]
+      elsif device
+        @xcframework_slices[:device]
+      end
+    end
+
+    def parse_xcframework_slices
+      slices = { device: nil, simulator: nil }
+      plist_path = File.join(framework_binary_path, 'Info.plist')
+      json_text = `plutil -convert json -o - "#{plist_path}" 2>/dev/null`
+      libraries = JSON.parse(json_text)["AvailableLibraries"] || []
+      libraries.each do |library|
+        identifier = library["LibraryIdentifier"].to_s
+        if library["SupportedPlatformVariant"] == "simulator"
+          slices[:simulator] ||= identifier
+        elsif library["SupportedPlatform"] == "ios"
+          slices[:device] ||= identifier
+        end
+      end
+      slices
+    rescue => e
+      Build.log.warn("解析xcframework slice目录失败(#{framework_binary_path})：#{e.message}")
+      slices
+    end
+
+    # 解析xcframework实际包含的CPU架构，按真机/模拟器分类汇总
+    # @return [Hash] 如 {"device"=>["arm64"], "simulator"=>["arm64"]}
+    def xcframework_architectures
+      result = {"device" => [], "simulator" => []}
+      plist_path = "#{framework_binary_path}/Info.plist"
+
+      begin
+        # 使用系统自带 plutil 将 Info.plist 转成 JSON 读取 AvailableLibraries
+        json_text = `plutil -convert json -o - "#{plist_path}" 2>/dev/null`
+        libraries = JSON.parse(json_text)["AvailableLibraries"] || []
+        libraries.each do |library|
+          # xcframework中真机/模拟器的 SupportedPlatform 均为 "ios"，
+          # 模拟器slice通过 SupportedPlatformVariant == "simulator" 区分
+          if library["SupportedPlatformVariant"] == "simulator"
+            platform = "simulator"
+          elsif library["SupportedPlatform"] == "ios"
+            platform = "device"
+          else
+            next
+          end
+          (library["SupportedArchitectures"] || []).each { |arch| result[platform] << arch }
+        end
+      rescue => exception
+        Build.log.warn("解析xcframework架构信息失败：#{exception.message}，将按本次构建开关兜底为arm64")
+      end
+
+      # 兜底：plist解析失败时按本次构建开关记录arm64
+      if result["device"].empty? && result["simulator"].empty?
+        result["device"] = ["arm64"] if build_item.real_device
+        result["simulator"] = ["arm64"] if build_item.simulator
+      end
+
+      result.transform_values { |archs| archs.uniq.sort }
+    end
+
+    # 组件在整体App包中的实际占用体积：
+    # - framework组件：只统计真机slice的Foo.framework(Mach-O二进制+资源bundle+Info.plist)，
+    #   排除dSYM、模拟器slice、podspec.json等不会进入App包的内容；仅模拟器构建时退化为统计模拟器slice。
+    #   注意这是"解压后占用"口径，非App Store压缩后的下载体积
+    # - 纯头文件组件：头文件仅参与编译，不进入App包，体积贡献为0
+    # - 解析不到framework目录时视为产物结构异常，直接打包失败
+    # @return [String] 体积描述(KB/MB格式)
+    def framework_size_format
+      return "0KB" if build_item.header_only
+
+      # 真机包才是发布给用户的产物；仅模拟器构建时用模拟器slice兜底
+      slice = xcframework_slice_dir(device: true) || xcframework_slice_dir(simulator: true)
+      framework_dir = slice ? File.join(framework_binary_path, slice, "#{framework_name}.framework") : nil
+
+      unless framework_dir && File.directory?(framework_dir)
+        error = "无法在#{framework_binary_path}中解析到进App包的framework目录，产物结构异常"
+        pusher.push("❌ 打包失败", error)
+        Process.exit(-1)
+      end
+
+      total = Dir.glob(File.join(framework_dir, '**', '*'))
+                 .select { |f| File.file?(f) }
+                 .sum { |f| File.size(f).to_f / 1024 }
+      total > 1024 ? "#{(total * 0.001).round(1)}MB" : "#{total.round(0)}KB"
+    end
+
+    # xcframework产物中是否包含dSYM调试符号
+    # @return [Boolean]
+    def include_dsym?
+      !Dir.glob("#{framework_binary_path}/**/*.dSYM").empty?
+    end
+
+    # 本次构建使用的Xcode版本，如 "16.4 (16F6)"，获取失败返回空字符串
+    # @return [String]
+    def xcode_version
+      output = `xcodebuild -version 2>/dev/null`.strip
+      version = output[/Xcode\s+(\S+)/, 1]
+      build = output[/Build version\s+(\S+)/, 1]
+      return "" if version.nil?
+      build ? "#{version} (#{build})" : version
+    end
+
+    # 计算xcframework内各slice的Mach-O可执行文件的合并SHA256。
+    # 只摘要真实二进制内容（按相对路径排序），不受Info.plist时间戳/文件修改时间影响，
+    # 可用于产物完整性校验以及判断两次构建的二进制是否实质一致。
+    # @return [String] 64位SHA256十六进制串，无可用二进制时返回空字符串
+    def xcframework_checksum
+      # 各slice的可执行文件路径形如: ios-arm64/Foo.framework/Foo
+      binary_paths = Dir.glob("#{framework_binary_path}/**/*.framework/*").select do |file_path|
+        File.file?(file_path) && File.basename(file_path) == framework_name
+      end.sort
+
+      return "" if binary_paths.empty?
+
+      digest = Digest::SHA256.new
+      binary_paths.each do |binary_path|
+        relative_path = Pathname.new(binary_path).relative_path_from(Pathname.new(framework_binary_path)).to_s
+        digest.update(relative_path)
+        digest.update(File.binread(binary_path))
+      end
+      digest.hexdigest
+    end
+
+    # 纯头文件组件的二进制发布：二进制仓直接放头文件(保持目录结构) + 普通形态podspec.json。
+    # header-only无需编译，二进制形态与源码等价，不做任何framework转换
+    def publish_header_only(repo_module_source)
+      return unless build_item.header_only
+
+      Build.log.step("纯头文件组件发布(#{File.basename(self.path)})")
+
+      copy_header_only_files(repo_module_source)
+      write_header_only_podspec(repo_module_source)
+
+      Build.log.detail("纯头文件组件头文件拷贝完成")
+    end
+
+    private
+
+    # 按podspec的source_files(root+subspecs)把头文件从源码工作副本按相对目录拷到二进制仓
+    def copy_header_only_files(repo_module_source)
+      podspec_content = repo_module_source.podspec_content
+      globs = Array(podspec_content["source_files"])
+      Array(podspec_content["subspecs"]).each do |subspec|
+        globs.concat(Array(subspec["source_files"]))
+      end
+
+      source_root = repo_module_source.component_root_dir
+      copied = 0
+      globs.flatten.compact.uniq.each do |pattern|
+        # 与判定逻辑一致：source_files 指向目录时递归取其中文件，glob/单文件照常展开
+        FileHelper.source_files_under(File.join(source_root, pattern)).each do |src|
+          relative = Pathname.new(src).relative_path_from(Pathname.new(source_root)).to_s
+          dest = File.join(self.path, relative)
+          FileUtils.mkdir_p(File.dirname(dest))
+          FileUtils.cp(src, dest)
+          copied += 1
+        end
+      end
+      Build.log.detail("纯头文件组件共拷贝#{copied}个文件到二进制仓")
+    end
+
+    # 写普通形态podspec.json：source指向二进制仓tag，保留source_files等原字段
+    def write_header_only_podspec(repo_module_source)
+      # 深拷贝，避免污染源码侧的podspec_content
+      content = JSON.parse(JSON.generate(repo_module_source.podspec_content))
+
+      content.delete("license")
+      content["source"] = { "git" => self.ssh_url, "tag" => self.pod_version_final }
+      content["version"] = self.pod_version_final
+      # 纯头组件不涉及framework，删除仅编译产物相关字段，保留 source_files/public_header_files 等
+      content.delete("vendored_frameworks")
+
+      metadata = content[PODSPEC_METADATA_KEY] || {}
+      metadata["address"] = self.http_url
+      metadata["archive"] = "HeadersOnly"
+      metadata["snapshot"] = build_item.snapshot
+      # 头文件仅参与编译，不进入App包，组件在整体包大小中的实际占用为0
+      metadata["framework_size"] = "0KB"
+      metadata["architectures"] = { "device" => [], "simulator" => [] }
+      metadata["include_dsym"] = false
+      metadata["framework_checksum"] = ""
+      content[PODSPEC_METADATA_KEY] = metadata
+
+      @podspec_json_path = File.join(self.path, "#{self.pod_name}.podspec.json")
+      File.write(@podspec_json_path, JSON.pretty_generate(content))
+      # 供二进制仓 git_commit 读取 build_metadata 生成提交信息
+      @podspec_content = content
+    end
+
+    public
+
+    def git_tag
+      if build_item.real_device or build_item.simulator or build_item.header_only
+        super
+      end
+    end
+
+  end
+end