cocoapods使用教程1:创建自己的库(静态动态库)

CocoaPods介绍

CocoaPods是iOS开发最著名的类库管理工具,绝大部分有名的开源类库,都支持CocoaPods。使用CocoaPods可以轻松引入第三方库,管理其版本,相信iOS大部分开发者都用过。怎么安装CocoaPods和在iOS项目中使用CocoaPods,这里就不做介绍了,本篇文章是教大家怎么创建开发属于自己的库(组件),并且使用CocoaPods编译链接静态或动态库,编译好的动态或静态库就可以添加到项目中使用了。

主要步骤

1. 创建Pod lib模板

打开终端,切换到创建库的路径下,输入命令:

pod lib create 库名

然后CocoaPods会从github上下载lib模板,需要回答几个问题初始化模板,初始化成功会自动打开Xcode工程。


@初始化lib模板

2. 编写lib代码,或者把写好的文件添加到项目中

在路径:项目文件夹/lib名文件夹/Classes/ 中,有个文件是“ReplaceMe.m”,意思就是把这个文件替换了,把写好的库文件放到这里。
项目文件夹/lib名文件夹/Assets/ 中,用来存放lib需要用到的资源,比如png等等。

@添加lib代码

3. 编写 *.podspec文件

在工程目录下,会有一个后缀名为“.podspec”的文件,使用文本编辑器打开,或者xcode打开,编辑配置podlib的配置。

@编辑podspec文件

4.pod install

打开工程目录下的Example目录,这里是lib的例子。在这个目录下执行pod install 就会把配置好的lib 重新安装一遍,使用Xcode打开例子,可以编写lib和运行代码看结果。

5.验证lib

前面例子编译通过,调试完成,则验证lib是否符合pod的标准。打开终端,切换到“.podspec”文件的目录下,输入命令pod lib lint,等待pod验证完成。如果有错误或者警告都是不允许验证通过的,不过可以通过参数忽略,下面给出以下 lint 的参数。
--sources:指定Repo地址
--allow-warnings:忽略警告
--use-libraries:依赖了静态库

@验证lib

6.提交git

验证通过,就到提交git,这一步不能少,要不然打包失败。首先之前pod创建的lib模板就是git仓库的,所以我们只需要提交就好了。如果有远端git仓库的,也可以push过去。
之前在编写.podspec文件的时候,有一个参数是“s.source”,这里的地址可以是本地仓库的也可以是远端仓库的。
把lib代码添加到git ------>> commit ------>> 添加tag。
podspec里面的tag,在git上一定要有,要不然找不到。

@提交git

7.打包

验证通过,则进入最后一步打包。这里需要安装一个pod插件cocoapods-packager,在终端执行命令:gem install cocoapods-packager,等待安装完成。

打开终端,切换到“.podspec”文件的目录下,输入命令pod package lib名字.podspec就可以开始打包了,等待打包完成。
pod package lib名字.podspec后面是可以加参数的:
--force:强制覆盖之前存在的文件
--library:打包成.a文件
--dynamic:打包成动态库
--configuration:配置选项,默认为Release

@打包完成

8.lib引用不使用cocoapods的第三方库(不开源的)

大部分的第三方库都支持cocoapods,如果引用支持cocoapods的第三方lib,直接*.podspec文件中使用语句s.dependency 第三方库名这样就能很好的解决。
但是当我们需要引用不支持cocoapods的第三方库时,就得需要另外的语句指定,把需要的第三方lib放入到指定的文件夹中。

s.ios.vendored_frameworks = 'RegionCodeSearch/Classes/*.framework'    #指定framework
s.ios.vendored_libraries = 'RegionCodeSearch/Classes/*.a'    #指定 .a

每次编写好*.podspec后,都需要重新pod install ,重新打开项目导入头文件就可以使用。
在使用自己的lib时,需要把lib中引用的其他库也拖进项目中,否则编译失败。

image.png

欢迎大家交流~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容