cocoapods-yaml 1.0.0

data/lib/core/check/simulator_arch.rb

@@ -0,0 +1,145 @@
+require 'json'
+require 'shellwords'
+require 'tempfile'
+
+module Xcodeproj
+
+  # 模拟器架构兼容检查：扫描已安装的二进制依赖(xcframework / fat framework / 静态库.a)，
+  # 找出模拟器产物不含 arm64 slice 的组件。Apple Silicon 上 Xcode 默认按 arm64 编译模拟器
+  # 目标，这类组件无法参与链接(报 framework not found)，只能 Rosetta 运行或重新打包支持。
+  # 源码编译型组件(无预编译二进制)天然支持，不在检查范围
+  class SimulatorArchChecker
+
+    # Pods目录下非组件安装目录(跳过不扫描)
+    SKIP_PODS_DIR_NAMES = ['Headers', 'Local Podspecs', 'Manifest.lock', 'Pods.xcodeproj', 'Target Support Files'].freeze
+
+    def check
+      pods_dir = File.join(Dir.pwd, 'Pods')
+      unless File.directory?(pods_dir)
+        return
+      end
+
+      log.step('模拟器架构检查中...')
+      start = (Time.now.to_f * 1000).to_i
+
+      rosetta = []
+      no_sim = []
+      checked = 0
+
+      Dir.children(pods_dir).sort.each do |name|
+        next if SKIP_PODS_DIR_NAMES.include?(name)
+        pod_dir = File.join(pods_dir, name)
+        next unless File.directory?(pod_dir)
+
+        status = check_pod_dir(pod_dir)
+        next if status == :none
+        checked += 1
+        if status == :rosetta
+          rosetta << name
+        elsif status == :no_sim
+          no_sim << name
+        end
+      end
+
+      if rosetta.any?
+        log.warn('以下组件的模拟器产物不含 arm64 slice，Apple Silicon 上按默认 arm64 编译模拟器会链接失败(报 framework not found)：')
+        log.warn("  #{rosetta.join('、')}")
+        log.warn('建议用打包工具重新发布这些组件以支持 arm64 模拟器；临时可在工程设置 EXCLUDED_ARCHS=arm64 用 Rosetta 模式运行')
+      end
+
+      if no_sim.any?
+        log.warn('以下组件完全不含模拟器 slice，无法在模拟器上编译链接(仅真机可用)：')
+        log.warn("  #{no_sim.join('、')}")
+      end
+
+      duration = (((Time.now.to_f * 1000).to_i - start) * 0.001).round(2)
+      log.info("模拟器架构检查完毕! 共检查#{checked}个含二进制产物的组件(不支持arm64模拟器 #{rosetta.size}个) 耗时:#{duration}秒")
+    end
+
+    private
+
+    def log
+      CocoaPods::Yaml.log
+    end
+
+    # @return [:ok, :rosetta, :no_sim, :none] 组件内预编译二进制的模拟器支持情况(取最差结果)；
+    #   :none 表示目录内没有预编译二进制(源码编译型组件)
+    def check_pod_dir(pod_dir)
+      worst = :none
+      each_binary(pod_dir) do |kind, path|
+        status = classify_binary(kind, path)
+        next if status == :none
+        worst = status if worst == :none || (worst == :rosetta && status == :no_sim)
+      end
+      worst
+    end
+
+    # 遍历组件目录内的预编译二进制：xcframework / fat framework / 静态库.a
+    def each_binary(pod_dir)
+      Dir.glob(File.join(pod_dir, '**', '*.xcframework')).sort.each do |path|
+        yield(:xcframework, path)
+      end
+      Dir.glob(File.join(pod_dir, '**', '*.framework')).sort.reject { |path| path.include?('.xcframework/') }.each do |framework|
+        binary = File.join(framework, File.basename(framework, '.framework'))
+        yield(:framework, binary) if File.file?(binary)
+      end
+      Dir.glob(File.join(pod_dir, '**', '*.a')).sort.reject { |path| path.include?('.xcframework/') }.each do |path|
+        yield(:static, path)
+      end
+    end
+
+    # @return [:ok, :rosetta, :no_sim, :none] :none表示非Mach-O或无Info.plist，跳过不计
+    def classify_binary(kind, path)
+      return xcframework_status(path) if kind == :xcframework
+
+      archs = `lipo -archs #{Shellwords.escape(path)} 2>/dev/null`.split
+      return :none if archs.empty?
+
+      if archs.include?('arm64')
+        return :ok if arm64_supports_simulator?(path)
+        return :rosetta if archs.include?('x86_64')
+        :no_sim
+      else
+        archs.include?('x86_64') ? :rosetta : :no_sim
+      end
+    end
+
+    # xcframework 的模拟器slice架构；Info.plist缺失或解析失败返回nil(跳过不计)
+    def xcframework_status(xcframework_path)
+      archs = xcframework_simulator_archs(xcframework_path)
+      return :none if archs.nil?
+      return :no_sim if archs.empty?
+      return :ok if archs.include?('arm64')
+      archs.include?('x86_64') ? :rosetta : :no_sim
+    end
+
+    # 解析xcframework的Info.plist，返回模拟器slice支持的架构数组(无模拟器slice返回空数组)
+    def xcframework_simulator_archs(xcframework_path)
+      plist_path = File.join(xcframework_path, 'Info.plist')
+      return nil unless File.exist?(plist_path)
+
+      json = `plutil -convert json -o - #{Shellwords.escape(plist_path)} 2>/dev/null`
+      plist = JSON.parse(json) rescue nil
+      libraries = plist.is_a?(Hash) ? plist['AvailableLibraries'] : nil
+      return nil unless libraries.is_a?(Array)
+
+      libraries.select { |lib| lib['SupportedPlatformVariant'] == 'simulator' }
+               .flat_map { |lib| Array(lib['SupportedArchitectures']) }
+    end
+
+    # arm64 slice 是否支持模拟器：现代 arm64-simulator 目标必带 LC_BUILD_VERSION 且
+    # platform 为 7(iOSSimulator)；其余情况(LC_VERSION_MIN_IPHONEOS 或 platform=iOS)均为真机
+    def arm64_supports_simulator?(binary)
+      Tempfile.create(['arm64_slice', '.a']) do |tmp|
+        tmp.close
+        unless system("lipo #{Shellwords.escape(binary)} -thin arm64 -output #{Shellwords.escape(tmp.path)}",
+                      out: File::NULL, err: File::NULL)
+          return false
+        end
+        load_info = `otool -l #{Shellwords.escape(tmp.path)} 2>/dev/null`
+        load_info.include?('LC_BUILD_VERSION') && load_info.match?(/\bplatform\s+7\b/)
+      end
+    end
+
+  end
+end

