美文网首页iOS 基本开发iOS 伪组件专题SDK制作
一步一步教你使用CocoaPods打包静态库

一步一步教你使用CocoaPods打包静态库

作者: Koson | 来源:发表于2016-05-12 15:59 被阅读5923次

    在上一篇分享的文章《如何制作一个令人愉悦的框架》中,我们有讲到包依赖和管理工具:CocoaPods,今天我们就来谈一谈如何使用CocoaPods打包静态库。一般情况下我们使用CocoaPods来管理第三方开源类库,但是我们也有可能存在这样的需求:开发一个用CocoaPods来管理依赖关系的静态库给其他人使用,但是又不想公开源代码,比如:SDK,那么我们就需要把他打成静态库。这篇文章以一个依赖AFNetworking 3.0的静态库来讲述如何创建使用了CocoaPods的静态库以及打包的过程。

    静态库的创建方式

    1、通过Xcode提供的项目模板

    2、使用CocoaPods自动创建

    手动创建

    1、在Xcode直接创建一个Cocoa Touch Static Library;

    2、创建Podfile文件;

    3、执行pod install完成整个项目的搭建;

    4、手动创建Demo程序,使用pod添加对私有静态库的依赖,再次执行pod install完成Demo项目的搭建。

    使用CocoaPods自动创建

    以Core-JJSNetworking项目为例:

    1、请确保已经正确安装CocoaPods环境,之后步骤均建立在此基础上进行,安装请参考CocoaPods使用篇

    2、打开终端,执行pod lib create Core-JJSNetworking, 接下来需要确认5个问题,如下

    第一个问题是我们需要选择的开发语言,这里我们选择ObjC;

    第二个问题是询问是否包含一个Demo项目,一般会选择Yes,不过这里我选择了No...

    具体说明你也可以参考官方文档 Using Pod Lib Create,接下来终端正在自动执行pod install (如果没有自动执行情看终端输出的错误信息并修正好相关语法      后,在终端通过 cd 命令进入到 Example 目录下,手动执行 pod install 来让你的 Demo 项目安装依赖项)

    3、我们的项目自动创建好了,通过xcworksapce打开项目,我们的目录结构是这样的(如果创建的时候选择了Include a demo application的结构稍有不同):

    4、打开 Core-JJSNetworking.podspec 文件,并修改配置信息,如下:

    Pod::Spec.new do |s|

    s.name= "Core-JJSNetworking"

    s.version          = "0.1.0"

    s.summary          = "A short description of Core-JJSNetworking."

    s.description      = "Description of Core-JJSNetworking."

    s.homepage         = "https://github.com/KosonGou/Core-JJSNetworking"

    # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2"

    s.license          = 'MIT'

    s.author           = { "KS" => "kosonguo@gmail.com" }

    s.source           = { :git => "/Users/KS/Documents/Workspace/Library/Core-JJSNetworking_3.0.0", :tag => "0.1.0" }

    s.platform     = :ios, '7.0'

    s.requires_arc = true

    s.source_files = 'Core-JJSNetworking/Classes/**/*'

    s.resource_bundles = {

    'Core-JJSNetworking' => ['Core-JJSNetworking/Assets/*.png']

    }

    s.public_header_files = 'Pod/Classes/**/*.h'

    s.frameworks = 'SystemConfiguration','MobileCoreServices','CoreGraphics'

    s.dependency 'AFNetworking', '~> 3.0'

    end

    s.version 表示的是当前类库的版本号;

    s.source 表示当前类库源;

    s.sources_files 表示类库的源文件存放目录;

    s.resource_bundles 表示资源文件存放目录;

    s.frameworks 表示类库依赖的framework;

    s.dependency 表示依赖的第三方类库;

    更多详细说明,请参照Podspec Syntax Reference

    5、添加代码类,需要值得注意的是:我们的 podspec 文件里面的指定的 s.source_files 是在 Pod/Classes 目录下面,所以小伙伴的类文件一定不要存放错了哦!代码添加完毕后,可以运行一下 pod install 来让 demo 程序加载刚刚新创建的类了。因为编辑器问题,这里简单贴一下我的代码吧,详细代码可到SVN上获取。

    6、如果你也包含了 Demo 项目的话,那就需要在项目中加入使用示例了。

    7、提交源码,打 tag。

    8、使用 pod lib lint 验证类库是否符合 pod 的要求,可以使用 --allow-warnings 来忽略一些警告。

    9、打包。此时你需要安装一个 CocoaPods 打包插件

    CocoaPods-Packager

    ,安装命令如下:

    sudo gem install cocoapods-packager

    安装完成之后,就可以愉快地继续打包了,在终端输入如下命令(切记,此时你应该在你的项目根目录下,即 podspec 文件所在目录):

    注意了,如果命令后面加条尾巴  --library 则表示打包成 .a 文件,如果不带,则会打包成 .framework 文件。而 --force 则表示强制覆盖之前存在的文件。下面      让我们一起来见证奇迹吧,项目目录下面多了一个 Core-JJSNetworking-0.1.0 的文件夹,这个便是插件帮我们打好的静态库了,而 .framework 文件是放在了 ios 目录下面:

    10、最后,小伙伴们可以使用打包好的静态库了。直接把静态库拖入到项目中,然后,加入指定的依赖项目即可。

    写在最后

    欢迎大家加我好友,一起探讨 iOS 开发相关的知识,如果你在开发过程中遇到什么 bug,也可以发给我一起解决。

    相关文章

      网友评论

      • 8b0ae165f1f9:创建出来的目录结构内没有Example,有setup,templates.知道这是怎么回事吗?
      • 邹等等:请教一下1.podspec打包静态库的时候 依赖了Swift库 错误信息提示向Profile添加use_frameworks! 加了还是报错 2.打包静态库时 podspec依赖本地仓库 报错,有什么好办法吗(不打算发布到cocoapods)
      • 我的大名叫小爱:packge 打出来的framework真机模拟器是都可以用?????
        我的大名叫小爱:刚才查了下 package打包真机模拟器都是可以用的 不过都是release版的。 真机release 模拟器release版 调试的时候可能就没有那么方便了 需要源文件才,。。
      • 4db063022257:打包成功了,在新工程里也可以用。但是在新工程里必须重新pod AFNetworking。这样是对的吗?
        叶郊寒:您好,找不到Pod/Classes这个目录是怎么回事,能说下吗?
        4db063022257:@Koson 静态库是引用了AFNetworking,直接加加入新工程,但是还必须在新工程里pod AFnetworking。打包静态库没把AFNetworking打进去吗?
        Koson:是对的。静态库直接加入到项目使用就是这样。你可以换其他方式使用,如果项目允许的话
      • iCoders:我使用pod lib create Core-JJSNetworking,没有下面的四个问题是什么情况?多谢解答
        Koson:@iCoders 能不能截图看一下
        Koson:终端有输出什么?
        iCoders:创建出来的文件乱七八糟的,没有xcworksapce文件
      • BeanDu:打出来的framework中头文件为空,请问遇到这种情况吗?
        2432acf0c9fd:同问这个问题,请问解决了吗!
        Koson:@BeanDu 请按照步骤重新试一试。确保类文件没有放错位置
      • Amy莫莫:请教一下,工程里本来就依赖静态库,你知道怎么打包么,我现在用pods打就报错,说因为我的工程里依赖了静态库
        CoderXLL:@Koson 我去,搞了一早上!!!!!!!!才在这个评论里发现原因。自己的静态库要以lib为前缀命名!!!!!!!!!!!!!!!!!!!!!!!!
        BeanDu:打出来的framework中头文件为空,请问遇到这种情况吗?
        Koson:@树上蚍蜉 podspec文件添加好描述即可。简单说明下:s.frameworks表示依赖系统的框架(UIKit.framework等,s.frameworks = 'UIKit');s.libraries表示依赖系统类库(libz.dylib等,s.libraries = 'z');s.vendored_libraries表示依赖第三方的静态库(比如libWeChatSDK.a,s.vendored_libraries = 'Library/Classes/libWeChatSDK.a'),依赖的第三方的或者自己的静态库文件必须以lib为前缀进行命名,否则会出现找不到的情况,这一点非常重要);s.vendored_frameworks表示依赖第三方打包好的framework.
      • 站在下一刻:请教下,可以设置只打真机的.a吗?包含模拟器架构的包好大啊
        Koson:可以的
      • Doliant_H:hello 我还有些问题想请教能给我一个联系方式么
        Koson:@左岸听雨 QQ:674946329
      • 93d45d365eeb:CocoaPods-Packager 1.3.0貌似不能用了,打包出错
        Koson:@佳爷jw 更新cocoapods-packager 1.4.0,bug已经修复。
        93d45d365eeb:@Koson 是的,看到了。 还有,貌似trunk也会有问题
        Koson:@佳爷jw 是的,官方回复是:Sorry, I have yet to finish the changes required for cocoapods-packager to support 1.0.(https://github.com/CocoaPods/cocoapods-packager/issues/137#issuecomment-218980020)。回退版本或者使用其它方式打包静态库吧,相信很快就会修复这个问题的。

      本文标题:一步一步教你使用CocoaPods打包静态库

      本文链接:https://www.haomeiwen.com/subject/kjlprttx.html