作者:wangzz
原文地址:http://blog.csdn.net/wzzvictory/article/details/20067595
转载请注明出处
学会使用别人的pods依赖库后,你一定对创建自己的依赖库跃跃欲试,今天就来揭开pods依赖库创建过程的神秘面纱。整个创建过程都以实现一个名为WZMarqueeView为例,步骤如下:
一、创建自己的github仓库
cocoapods都托管在github上(官方链接为:https://github.com/CocoaPods),所有的pods依赖库也都依赖github,因此第一步我们需要创建一个属于自己的github仓库。仓库创建如下:
上图中标了序号的共有6处,对应的说明如下:
1.Respository name
仓库名称,这里写成FZMarqueeView,必填的;
2.Description
仓库的描述信息,可选的;
3.仓库的公开性
这里只能选public,一个是因为Private是要钱的,另一个private别人看不到无法共享。
4.是否创建一个默认的README文件
一个完整的仓库,都需要README文件,建议选上。当然不嫌麻烦也可以在后面手动创建一个。
5.是否添加.gitignore文件
.gitignore文件里面记载了若干种文件类型,凡是该文件包含的文件类型,git都不会将其纳入到版本管理中。是否选择看个人需要;
6.license类型
正规的仓库都应该有一个license文件,pods依赖库对这个文件的要求更严,是必须要有的。因此最好在这里让github创建一个,也可以自己后续手动创建,这里使用的license类型是MIT。
上面的各项都填写完毕后,点击Creat respository按钮即可,创建成功界面如图:
到这,仓库的创建就结束了。
二、clone仓库到本地
为了方便向仓库增删内容,需要先将仓库clone到本地,操作方式有多种,推荐使用命令行:
- $ git clone https://github.com/11010/FZMarqueeView.git
操作完成后,github上对应的文件都会拷贝到本地,目录结构如上。
github上仓库中的.gitignore文件是以.开头的隐藏文件,因此这里只能看到两个。后续我们所有文件增删改都在这个目录下进行。
三、向本地git仓库中添加创建pods依赖库所需文件
注意:以下描述的文件都要放在步骤二clone到本地的git仓库的根目录下面。
1、后缀为.podspec文件
该文件为pods依赖库的描述文件,每个pods依赖库必须有且仅有那么一个描述文件。文件名称要和我们想创建的依赖库名称保持一致,我的FZMarqueeView依赖库对应的文件名为FZMarqueeView.podspec。
1.1podspec文件内容
WZMarqueeView.podspec的保存内容为:
- Pod::Spec.new do |s|
- s.name = "WZMarqueeView"
- s.version = "1.0.0"
- s.summary = "A marquee view used on iOS."
- s.description = <<-DESC
- It is a marquee view used on iOS, which implement by Objective-C.
- DESC
- s.homepage = "https://github.com/wangzz/WZMarqueeView"
- # s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
- s.license = ‘MIT‘
- s.author = { "王中周" => "[email protected]" }
- s.source = { :git => "https://github.com/wangzz/WZMarqueeView.git", :tag => s.version.to_s }
- # s.social_media_url = ‘https://twitter.com/NAME‘
- s.platform = :ios, ‘4.3‘
- # s.ios.deployment_target = ‘5.0‘
- # s.osx.deployment_target = ‘10.7‘
- s.requires_arc = true
- s.source_files = ‘WZMarqueeView/*‘
- # s.resources = ‘Assets‘
- # s.ios.exclude_files = ‘Classes/osx‘
- # s.osx.exclude_files = ‘Classes/ios‘
- # s.public_header_files = ‘Classes/**/*.h‘
- s.frameworks = ‘Foundation‘, ‘CoreGraphics‘, ‘UIKit‘
- end
该文件是ruby文件,里面的条目都很容易知道含义
其中需要说明的有几个参数”
(1)s.license
pods依赖库使用的license类型,大家都天上自己对应的选择即可。
(2)s.source_files
表示源文件的路径,注意这个路径是相对podspec文件而言的。
(3)s.frameworks
需要用到的frameworks,不需要加.frameworks后缀。
1.2如何创建podspec文件
大家创建自己的podspec文件可以有两个途径:
(1)copy上面的podspec文件然后修改对应的参数,推荐使用这种方式。
(2)执行以下命令
- $ pod spec create WZMarqueeView
也会创建名为FZMarqueeView.podspec的文件。但是打开创建玩的文件你就会发现里面东西太多了,很多都是我们不需要的。
2、LICENSE文件
CocoaPods强制要求所有的Pods依赖库都必须有license文件,否则验证不会通过。license的类型有很多种,详情可以参考网站tl;dr Legal。在创建github仓库的时候,我们一斤该选择了MIT类型的license。
3、主类文件
创建Pods依赖库就是为了方便别人使用我们的陈国,比如我想共享给大家FZ类,是我想提供给广大用户使用的,这个类自然不可少,我把这个类包含的两个文件放到一个名为FZ的文件夹总,对应的目录结构如图:
里面包含两个文件:WZMarqueeView.h和WZMarqueeView.m
4、demo工程
为了快速教会别人使用我们的pods依赖库,通常要提供一个demo工程。我创建的demo工程放到了一个名为WZdemo的文件夹中,该目录包含文件如下:
5、README.md
使用github的人应该都熟悉这个文件,他是成功gith仓库必不可少的一部分,使用的是markdown标记语言,用于对仓库的详细说明。
以上所有的5个是创建pods依赖库所需要的最基础文件,其中123是必须的,45是可选但强烈推荐的。添加完这些文件以后,我的github本地仓库目录就编程了下面所示的样子:
未完