cocoapods-source-fix 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '08cd70f594d0ebf1ec6b40982fee5ec16e2caf54faf9335ffb953dcd54df929b'
+  data.tar.gz: 30347776d6e39f8575937f225754da7b7d7a37de3f86831738ecd1e9500d07bf
+SHA512:
+  metadata.gz: 7917a8bec1021d0721de8a7ef524951054493496dbd5480b2b39006c1c0298e342945898404ae8d42f91dea94fa81f16f4d7b73457635e93895cbe93d6f147d9
+  data.tar.gz: 6ea0f0d4652d8c6224db28d2ff36fe9d7a54f3245fc00dc99ad849e22ffcfa68760cfd1b120f70f0dd44e43626afb38aa47cd2bd1ef47d8d87ac0d642a4c432f

data/README.md

@@ -0,0 +1,162 @@
+# cocoapods-source-fix
+
+CocoaPods 插件：在 `pod install` 后自动对指定 Pod 的源码/头文件做**文本替换**，用于修复第三方库的编译问题（表达式修复、私有头引入修复、任意文本替换等）。
+
+> 原名 `cocoapods-header-fix` 已废弃——插件能力不止「头文件修复」（如 YYText 是表达式修复），故更名为 `cocoapods-source-fix`（源码文本替换修复）。
+
+## 特点
+
+- **Podfile 零改动**：通过 monkey-patch `Pod::Installer#install!`（与 `cocoapods-local-override` 相同机制，绕过 HooksManager 白名单），gem 以 `cocoapods-*` 前缀安装后由 CocoaPods 自动加载即生效，**无需在 Podfile 写 `plugin` 指令**
+- **配置独立**：所有替换规则写在一个独立 YAML 文件中（默认 `Podfile 同目录/cocoapods-source-fix.yml`）
+- **6 种目标定位**：相对目录 / 绝对目录 / 相对文件 / 绝对文件 / Pod 模块 / 全局
+- **幂等**：重复执行 `pod install` 不重复破坏文件（内容无变化则跳过写文件）
+- **安全**：写文件前 `chmod 0644`；文件不存在 / glob 无匹配静默跳过
+
+## 安装与集成
+
+### 方式一：Gemfile（推荐，项目用 `bundle exec pod install` 时）
+
+在项目的 Gemfile 中加：
+
+```ruby
+gem 'cocoapods-source-fix', :path => '/Volumes/macc/ZCZY56/Dispatch-dymic/Dispatch-workspace/cocoapods-source-fix'
+```
+
+然后 `bundle install && bundle exec pod install`。
+
+### 方式二：gem 全局安装（项目直接用 `pod install` 时）
+
+```bash
+cd /Volumes/macc/ZCZY56/Dispatch-dymic/Dispatch-workspace/cocoapods-source-fix
+gem build cocoapods-source-fix.gemspec
+gem install cocoapods-source-fix-0.1.0.gem
+```
+
+之后 `pod install` 自动生效。
+
+## 配置
+
+创建 `cocoapods-source-fix.yml` 放在 **Podfile 同目录**（或通过环境变量 `COCOAPODS_SOURCE_FIX_CONFIG` 指定路径）：
+
+```yaml
+rules:
+  # Pod 模块：glob 相对该 Pod 目录
+  - name: YYText 表达式修复
+    pod: YYText
+    glob: 'YYText/Component/YYTextLayout.m'
+    pairs:
+      - from: 'fabs(left - point.y) < fabs(right - point.y) < (right ? prev : next)'
+        to:   '(fabs(left - point.y) < fabs(right - point.y)) == (right ? prev : next)'
+      - from: 'fabs(left - point.x) < fabs(right - point.x) < (right ? prev : next)'
+        to:   '(fabs(left - point.x) < fabs(right - point.x)) == (right ? prev : next)'
+
+  # 相对 Podfile 的目录
+  - dir: 'Pods/SomePod'
+    glob: '**/*.{h,m}'
+    from: 'OLD_TEXT'
+    to: 'NEW_TEXT'
+
+  # 绝对路径目录
+  - dir: '/Users/xxx/Source/Pods/SomePod'
+    glob: '**/*.m'
+    from: 'OLD_TEXT'
+    to: 'NEW_TEXT'
+
+  # 相对 Podfile 的文件
+  - file: 'Pods/SomePod/SomePod/Foo.m'
+    from: 'OLD_TEXT'
+    to: 'NEW_TEXT'
+
+  # 绝对文件
+  - file: '/Users/xxx/Source/Pods/SomePod/SomePod/Foo.m'
+    from: 'OLD_TEXT'
+    to: 'NEW_TEXT'
+
+  # 不指定目标：全局替换（glob 相对 Podfile 目录）
+  - glob: 'Pods/**/*.{h,m}'
+    from: 'OLD_TEXT'
+    to: 'NEW_TEXT'
+```
+
+完整可运行示例见 [config.example.yml](config.example.yml)。
+
+### 规则字段
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `name` | 否 | 日志标签，便于识别规则 |
+| `pod` / `dir` / `file` | 六选一 | 目标定位；均不指定则为全局（glob 相对 Podfile 目录） |
+| `glob` | 目录/全局必填 | 文件匹配模式；Pod 模块下相对 Pod 目录，目录/全局下相对目标目录 |
+| `exclude` | 否 | 排除文件/目录，字符串或数组，glob 模式，基准与 `glob` 相同；`'xx/**'` 或 `'**'` 表示排除整棵目录树 |
+| `from` / `to` | 至少一组 | 单组字面量替换（`regex: true` 时按正则） |
+| `pairs` | 否 | 多组替换 `[{from, to, regex?}]` |
+| `regex` | 否 | 默认 `false`（字面量替换，自动转义正则元字符）；`true` 时按正则替换 |
+| `enabled` | 否 | 默认 `true`，可临时关闭某条规则 |
+
+`exclude` 使用示例：
+
+```yaml
+- name: LFPhoneInfo 头引入方式修复
+  pod: LFPhoneInfo
+  glob: '**/*.{h,m,mm,swift}'
+  from: '#import <LFPhoneDefine.h>'
+  to:   '#import "LFPhoneDefine.h"'
+  exclude:
+    - 'LFPhoneInfo/LFPhoneInfo.h'   # 排除单个文件
+    - 'LFPhoneInfo/Private/**'      # 排除整棵目录树
+```
+
+## 日志输出
+
+日志统一走 `Pod::UI.puts`，格式参照 `cocoapods-user-defined-build-types` 插件（`🛠️ [cocoapods-source-fix] ...` 蓝色）。**不修复也会输出日志**，并区分原因：
+
+```
+🛠️ [cocoapods-source-fix] 使用配置文件：/path/to/cocoapods-source-fix.yml（3 条规则）
+🛠️ [cocoapods-source-fix] patching source files...
+🛠️ [cocoapods-source-fix]   processing rule: YYText 表达式修复
+🛠️ [cocoapods-source-fix]     ✅ 已修复文件：/path/to/Pods/YYText/YYText/Component/YYTextLayout.m
+🛠️ [cocoapods-source-fix]   processing rule: AFNetworking 私有头修复
+🛠️ [cocoapods-source-fix]     ⏭️ 跳过（2 个文件内容已是最新，无需修复）
+🛠️ [cocoapods-source-fix]   processing rule: 某条无匹配的规则
+🛠️ [cocoapods-source-fix]     ⏭️ 跳过（无匹配文件）
+🛠️ [cocoapods-source-fix] finished patching source files (1 fixed, 2 skipped)
+```
+
+各场景日志：
+
+| 场景 | 日志 |
+|------|------|
+| 修复了文件 | `✅ 已修复文件：<path>` |
+| 匹配到文件但内容已是最新（幂等） | `⏭️ 跳过（N 个文件内容已是最新，无需修复）` |
+| 无文件匹配 glob | `⏭️ 跳过（无匹配文件）` |
+| 读取失败 | `⚠️ 读取失败：<path>` |
+| 结束汇总 | `finished patching source files (N fixed, M skipped)` |
+
+### 详细日志（verbose）
+
+默认只输出规则级汇总；配置 `verbose: true`（或环境变量 `COCOAPODS_SOURCE_FIX_VERBOSE=1`）后逐文件输出：
+
+```
+🛠️ [cocoapods-source-fix]     ⏭️ 已是最新：/path/to/Pods/YYText/YYText/Component/YYTextLayout.m
+🛠️ [cocoapods-source-fix]     🚫 已排除：/path/to/Pods/LFPhoneInfo/LFPhoneInfo/Private/Secret.h
+```
+
+- 每个实际发生替换的文件：`✅ 已修复文件：<path>`
+- 无匹配的规则：`⏭️ 跳过（无匹配）`
+- 配置文件不存在时提示跳过，不中断安装
+
+## 文档导航
+
+| 文件 | 说明 |
+|---|---|
+| `REQUIREMENTS.md` | 需求梳理（背景 / 方案 / 验收标准） |
+| `lib/` | 插件实现 |
+| `config.example.yml` | 配置示例（覆盖 6 种目标定位） |
+| `cocoapods-source-fix.gemspec` | gem 定义 |
+
+## 验证
+
+```bash
+pod install            # 首次：看到 ✅ 已修复文件
+pod install            # 再次：看到 ⏭️ 跳过（幂等验证）
+```

