CocoaPods 私有库Spec Repo搭建与使用指南

duly2025-04-14 15:01

一、创建私有 Spec Repo

创建 Git 仓库
在 Git 服务器（如 GitHub、GitLab）上新建一个空仓库，例如 PrivateSpecs，用于存放私有库的 podspec 文件。
添加 Spec Repo 到本地
前往文件夹 ~/.cocoapods/repos
打开终端，在终端切换到当前目录下，然后进行pod repo add操作在终端执行以下命令，将私有仓库添加到 CocoaPods 的仓库列表：

csharp 复制代码

#
pod repo add PrivateSpecs git@github.com:your-username/PrivateSpecs.git

替换 your-username 和仓库地址为实际信息，注意使用SSH或者HTTPS方式获取代码。~/.cocoapods/repos的目录下新增加PrivateSpecs文件夹。

二、创建私有库

生成模板项目

在 Git 服务器（如 GitHub、GitLab）上新建一个空仓库，例如 DLYCenterModule。存放私有库代码使用 CocoaPods 模板生成私有库：
lua 复制代码
```
pod lib create DLYCenterModule
```
按提示选择配置（语言、Demo 等）。

配置项目 cd 到Example文件下，然后pod install下，更新Example项目的pod。如图项目中的podspec文件,更改spec。修改s.homepage和s.source为自己git项目内容。新增加的源码放到DLYCenterModule/Classes/目录下。

3.推送代码到 Git 仓库

sql 复制代码

cd DLYCenterModule
git add .
git commit -m "Initial commit"
git remote add origin git@github.com:your-username/DLYCenterModule.git
git push -u origin master

4.打Tag并推送

lua 复制代码

    #注意 tag和s.version = '0.1.0' 的保持一致
    git tag 0.1.0
    git push --tags

三、验证与发布私有库

本地验证 podspec
css 复制代码
```
pod lib lint --allow-warnings
```
若存在警告但可忽略，使用 --allow-warnings。

推送 podspec 到私有 Spec Repo

css 复制代码

pod repo push PrivateSpecs DLYCenterModule.podspec --allow-warnings

3.搜索私有库是否成功

bash 复制代码

#更新PrivateSpecs
pod repo update PrivateSpecs
#搜索 DLYCenterModule
pod search DLYCenterModule

四、使用私有库

配置 Podfile

在项目的 Podfile 中添加私有源和依赖：

bash 复制代码

# 公有源（可选）
source 'https://github.com/CocoaPods/Specs.git'
# 私有源
source 'https://github.com/your-username/PrivateSpecs.git'

target 'YourProject' do
  pod 'DLYCenterModule'
end

安装依赖
复制代码
```
pod install
```