Pods工程导入自己forked的三方库

如一个名为NMSSH的三方库，将 NMSSH 这样的第三方库 Fork 到自己的 GitHub，然后通过 CocoaPods 集成到本地工程，是一个常见的操作，通常用于：

1. 定制化修改：根据项目需求修改库的源代码。
2. 保证依赖稳定：避免原库被删除、变更或出现不兼容更新影响自己的项目。

下面我将为你详细拆解这个过程的每一步。

第一阶段：Fork 到自己的 GitHub

这一步的目的是在 GitHub 上创建一个属于你自己的 NMSSH 副本，你拥有对这个副本的完全控制权。

1. 找到原仓库：
   在浏览器中打开 NMSSH 的 GitHub 页面：https://github.com/NMSSH/NMSSH

2. Fork 仓库：

   • 点击页面右上角的 "Fork" 按钮。
   • GitHub 会自动为你创建一个副本，地址通常是 https://github.com/你的用户名/NMSSH。
   • 至此，你已经拥有了一个原仓库的“分身”。

3. （可选）克隆到本地：
   如果你想对代码进行修改，需要将你 Fork 后的仓库克隆到本地。

   cd /path/to/your/workspace
   git clone https://github.com/你的用户名/NMSSH.git
   

第二阶段：修改 Podspec 文件（关键步骤）

为了让 CocoaPods 能从你的 GitHub 地址正确获取依赖，你需要修改项目的 .podspec 文件。

1. 找到 Podspec 文件：
   在你克隆下来的本地 NMSSH 目录中，找到 NMSSH.podspec 文件。

2. 修改关键字段：
   用文本编辑器（如 VSCode, Sublime Text）打开这个文件。你需要修改以下几个核心字段：

   Pod::Spec.new do |s|
     s.name         = "NMSSH"
     # 版本号：如果你做了修改，最好更新一个版本号，以示区别。
     s.version      = "2.3.1" # 例如，可以改为 2.3.1.你的名字
     s.summary      = "NMSSH is a clean, easy-to-use, unit tested framework for iOS and OSX that wraps libssh2."
     s.homepage     = "https://github.com/你的用户名/NMSSH" # ！！！修改为你的 GitHub 地址
     s.license      = { :type => 'MIT' }
     s.author       = { "Christoffer Lejdborg" => ... } # 作者信息可以不变，或者加上你的信息
   
     s.source       = {
       :git => "https://github.com/你的用户名/NMSSH.git", # ！！！修改为你的 Git 地址
       :tag => s.version.to_s # 这要求你必须在 GitHub 上打一个同名的 Tag
     }
   
     # ... 其他配置通常不需要改动
     s.source_files = 'NMSSH/**/*.{h,m}'
     s.requires_arc = true
     # ...
   end
   

   最重要的修改是 s.homepage 和 s.source 中的 Git 地址。

3. 提交修改并打上 Tag：

   • 将修改后的 .podspec 文件提交并推送到你的 GitHub 仓库。

   git add NMSSH.podspec
   git commit -m "Update podspec for forked version"
   git push origin master
   

   • 为这个提交打上一个与 s.version 一致的 Tag，这是 CocoaPods 识别版本的关键。

   git tag '2.3.1' # 这里的版本号要和 podspec 里的 s.version 一致
   git push --tags
   

第三阶段：在本地工程中通过 Pod 集成

现在，你的 Pod 已经准备好了。在你的 Xcode 项目中进行集成。

1. 修改 Podfile：
   打开你本地工程的 Podfile 文件。

2. 指定 Pod 源：
   使用 pod 指令时，直接指向你 Fork 后的仓库地址和对应的 Tag。

   方法一：直接使用 Git 地址（推荐，最简单）

   pod 'NMSSH', :git => 'https://github.com/你的用户名/NMSSH.git', :tag => '2.3.1'
   

   方法二：使用本地路径（适用于调试和修改 NMSSH 代码）

   pod 'NMSSH', :path => '/path/to/your/local/NMSSH'
   

3. 安装依赖：
   在终端中，进入你的工程目录，执行安装命令。

   cd /path/to/your/project
   pod install
   

   或者，如果你希望强制 CocoaPods 重新拉取代码，可以使用：

   pod install --repo-update
   

4. 使用：
   完成后，打开你的 .xcworkspace 工作空间文件，你就可以像使用官方库一样 import NMSSH 并开始使用了。

重要提示与最佳实践

• 同步原仓库更新：如果原 NMSSH 修复了 Bug 或增加了新功能，你可能需要手动将更新拉取到你的 Fork 仓库。这通常通过在本地添加原仓库为 upstream 远程库，然后进行 fetch 和 merge 操作来完成。
• 版本管理：每次你对库进行重大修改后，都应该更新 s.version 并打上新的 Tag，然后在项目的 Podfile 中更新这个 Tag。这有助于管理依赖版本。
• 验证 Podspec：在推送之前，可以使用 pod spec lint NMSSH.podspec 命令来验证你的 .podspec 文件格式是否正确。如果验证通过，说明配置没有问题。
• 创建 Pod Repo（高级）：如果你想在公司内部共享这个库，可以考虑创建一个私有的 CocoaPods Specs Repo，并将你的 .podspec 文件提交到那里。这样你就可以像使用官方库一样直接 pod 'YourNMSSH' 了。

按照以上步骤，你就能完全掌控 NMSSH 这个依赖，并根据项目需求自由地进行定制化开发了。