data/config.example.yml

@@ -0,0 +1,86 @@
+# ============================================================
+# cocoapods-source-fix 配置文件示例
+#
+# 默认位置：Podfile 同目录下的 cocoapods-source-fix.yml
+# 也可用环境变量指定：COCOAPODS_SOURCE_FIX_CONFIG=/path/to/config.yml pod install
+#
+# 目标定位（每条规则六选一，均不指定则为全局替换）：
+#   pod:  '模块名'            → 定位 Pod 目录（installer.sandbox.pod_dir），glob 相对该目录
+#   dir:  '路径'              → 目录；绝对路径直接用，相对路径以 Podfile 目录为基准
+#   file: '路径'              → 文件；绝对路径直接用，相对路径以 Podfile 目录为基准
+#   （无以上字段）            → 全局；glob 以 Podfile 目录为基准（如 'Pods/**/*.{h,m}'）
+#
+# 替换内容（from/to 与 pairs 至少提供一组；均可选 regex: true 走正则）：
+#   from/to  单组字面量替换
+#   pairs    多组替换 [{from, to, regex?}]
+#
+# 排除（可选）：exclude 支持字符串或数组，glob 模式，基准与 glob 相同
+#   （pod → Pod 目录；dir → 目标目录；全局 → Podfile 目录），命中文件不修复。
+#   以 '/**' 结尾（或 '**'）表示排除整个目录树。
+#
+# 详细日志（可选）：verbose: true 时逐文件输出「已是最新」「已排除」，
+#   默认 false（只输出规则级汇总）。也可用环境变量 COCOAPODS_SOURCE_FIX_VERBOSE=1 覆盖。
+#
+# 其他字段：name（日志标签，可选）、glob（文件匹配，目录/全局必填）、enabled（默认 true）
+# ============================================================
+
+rules:
+  # ---------- 示例 1：指定 Pod 模块 + 单文件多组替换（迁移自 YYText 表达式修复） ----------
+  - name: YYText 表达式修复
+    pod: YYText
+    glob: 'YYText/Component/YYTextLayout.m'
+    pairs:
+      - from: 'fabs(left - point.y) < fabs(right - point.y) < (right ? prev : next)'
+        to:   '(fabs(left - point.y) < fabs(right - point.y)) == (right ? prev : next)'
+      - from: 'fabs(left - point.x) < fabs(right - point.x) < (right ? prev : next)'
+        to:   '(fabs(left - point.x) < fabs(right - point.x)) == (right ? prev : next)'
+
+  # ---------- 示例 2：指定 Pod 模块 + 多文件 glob（迁移自 AFNetworking 私有头修复） ----------
+  - name: AFNetworking 私有头修复
+    pod: AFNetworking
+    glob: 'AFNetworking/AF{NetworkReachabilityManager,HTTPSessionManager}.m'
+    from: '#import <netinet6/in6.h>'
+    to:   '#include <sys/socket.h>'
+
+  # ---------- 示例 3：指定 Pod 模块 + 目录遍历（迁移自 LFPhoneInfo 头引入修复） ----------
+  - name: LFPhoneInfo 头引入方式修复
+    pod: LFPhoneInfo
+    glob: '**/*.{h,m,mm,swift}'
+    from: '#import <LFPhoneDefine.h>'
+    to:   '#import "LFPhoneDefine.h"'
+    # 排除示例：不修复 LFPhoneInfo.h 自身（exclude 也可传数组）
+    # exclude: 'LFPhoneInfo/LFPhoneInfo.h'
+    # 排除整棵目录树：
+    # exclude: 'LFPhoneInfo/Private/**'
+
+  # ---------- 示例 4：相对 Podfile 文件的目录 ----------
+  # - name: 相对目录示例
+  #   dir: 'Pods/SomePod'
+  #   glob: '**/*.{h,m}'
+  #   from: 'OLD_TEXT'
+  #   to: 'NEW_TEXT'
+
+  # ---------- 示例 5：绝对路径目录 ----------
+  # - name: 绝对目录示例
+  #   dir: '/Users/xxx/Source/Pods/SomePod'
+  #   glob: '**/*.m'
+  #   from: 'OLD_TEXT'
+  #   to: 'NEW_TEXT'
+
+  # ---------- 示例 6：相对 Podfile 文件的文件 ----------
+  # - name: 相对文件示例
+  #   file: 'Pods/SomePod/SomePod/Foo.m'
+  #   from: 'OLD_TEXT'
+  #   to: 'NEW_TEXT'
+
+  # ---------- 示例 7：绝对文件 ----------
+  # - name: 绝对文件示例
+  #   file: '/Users/xxx/Source/Pods/SomePod/SomePod/Foo.m'
+  #   from: 'OLD_TEXT'
+  #   to: 'NEW_TEXT'
+
+  # ---------- 示例 8：不指定目标（全局替换，glob 相对 Podfile 目录） ----------
+  # - name: 全局替换示例
+  #   glob: 'Pods/**/*.{h,m}'
+  #   from: 'OLD_TEXT'
+  #   to: 'NEW_TEXT'

