iOS pod集成开发，制作自己的Cocoapod库

一、制作自己的Cocoapod库

制作私有库的基本步骤:

1.在github创建一个共有库
2.clone到本地,在该文件夹内创建一个新的项目
3.上传到github上
4.创建或登录trunk账号
5.添加.podspec文件
6.podspec上传到github
7.添加库tag标记
8.验证podspec文件
9.podspec上传到Cocoapod中
10.更新本地仓库
11.查看上传结果
12.更新维护自己的库

1.在github上创建一个共有库:

如图:

1731673679171.jpg

1731673811214.jpg

2.clone到本地,在该文件夹内创建一个新的项目:

新建的项目一般会自带一层目录,可以将此目录去掉,将准备公开的库文件放在一个文件夹中,同LICENSE,README文件放在同一目录下:

截屏2024-11-15 20.32.09.png

3.上传到github上

4.创建或登录trunk账号

我们要让用户使用我们的的库，就需要上传到CocoaPod网站进行托管.而要上传文件到CocoaPod，就要创建trunk账户.

4.1 检测是否已经登录

$ pod trunk me

如果没有那么创建用户

4.2 创建pod trunk 用户

pod trunk register 你的邮箱 "你的昵称"

4.3 查收邮件

收到邮件，点击邮件的链接，会跳转到一个页面,提示验证通过
执行:
$ pod trunk me

验证一下

5.添加.podspec文件

我的代码已经提交到github上，还需要上传到CocoaPod上，.podspec文件就是帮助用户搜索到我们制作的库文件的描述文件.

创建.podspec文件有两种方法

方法一:复制已经较成熟的第三方库的.podspec文件到你的项目中,然后将各种信息改成你自己的
下面是我的.podspec

1731674988474.jpg

方法二:手动创建,先切到工程目录,执行命令
pod spec create 库名

随后会在当前目录下生成一个库名. podspec文件,使用Xcode打开,编辑相关项:

完整文件目录结构:

截屏2024-11-15 20.32.09.png

6.将. podspec文件上传到github

git add .
git commit -m "添加了 .podspec文件"
git push

7.添加tag标记

git tag 1.0.0
git push --tags

这句话就是给我们的库文件打tag，这个tag一定要和.podspec文件内容一一对应，否则有问题

8.验证podspec文件

我们去验证自己的库文件的时候，这样写
pod spec lint

或者
pod spec lint ZSWIntegrationTestDemo.podspec

但是有的时候会有一些warning,然后就验证失败，所以我们此时可以

pod spec lint ZSWIntegrationTestDemo.podspec --allow-warnings

截屏2024-11-15 20.56.13.png

9.上传到Cocoapod:

如果刚才验证，没有发现警告，那么可以直接这个样上传
pod trunk push ZSWIntegrationTestDemo.podspec

如果有警告，那么我们要去修改警告或者忽略警告
pod trunk push ZSWIntegrationTestDemo.podspec --allow-warnings

上传成功!

截屏2024-11-13 21.45.25.png

10.更新本地库:

因为CocoaPod本身一直在集成很多开发者的库，他的master分支一直是在更新的，但是你本地的库相对于刚才上传ZSWIntegrationTestDemo的时间节点你本地的库是老的
所以我们要去更新一下本地的库,具体操作:

pod setup //初始化
pod repo update//更新仓库

11.查看上传结果:

pod search ZSWIntegrationTestDemo //查找

会有一定延迟:
pod tunk me

可以再pod网站搜索
https://cocoapods.org

12.更新维护自己的库

1.修改项目源码
2.上传github
3.修改.podspece内部的版本号
4.打tag(同.podspece中版本号)
5.上传tags

二、Cocoapod的安装:

1、ruby环境:

在安装Cocoapod前要确认ruby是否正确安装，可以用如下命令确认当前ruby环境：
$ ruby -v

2、添加gem源

淘宝源:https://ruby.taobao.org/
China源最新域名:https://gems.ruby-china.com
淘宝源已经停止维护了,现由 ruby-china 提供镜像服务，可以使用China源作为gem源。