data/lib/core/check/util.rb

@@ -0,0 +1,37 @@
+module Xcodeproj
+  class Util
+    #读取podspec内容
+    # @return [Hash]
+    # @param podspec_path::[Pathname]
+    def self.get_podspec_content(podspec_path)
+
+      podspec_json_path = podspec_path.to_s.end_with?(".podspec.json") ? podspec_path : nil
+
+      podspec_content = nil
+      if podspec_json_path and File.exist?(podspec_json_path)
+        json = File.read(podspec_json_path)
+        podspec_content = JSON.parse(json)
+      elsif podspec_path and File.exist?(podspec_path)
+        json = get_podspec_file_content(podspec_path)
+        podspec_content = JSON.parse(json)
+      end
+      podspec_content
+    end
+
+    # 根据podspec路径把podspec转为json
+    def self.get_podspec_file_content(podspec_path)
+
+      spec_contents = File.open(podspec_path, 'r:utf-8', &:read)
+
+      if spec_contents.respond_to?(:encoding) && spec_contents.encoding.name != 'UTF-8'
+        spec_contents.encode!('UTF-8')
+      end
+
+      path = Pathname.new(podspec_path)
+
+      spec = ::Pod._eval_podspec(spec_contents, path)
+
+      spec.to_json
+    end
+  end
+end

data/lib/core/check/xcodeproj.rb