data/lib/cocoapods-source-fix/configuration.rb

@@ -0,0 +1,39 @@
+require 'yaml'
+require 'cocoapods-source-fix/rule'
+
+module CocoapodsSourceFix
+  # 读取独立配置文件（默认 <Podfile 目录>/cocoapods-source-fix.yml）
+  class Configuration
+    CONFIG_FILE_NAME = 'cocoapods-source-fix.yml'
+    ENV_KEY = 'COCOAPODS_SOURCE_FIX_CONFIG'
+    ENV_VERBOSE_KEY = 'COCOAPODS_SOURCE_FIX_VERBOSE'
+
+    attr_reader :path, :rules, :verbose
+
+    # 定位配置文件：环境变量优先，其次 Podfile 同目录默认文件名
+    def self.locate(podfile_dir)
+      env_path = ENV[ENV_KEY]
+      return Pathname.new(env_path) if env_path && File.file?(env_path)
+
+      default = File.join(podfile_dir, CONFIG_FILE_NAME)
+      File.file?(default) ? Pathname.new(default) : nil
+    end
+
+    def initialize(path, podfile_dir:)
+      @path = path
+      @data = YAML.load_file(path) || {}
+      @rules = Array(@data['rules']).map { |raw| Rule.new(raw, base_dir: podfile_dir) }
+      @verbose = parse_verbose
+    end
+
+    private
+
+    # verbose 优先级：环境变量 > 配置文件 > 默认 false
+    def parse_verbose
+      env = ENV[ENV_VERBOSE_KEY]
+      return %w[1 true yes on].include?(env.downcase) if env && !env.empty?
+
+      @data['verbose'] == true
+    end
+  end
+end