首先需要确认自己的gem源：

查看是否添加了gem源:
$ gem sources -l
https://gems.ruby-china.org/
如果添加了淘宝的源，可以使用如下命令修改gem源：
$ sudo gem sources --add https://gems.ruby-china.org/ --remove https://ruby.taobao.org/
ruby-china的域名已经更新为.com,可以更新一下源:
$ sudo gem sources --add https://gems.ruby-china.com/ --remove https://gems.ruby-china.org/
如果没有添加gem源，可以使用如下命令添加gem源：
$ sudo gem sources --add https://gems.ruby-china.com
添加完成后，确认当前gem源：
$ gem sources -l
https://gems.ruby-china.com
查看gem源版本:
$ gem -v

3、安装Cocoa-pod

gem 安装 cocoapods
$ sudo gem install cocoapods --pre
$ sudo gem install cocoapods
pod setup

此过程很是缓慢
$ pod setup
Setting up CocoaPods master repo

三、Cocoapod的升级:

1.查看当前ruby源路径：

gem sources -l
*** CURRENT SOURCES ***
http://gems.ruby-china.org/

2、更新一下gem版本

sudo gem update --system
直到看到
RubyGems system software updated
或者 Latest version already installed. Done.
说明gem版本更新成功

3、更新cocoapods

sudo gem install -n /usr/local/bin cocoapods --pre
更新完成之后，再次查看cocoapods的版本
pod --version

四、使用Cocoapod为工程导入第三方库

1、为主工程生成Podfile

在工程的.xcodeproj目录(必须在此目录)中，执行如下命令，即可得到Podfile。
$ pod init

2、编辑Podfile文件

截屏2024-11-15 21.14.21.png

3、生成.xcworkspace工程入口

按照上面的步骤，在子工程下面添加完成podspec之后，在主工程的Podfile对应目录下执行如下命令，即可得到对应的 *.xcworkspace工程入口。
$ pod install --no-repo-update

4、运行.xcworkspace启动工程,可以看到工程已经添加了pod

截屏2024-11-15 21.14.36.png

五、常用的Pod命令：

创建 Podfile 文件

pod init

下载“Podfile”中定义的所有依赖项,并创建一个pod库

pod install

下载“Podfile”中定义的所有依赖项,并创建一个pod库,不更新本地代码库

pod install --no-repo-update

更新Podfile中依赖的框架

pod update

更新Podfile中依赖的框架,可以安装新框架或者删除不用的框架，但是不会升级项目已经安装的框架

pod update --no-repo-update

查看哪些框架有更新版本

pod outdated

搜索框架 #空格下一页 #q 退出

pod search ZSWIntegrationTestDemo

只搜索符合名字的框架

pod search ZSWIntegrationTestDemo --simple

帮助命令

pod --help

其他命令的用法可以用命令+ --help的方式查看用法帮助

六、从工程中删除Cocoapod：

删除工程中的Cocoapod需要删除下列文件:

1.删除工程文件夹下的Podfile、Podfile.lock及Pods文件夹
2.删除xcworkspace文件
3.使用.xcodeproj文件打开工程，删除Frameworks组下的libPods.a引用以及Pods.xcconfig,以及残留的pod文件夹。
4.删除工程pod配置项 TARGET->Build Phases ->
[CP] Check Pods Manifest.lock
[CP] Copy Pods Resources
[CP] Embed Pods Frameworks

制作自己的cocoapod库遇到的问题

在建立自己的远程库的时候执行pod trunk push xxxxx.podspec命令遇到 file patterns: The source_files pattern did not match any file.报错

方法一：

# 源文件的路径
s.source_files = 'ZSWIntegrationTestDemo/Classes'

方法二：

/Users/Library/Caches/CocoaPods/Pods/External/ZSWIntegrationTestDemo/
里面的文件夹里有LICENSE文件，在这个位置创建文件ZSWIntegrationTestDemo，把你创建的库文件具体内容导入到这里就OK了

截屏2024-11-15 21.33.33.png