@@ -0,0 +1,81 @@
+require 'xcodeproj'
+require 'pathname'
+
+module XCProject
+
+  class XcodeprojManager
+
+    # 缓存某个的依赖库
+    # {{"module_nameA":["module_nameA", module_nameB]},}
+    attr_reader :module_frameworks
+
+    def initialize
+      @module_frameworks = {}
+    end
+
+    # 单例方法
+    @@instance = XcodeprojManager.new
+
+    # 获取单例
+    def self.share_manager
+      @@instance
+    end
+
+    private_class_method :new
+
+    # 壳工程xcodeproj文件名(取目录下第一个匹配项)
+    # @return [String, nil]
+    def get_shell_project_file
+      xcodeproj_file = nil
+      Dir.foreach(Dir.pwd) do |file|
+        if file.end_with?(".xcodeproj")
+          xcodeproj_file = file
+          break
+        end
+      end
+      xcodeproj_file
+    end
+
+    # 获取壳工程的project对象
+    def get_shell_project
+
+      xcodeproj_file = get_shell_project_file
+      return nil unless xcodeproj_file
+
+      xcodeproj_path = "#{Dir.pwd}/#{xcodeproj_file}"
+
+      Xcodeproj::Project.open(xcodeproj_path)
+
+    end
+
+    #获取主APP target列表 包含扩展
+    def get_shell_targets
+      results = []
+      project = self.get_shell_project
+      targets = project.root_object.targets
+      targets.each do |target|
+        results << target.name
+      end
+      results
+    end
+
+    #获取主工程全部顶层target(含App与扩展，是否可通过yaml集成由调用方按product_type过滤)
+    def get_app_targets
+      project = self.get_shell_project
+      project.root_object.targets
+    end
+
+    # 获取Pods下project对象
+    def get_pods_project
+
+      xcodeproj_path = "#{Dir.pwd}/Pods/Pods.xcodeproj"
+      unless File.exist?(xcodeproj_path)
+        return nil
+      end
+
+      Xcodeproj::Project.open(xcodeproj_path)
+
+    end
+
+    end
+end

data/lib/core/command/trim_mode.rb

@@ -0,0 +1,53 @@
+require 'cocoapods'
+require_relative '../variable'
+
+module Pod
+  class Command
+    # 以 prepend 模块补丁的方式给官方 pod install / pod update 追加 --trim/--full 单次模式选项。
+    # 不 reopen 重写官方方法：类方法 options 与 initialize/run 均通过 super 走 CocoaPods 原始实现，
+    # 上游新增选项/参数校验时自动保留，不会随版本升级丢失。
+    # pod update 内部同样通过 Pod::Installer#install! 执行，下载流程补丁对其同样生效，
+    # 因此两个命令共享同一份开关解析。
+    module TrimModePatch
+      TRIM_OPTIONS = [
+        ['--trim', '单次开启未使用依赖裁剪(仅本次执行生效，优先于 LocalDependencies.yaml 的 TRIM_UNUSED_POD)'],
+        ['--full', '单次关闭未使用依赖裁剪，安装全部依赖(仅本次执行生效)']
+      ].freeze
+
+      module ClassMethods
+        def options
+          super.concat(TrimModePatch::TRIM_OPTIONS)
+        end
+      end
+
+      def self.prepended(base)
+        base.singleton_class.prepend(ClassMethods)
+      end
+
+      def initialize(argv)
+        @yaml_trim_mode = argv.flag?('trim')
+        @yaml_full_mode = argv.flag?('full')
+        # 此时 Podfile 尚未解析(在 run 阶段才读取)，提前写入全局变量可供 yaml_dependencies! 使用
+        $trim_unused_pod = @yaml_trim_mode ? true : (@yaml_full_mode ? false : nil)
+        super
+      end
+
+      def run
+        # 参数互斥校验放在 run 而非 initialize：parse 实例化阶段抛出的异常
+        # 在 CLAide 中 command 尚为 nil，即使是 Informative 也会带堆栈输出
+        if @yaml_trim_mode && @yaml_full_mode
+          raise Pod::Informative, '--trim 与 --full 互斥，请只指定其中一个选项'
+        end
+        super
+      end
+    end
+
+    class Install < Command
+      prepend TrimModePatch
+    end
+
+    class Update < Command
+      prepend TrimModePatch
+    end
+  end
+end

data/lib/core/command/yaml_init.rb

@@ -0,0 +1,28 @@
+require 'cocoapods'
+require_relative '../setup/podfile_setup'
+
+module Pod
+  class Command
+    class Yaml < Command
+      self.abstract_command = true
+      self.summary = 'yaml依赖配置相关命令'
+
+      class Init < Yaml
+
+        self.summary = '生成接入cocoapods-yaml的模板Podfile'
+
+        self.description = <<-DESC
+          在iOS工程根目录执行 pod yaml init:
+            * 有.xcodeproj且无Podfile: 直接生成模板Podfile及依赖yaml
+            * 已有Podfile但未接入yaml_dependencies!: 先备份为 Podfile.bak.时间戳 再生成模板
+            * 已接入: 不做处理
+        DESC
+
+        def run
+          CocoaPods::Yaml::PodfileSetup.run
+        end
+
+      end
+    end
+  end
+end

data/lib/core/command/yaml_relation.rb