data/lib/cocoapods-source-fix/logger.rb

@@ -0,0 +1,20 @@
+module CocoapodsSourceFix
+  PLUGIN_NAME = 'cocoapods-source-fix'
+
+  # 统一日志出口，参照 cocoapods-user-defined-build-types 风格：
+  #   Pod::UI.puts "🛠️ [cocoapods-user-defined-build-types] patching build types...".blue
+  module Logger
+    def self.info(msg)
+      line = "🛠️ [#{PLUGIN_NAME}] #{msg}"
+      if defined?(Pod) && defined?(Pod::UI)
+        begin
+          Pod::UI.puts line.blue
+        rescue StandardError
+          Pod::UI.puts line
+        end
+      else
+        Kernel.puts line
+      end
+    end
+  end
+end

data/lib/cocoapods-source-fix/rule.rb

@@ -0,0 +1,72 @@
+require 'pathname'
+
+module CocoapodsSourceFix
+  # 单条替换规则
+  #
+  # 目标定位（互斥，均不指定则为全局）：
+  #   pod:   'YYText'          → 定位到 installer.sandbox.pod_dir('YYText')，glob 相对该 Pod 目录
+  #   dir:   'path'            → 目录，路径绝对则直接使用，相对则相对 Podfile 目录
+  #   file:  'path'            → 文件，路径绝对则直接使用，相对则相对 Podfile 目录
+  #   （无以上字段）           → 全局，glob 相对 Podfile 目录（如 'Pods/**/*.{h,m}'）
+  #
+  # 替换内容（至少一组）：
+  #   from/to 单组字面量替换；pairs 多组替换；均可选 regex: true 启用正则
+  #
+  # 排除（可选）：
+  #   exclude: '模式' 或 ['模式1', '模式2']，glob 模式，基准与 glob 相同
+  #   （pod → Pod 目录；dir → 目标目录；全局 → Podfile 目录），命中文件不修复
+  class Rule
+    attr_reader :name, :target_type, :target, :glob, :replaces, :enabled, :excludes
+
+    def initialize(raw, base_dir:)
+      @raw = raw || {}
+      @base_dir = base_dir
+      @name = @raw['name']
+      @glob = @raw['glob']
+      @enabled = @raw.fetch('enabled', true)
+      @excludes = Array(@raw['exclude']).compact.map(&:to_s)
+      @replaces = parse_replaces
+      resolve_target
+    end
+
+    def enabled?
+      @enabled
+    end
+
+    def label
+      @name || "target=#{@target_type}#{@target ? "(#{@target})" : ''}"
+    end
+
+    private
+
+    def parse_replaces
+      list = []
+      if @raw['from'] && @raw['to']
+        list << build_replace(@raw['from'], @raw['to'], @raw.fetch('regex', false))
+      end
+      Array(@raw['pairs']).each do |pair|
+        list << build_replace(pair['from'], pair['to'], pair.fetch('regex', false))
+      end
+      list
+    end
+
+    def build_replace(from, to, regex)
+      { from: from, to: to, regex: regex }
+    end
+
+    def resolve_target
+      if @raw['pod']
+        @target_type = :pod
+        @target = @raw['pod']
+      elsif @raw['dir']
+        @target_type = :dir
+        @target = @raw['dir']
+      elsif @raw['file']
+        @target_type = :file
+        @target = @raw['file']
+      else
+        @target_type = :global
+      end
+    end
+  end
+end

data/lib/cocoapods-source-fix/runner.rb

@@ -0,0 +1,150 @@
+require 'fileutils'
+require 'cocoapods-source-fix/logger'
+
+module CocoapodsSourceFix
+  # 执行替换：收集目标文件 → 逐文件替换 → 幂等写回 → 日志输出
+  class Runner
+    def initialize(context, config, podfile_dir: nil)
+      @context = context
+      @config = config
+      @podfile_dir = podfile_dir || default_podfile_dir
+    end
+
+    def run
+      Logger.info "patching source files..."
+      fixed_total = 0
+      skipped_total = 0
+      @config.rules.each do |rule|
+        next unless rule.enabled?
+
+        files = collect_files(rule)
+        fixed, skipped = process_rule(rule, files)
+        fixed_total += fixed
+        skipped_total += skipped
+      end
+      Logger.info "finished patching source files (#{fixed_total} fixed, #{skipped_total} skipped)"
+    end
+
+    private
+
+    # 按目标类型收集待处理文件（含 exclude 过滤）
+    def collect_files(rule)
+      base_dir, files = files_for_target(rule)
+      apply_excludes(files, rule, base_dir)
+    end
+
+    def files_for_target(rule)
+      case rule.target_type
+      when :pod
+        dir = @context.sandbox.pod_dir(rule.target).to_s
+        [dir, glob_files(dir, rule.glob || '**/*')]
+      when :dir
+        dir = resolve_path(rule.target)
+        [dir, glob_files(dir, rule.glob || '**/*')]
+      when :file
+        path = resolve_path(rule.target)
+        [File.dirname(path), File.file?(path) ? [path] : []]
+      when :global
+        [@podfile_dir, glob_files(@podfile_dir, rule.glob || '**/*')]
+      end
+    end
+
+    # exclude 为 glob 模式，基准与 glob 相同（相对规则目标目录）。
+    # 注意：模式以 /** 结尾时 fnmatch 只匹配一层，追加 /**/* 变体覆盖整棵目录树。
+    def apply_excludes(files, rule, base_dir)
+      return files if rule.excludes.empty?
+
+      patterns = rule.excludes.flat_map do |pattern|
+        if pattern == '**' || pattern.end_with?('/**')
+          [pattern, File.join(pattern, '*')]
+        else
+          [pattern]
+        end
+      end
+      flags = File::FNM_PATHNAME | File::FNM_EXTGLOB
+
+      files.reject do |file|
+        rel = file.delete_prefix(base_dir + '/')
+        hit = patterns.any? { |p| File.fnmatch(p, rel, flags) }
+        Logger.info "    🚫 已排除：#{file}" if hit && @config.verbose
+        hit
+      end
+    end
+
+    # 兜底：优先全局 Pod::Config 中的 Podfile，其次 sandbox_root 上级，最后 Dir.pwd
+    def default_podfile_dir
+      if defined?(Pod::Config) && Pod::Config.instance.respond_to?(:podfile)
+        pf = Pod::Config.instance.podfile
+        if pf && pf.respond_to?(:defined_in_file) && pf.defined_in_file
+          return File.dirname(pf.defined_in_file.to_s)
+        end
+      end
+      if @context.respond_to?(:sandbox_root) && @context.sandbox_root
+        return File.dirname(@context.sandbox_root)
+      end
+      Dir.pwd
+    end
+
+    def glob_files(dir, glob)
+      return [] unless File.directory?(dir)
+
+      Dir.glob(File.join(dir, glob)).select { |f| File.file?(f) }
+    end
+
+    # 绝对路径直接使用；相对路径以 Podfile 目录为基准
+    def resolve_path(path)
+      p = Pathname.new(path)
+      p.absolute? ? path : File.expand_path(path, @podfile_dir)
+    end
+
+    # 返回 [fixed, skipped]：fixed 为实际写入的文件数，skipped 为内容已是最新（无变化）的文件数
+    def process_rule(rule, files)
+      Logger.info "  processing rule: #{rule.label}"
+      if files.empty?
+        Logger.info "    ⏭️ 跳过（无匹配文件）"
+        return [0, 0]
+      end
+
+      touched = 0
+      skipped = 0
+      files.each do |file|
+        begin
+          content = File.read(file)
+        rescue StandardError => e
+          Logger.info "    ⚠️ 读取失败：#{file}（#{e.message}）"
+          next
+        end
+
+        new_content = rule.replaces.reduce(content) { |acc, rep| apply_replace(acc, rep) }
+        if new_content == content # 幂等：无变化跳过写文件
+          skipped += 1
+          Logger.info "    ⏭️ 已是最新：#{file}" if @config.verbose
+          next
+        end
+
+        FileUtils.chmod 0644, file
+        File.write(file, new_content)
+        Logger.info "    ✅ 已修复文件：#{file}"
+        touched += 1
+      end
+      if touched.zero?
+        Logger.info "    ⏭️ 跳过（#{skipped} 个文件内容已是最新，无需修复）"
+      elsif skipped.positive?
+        Logger.info "    ✅ 修复完成（#{touched} 个文件；#{skipped} 个已是最新）"
+      end
+      [touched, skipped]
+    end
+
+    def apply_replace(content, rep)
+      # 必须显式构造 Regexp：Ruby 3.x 下 gsub(字符串) 不会把字符串当正则源码解析
+      pattern = if rep[:regex]
+                  Regexp.new(rep[:from])
+                else
+                  # 默认字面量替换，避免被当作正则元字符
+                  Regexp.new(Regexp.escape(rep[:from]))
+                end
+      # block 形式传 replacement，避免 \1 等被解释为捕获组引用
+      content.gsub(pattern) { rep[:to] }
+    end
+  end
+end

data/lib/cocoapods-source-fix/version.rb

@@ -0,0 +1,3 @@
+module CocoapodsSourceFix
+  VERSION = '0.1.0'
+end

data/lib/cocoapods-source-fix.rb

@@ -0,0 +1,70 @@
+require 'ostruct'
+require 'cocoapods-source-fix/version'
+require 'cocoapods-source-fix/logger'
+require 'cocoapods-source-fix/configuration'
+require 'cocoapods-source-fix/runner'
+
+module CocoapodsSourceFix
+  class << self
+    # install! 完成后执行源码替换（加载即生效，无需 Podfile 声明 plugin）
+    def run_post_install(installer)
+      podfile_dir = podfile_dir_from(installer)
+      config_path = Configuration.locate(podfile_dir)
+      unless config_path
+        Logger.info "未找到配置文件（#{Configuration::ENV_KEY} 或 #{Configuration::CONFIG_FILE_NAME}），跳过替换"
+        return
+      end
+
+      config = Configuration.new(config_path, podfile_dir: podfile_dir)
+      Logger.info "使用配置文件：#{config_path}（#{config.rules.size} 条规则）"
+      # Runner 依赖 sandbox 定位 pod 目录，从 installer 实例提取并包装成轻量 context
+      context = OpenStruct.new(
+        sandbox: installer.sandbox,
+        sandbox_root: installer.sandbox.root.to_s
+      )
+      Runner.new(context, config, podfile_dir: podfile_dir).run
+    end
+
+    # 安装 monkey-patch：拦截 Pod::Installer#install!，在其执行完成后运行替换。
+    # 与 cocoapods-local-override 相同的机制——绕过 HooksManager 的 whitelist
+    # （whitelist 只放行 Podfile 中 plugin 声明的 hook），因此无需修改 Podfile。
+    def apply_installer_hook!
+      return if @installer_hook_applied
+      @installer_hook_applied = true
+
+      Pod::Installer.class_eval do
+        unless method_defined?(:source_fix_original_install!)
+          alias_method :source_fix_original_install!, :install!
+
+          define_method :install! do |*args|
+            source_fix_original_install!(*args)
+            CocoapodsSourceFix.run_post_install(self)
+          end
+        end
+      end
+    end
+
+    private
+
+    def podfile_dir_from(installer)
+      # 1. 全局 Pod::Config 中已加载的 Podfile（最可靠，含 defined_in_file）
+      if defined?(Pod::Config) && Pod::Config.instance.respond_to?(:podfile)
+        pf = Pod::Config.instance.podfile
+        if pf && pf.respond_to?(:defined_in_file) && pf.defined_in_file
+          return File.dirname(pf.defined_in_file.to_s)
+        end
+      end
+      # 2. 兜底：sandbox.root（默认 <Podfile 目录>/Pods）的上级目录
+      if installer.respond_to?(:sandbox) && installer.sandbox &&
+         installer.sandbox.respond_to?(:root) && installer.sandbox.root
+        return File.dirname(installer.sandbox.root.to_s)
+      end
+      # 3. 最终兜底：当前工作目录
+      Dir.pwd
+    end
+  end
+end
+
+# 说明：CocoaPods 启动时自动 require gem 内的 lib/cocoapods_plugin.rb（无需 Podfile
+# 声明），此处直接 monkey-patch Pod::Installer#install!，加载即生效。
+CocoapodsSourceFix.apply_installer_hook!

data/lib/cocoapods_plugin.rb

@@ -0,0 +1,6 @@
+# CocoaPods 插件发现入口
+#
+# CocoaPods 启动时自动扫描所有已安装 gem 中的 `cocoapods_plugin.rb` 并 require，
+# 无需在 Podfile 中写 plugin 指令（与 cocoapods-local-override 相同机制）。
+# 加载主入口，注册 :post_install hook。
+require 'cocoapods-source-fix'

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: cocoapods-source-fix
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ZCW
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cocoapods
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: Automatically apply text replacements (expression fixes, private header
+  import fixes, etc.) to Pod sources after `pod install`, configured via a standalone
+  YAML file. No Podfile modification required.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- config.example.yml
+- lib/cocoapods-source-fix.rb
+- lib/cocoapods-source-fix/configuration.rb
+- lib/cocoapods-source-fix/logger.rb
+- lib/cocoapods-source-fix/rule.rb
+- lib/cocoapods-source-fix/runner.rb
+- lib/cocoapods-source-fix/version.rb
+- lib/cocoapods_plugin.rb
+homepage: https://github.com/charleszhao888888/cocoapods-source-fix
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.3
+signing_key:
+specification_version: 4
+summary: CocoaPods plugin to apply text replacements to pod sources after pod install
+test_files: []