[HMLY]4.CocoaPods详解----制作

时间:2023-03-09 00:23:05
[HMLY]4.CocoaPods详解----制作
作者:wangzz
转载请注明出处
学会使用别人的pods依赖库后,你一定对创建自己的依赖库跃跃欲试,今天就来揭开pods依赖库创建过程的神秘面纱。整个创建过程都以实现一个名为WZMarqueeView为例,步骤如下:
一、创建自己的github仓库
cocoapods都托管在github上(官方链接为:https://github.com/CocoaPods),所有的pods依赖库也都依赖github,因此第一步我们需要创建一个属于自己的github仓库。仓库创建如下:
[HMLY]4.CocoaPods详解----制作

上图中标了序号的共有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按钮即可,创建成功界面如图:

[HMLY]4.CocoaPods详解----制作

到这,仓库的创建就结束了。

二、clone仓库到本地

为了方便向仓库增删内容,需要先将仓库clone到本地,操作方式有多种,推荐使用命令行:

  1. $ git clone https://github.com/11010/FZMarqueeView.git

[HMLY]4.CocoaPods详解----制作

操作完成后,github上对应的文件都会拷贝到本地,目录结构如上。

github上仓库中的.gitignore文件是以.开头的隐藏文件,因此这里只能看到两个。后续我们所有文件增删改都在这个目录下进行。

三、向本地git仓库中添加创建pods依赖库所需文件

注意:以下描述的文件都要放在步骤二clone到本地的git仓库的根目录下面。

1、后缀为.podspec文件

该文件为pods依赖库的描述文件,每个pods依赖库必须有且仅有那么一个描述文件。文件名称要和我们想创建的依赖库名称保持一致,我的FZMarqueeView依赖库对应的文件名为FZMarqueeView.podspec。

1.1podspec文件内容

WZMarqueeView.podspec的保存内容为:

  1. Pod::Spec.new do |s|
  2. s.name             = "WZMarqueeView"
  3. s.version          = "1.0.0"
  4. s.summary          = "A marquee view used on iOS."
  5. s.description      = <<-DESC
  6. It is a marquee view used on iOS, which implement by Objective-C.
  7. DESC
  8. s.homepage         = "https://github.com/wangzz/WZMarqueeView"
  9. # s.screenshots      = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
  10. s.license          = 'MIT'
  11. s.author           = { "王中周" => "wzzvictory_tjsd@163.com" }
  12. s.source           = { :git => "https://github.com/wangzz/WZMarqueeView.git", :tag => s.version.to_s }
  13. # s.social_media_url = 'https://twitter.com/NAME'
  14. s.platform     = :ios, '4.3'
  15. # s.ios.deployment_target = '5.0'
  16. # s.osx.deployment_target = '10.7'
  17. s.requires_arc = true
  18. s.source_files = 'WZMarqueeView/*'
  19. # s.resources = 'Assets'
  20. # s.ios.exclude_files = 'Classes/osx'
  21. # s.osx.exclude_files = 'Classes/ios'
  22. # s.public_header_files = 'Classes/**/*.h'
  23. s.frameworks = 'Foundation', 'CoreGraphics', 'UIKit'
  24. 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)执行以下命令

  1. $ pod spec create WZMarqueeView

也会创建名为FZMarqueeView.podspec的文件。但是打开创建玩的文件你就会发现里面东西太多了,很多都是我们不需要的。

2、LICENSE文件

CocoaPods强制要求所有的Pods依赖库都必须有license文件,否则验证不会通过。license的类型有很多种,详情可以参考网站tl;dr Legal。在创建github仓库的时候,我们一斤该选择了MIT类型的license。

3、主类文件

创建Pods依赖库就是为了方便别人使用我们的陈国,比如我想共享给大家FZ类,是我想提供给广大用户使用的,这个类自然不可少,我把这个类包含的两个文件放到一个名为FZ的文件夹总,对应的目录结构如图:

[HMLY]4.CocoaPods详解----制作

里面包含两个文件:WZMarqueeView.h和WZMarqueeView.m

4、demo工程

为了快速教会别人使用我们的pods依赖库,通常要提供一个demo工程。我创建的demo工程放到了一个名为WZdemo的文件夹中,该目录包含文件如下:

[HMLY]4.CocoaPods详解----制作

5、README.md

使用github的人应该都熟悉这个文件,他是成功gith仓库必不可少的一部分,使用的是markdown标记语言,用于对仓库的详细说明。

以上所有的5个是创建pods依赖库所需要的最基础文件,其中123是必须的,45是可选但强烈推荐的。添加完这些文件以后,我的github本地仓库目录就编程了下面所示的样子:

[HMLY]4.CocoaPods详解----制作

未完