@@ -0,0 +1,43 @@
+require_relative '../dep/find'
+require_relative '../../version'
+module Pod
+  class Command
+    class Yaml < Command
+      class Relation < Yaml
+
+        self.summary = '从Podfile.lock检索组件的正向/反向依赖关系'
+
+        self.description = '默认输出反向依赖(谁依赖了该组件)；加--forward输出正向依赖。' \
+                           '不传组件名时输出全部组件，可配合--sort按依赖数量排序。'
+
+        self.arguments = [
+          CLAide::Argument.new('组件名(可选，不传则输出全部)', false)
+        ]
+
+        def self.options
+          [
+            %w[--sort 输出依赖时按数量从小到大排序],
+            %w[--forward 输出正向依赖],
+          ].concat(super).reject { |(name, _)| (name == '--no-ansi' or name == '--silent' or name == '--allow-root' or name == '--verbose') }
+        end
+
+        def initialize(argv)
+          @name = argv.shift_argument
+          super
+          CocoaPods::Yaml.log.info("插件版本号: #{CocoaPods::Yaml::VERSION}")
+          @sort_count = argv.flag?('sort', false)
+          @forward = argv.flag?('forward', false)
+        end
+
+        def run
+          verify_lockfile_exists!
+          finder = Pod::DepFinder.new
+          finder.find_name = @name
+          finder.sort_count = @sort_count
+          finder.forward = @forward
+          finder.find
+        end
+      end
+    end
+  end
+end

data/lib/core/dep/find.rb

@@ -0,0 +1,164 @@
+require 'yaml'
+require 'colored2'
+
+module Pod
+  class DepFinder
+
+    # @param [Hash] podfileLock内容
+    attr_accessor :lockfile_content
+
+    # @param [String] 要查询的组件名
+    attr_accessor :find_name
+
+    # @param [bool] 是否按数量从小到大排序
+    attr_accessor :sort_count
+
+    # @param [bool] 是否打印正向依赖
+    attr_accessor :forward
+
+    def initialize
+      super
+      init_lock
+    end
+
+    def init_lock
+      # 读取名为Podfile.lock的yaml文件, 并通过分析里面的PODS数组，输出依赖的第三方库的名字
+      unless File.exist?("Podfile.lock")
+        CocoaPods::Yaml.log.error("Podfile.lock文件不存在，请先执行pod install或pod update")
+        exit!
+      end
+
+      @sort_count = false
+
+      @lockfile_content = YAML.load_file('Podfile.lock')
+
+    end
+
+    # @api 反向依赖查询
+    def find
+
+      if @find_name
+        find_single_dep
+      else
+        find_all_dep
+      end
+
+      print_usage_hint
+    end
+
+    # 按当前场景只提示真正可用的后续操作
+    def print_usage_hint
+      hints = []
+      if @find_name
+        hints << '去掉 --forward 可同时看反向依赖' if @forward
+      else
+        hints << '查询单个组件: pod yaml relation <组件名>'
+        hints << '加 --forward 看正向依赖' unless @forward
+        hints << '加 --sort 按依赖数量从少到多排序' unless @sort_count
+      end
+      return if hints.empty?
+      CocoaPods::Yaml.log.info('')
+      CocoaPods::Yaml.log.detail(hints.join('；'))
+    end
+
+    def find_all_dep
+
+      result_map = Hash.new
+      # 循环遍历lockfile对象中的PODS数组
+      @lockfile_content['PODS'].each do |pod|
+        # 拿到所有的组件名
+        key = pod.is_a?(Hash) ? pod.keys[0] : pod
+        key = key.split(" (")[0]
+
+        if @forward
+          result_map[key] = pod.is_a?(Hash) ? pod.values[0] : Array.new
+        else
+          result_map[key] = find_reverse_with_name(key)
+        end
+      end
+
+      msg = @forward ? "正向依赖(各组件依赖了谁)" : "反向依赖(谁依赖了各组件)"
+      CocoaPods::Yaml.log.step(msg)
+
+      sorted_hash = result_map
+      if @sort_count
+        sorted_hash = Hash[result_map.sort_by { |key, value| value.length }]
+      end
+
+      sorted_hash.each do |key, array|
+        title = @forward ? "#{key} 依赖的组件(#{array.length}个)" : "依赖#{key}的组件(#{array.length}个)"
+        CocoaPods::Yaml.log.info(title, :green)
+        array.each { |obj| CocoaPods::Yaml.log.info("  #{obj}") }
+        CocoaPods::Yaml.log.info('')
+      end
+    end
+
+    def find_single_dep
+
+      CocoaPods::Yaml.log.step("#{@find_name} 依赖关系")
+
+      # 默认正反向都展示；--forward时只看正向
+      unless @forward
+        results = find_reverse_with_name(@find_name)
+        CocoaPods::Yaml.log.info("反向依赖 · 谁依赖了#{@find_name}(#{results.length}个):", :green)
+        results.each { |res| CocoaPods::Yaml.log.info("  #{res}") }
+        CocoaPods::Yaml.log.info('')
+      end
+
+      # 正向依赖查询结果
+      forward_results = find_forward_with_name(@find_name)
+      CocoaPods::Yaml.log.info("正向依赖 · #{@find_name}依赖了谁(#{forward_results.length}个):", :green)
+      forward_results.each { |res| CocoaPods::Yaml.log.info("  #{res}") }
+
+    end
+
+    def find_forward_with_name(name)
+      if not @lockfile_content or not @lockfile_content['PODS']
+        return []
+      end
+
+      results = Array.new
+      @lockfile_content['PODS'].each do |pod|
+        # 拿到所有的组件名
+        key = pod.is_a?(Hash) ? pod.keys[0] : pod
+        key = key.split(" (")[0]
+        if key == name and pod.is_a?(Hash)
+          pod.each_value do |value|
+            # value是依赖数组，需展平为逐条依赖，不能把整个数组当一个元素
+            results.concat(Array(value))
+          end
+        end
+      end
+      results
+    end
+
+    def find_reverse_with_name(name)
+      if not @lockfile_content or not @lockfile_content['PODS']
+        return []
+      end
+
+      results = Array.new
+      # 循环遍历lockfile对象中的PODS数组
+      @lockfile_content['PODS'].each do |pod|
+        if pod.is_a?(Hash)
+          pod.values.each do |value|
+            # 如果value是一个数组，则判断数组中是否包含name
+            if value.is_a?(Array)
+              value.each { |sub_value|
+                # 这里的处理包含了子模块的情况
+                sub_module = sub_value.split(" (")[0]
+                if  sub_module == name
+                  results << pod.keys.first
+                end
+              }
+            end
+          end
+        end
+      end
+
+      # 去重
+      results.uniq
+    end
+  end
+end
+

