手把手教你使用CocoaPods打包静态库

来源:互联网 发布:java 引用js文件 编辑:程序博客网 时间:2024/05/23 00:09

今天我们就来谈一谈如何使用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-YLJNetworking项目为例:

  1. 请确保已经正确安装CocoaPods环境,之后步骤均建立在此基础上进行,安装请参考CocoaPods使用篇;
  2. 打开终端,执行 pod lib create Core-YLJSNetworking, 接下来需要确认5个问题,如下:
    这里写图片描述

    第一个问题是我们需要选择的开发语言,这里我们选择ObjC;
    第二个问题是询问是否包含一个Demo项目,一般会选择Yes,不过这里我选择了No…
    具体说明你也可以参考官方文档 Using Pod Lib Create,接下来终端正在自动执行pod install (如果没有自动执行情看终端输出的错误信息并修正好相关语法 后,在终端通过 cd 命令进入到 Example 目录下,手动执行 pod install 来让你的 Demo 项目安装依赖项)

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

  4. 打开 Core-YLJNetworking.podspec 文件,并修改配置信息,如下:
Pod::Spec.new do |s|  s.name             = "Core-YLJNetworking"  s.version          = "0.1.0"  s.summary          = "A short description of Core-YLJNetworking."  s.description      = "Description of Core-YLJNetworking."  s.homepage         = "https://github.com/KosonGou/Core-YLJNetworking"  # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2"  s.license          = 'MIT'  s.author           = { "KosonGou" => "kosonguo@gmail.com" }  s.source           = { :git => "/Users/KosonGou/Documents/Workspace/Library/Core-YLJNetworking_3.0.0", :tag => "0.1.0" }  s.platform     = :ios, '7.0'  s.requires_arc = true  s.source_files = 'Core-YLJNetworking/Classes/**/*'  s.resource_bundles = {      'Core-YLJNetworking' => ['Core-YLJNetworking/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 程序加载刚刚新创建的类了。这里简单贴一下我的代码吧。
这里写图片描述

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

7、提交源码,打 tag。

git add .git commit -a -m 'Core-YLJNetworking v0.1.0'git tag -a 0.1.0 -m 'Core-YLJNetworking v0.1.0'

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

pod lib lint Core-YLJNetworking.podspec --allow-warnings

9、打包。此时你需要安装一个 CocoaPods 打包插件 CocoaPods-Packager,安装命令如下:
sudo gem install cocoapods-packager
安装完成之后,就可以愉快地继续打包了,在终端输入如下命令(切记,此时你应该在你的项目根目录下,即 podspec 文件所在目录):

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

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

0 0
原创粉丝点击