data/lib/core/indirect/indirect.rb

@@ -0,0 +1,72 @@
+require_relative '../podfilelock'
+
+module PodfileLock
+  class Indirect
+    def log_indirect
+
+      # 内容读取
+      dependencies_lock = PodfileLock::PodfileLockManager.podfile_lock_content
+
+      dependencies = dependencies_lock['DEPENDENCIES']
+      unless dependencies
+        return
+      end
+
+      check_sums = dependencies_lock['SPEC CHECKSUMS']
+      unless check_sums
+        return
+      end
+
+      # 直接依赖名归一化(去掉版本要求和subspec)。
+      # 注意: 必须用非破坏式的map，不能对lock原始数组使用collect!，否则会改写内存中的lock数据
+      direct_dependencies = dependencies.map do |item|
+        item.split(' (')[0].split('/')[0]
+      end
+
+      # 从PODS依赖树构建"组件 -> 引用方"索引，用于输出来源
+      referrers = build_referrers(dependencies_lock['PODS'])
+
+      log = CocoaPods::Yaml.log
+      check_sums.each_key do |pod_name|
+        next if direct_dependencies.include?(pod_name)
+
+        parents = referrers[pod_name] || []
+        if parents.empty?
+          log.detail("间接依赖: #{pod_name}")
+        else
+          log.detail("间接依赖: #{pod_name}(由 #{parents.join('、')} 引入)")
+        end
+      end
+    end
+
+    private
+
+    # 从Podfile.lock的PODS段解析引用关系
+    # @param pods [Array<String, Hash>] PODS段内容
+    # @return [Hash{String => Array<String>}] 组件名 -> 直接引用它的组件名(已去重)
+    def build_referrers(pods)
+      result = Hash.new { |hash, key| hash[key] = [] }
+      return result unless pods.is_a?(Array)
+
+      pods.each do |entry|
+        # PODS段中无下级依赖的组件是纯字符串，带依赖的是Hash
+        next unless entry.is_a?(Hash)
+
+        entry.each do |spec, child_dependencies|
+          parent = normalize_pod_name(spec)
+          Array(child_dependencies).each do |child|
+            child_name = normalize_pod_name(child)
+            result[child_name] << parent unless result[child_name].include?(parent)
+          end
+        end
+      end
+      result
+    end
+
+    # 归一化pod名: 去掉版本要求与subspec路径
+    # 例: "BSDebugPlugins/Cookie (= 1.2.0-SNAPSHOT)" -> "BSDebugPlugins"
+    def normalize_pod_name(name)
+      name.to_s.split(' (')[0].split('/')[0]
+    end
+  end
+end