自定义CocoaPods库制作

发表于 |

自定义CocoaPods库制作

CocoaPods的安装这里就不赘述了，各位童鞋自行google解决，记得是google而不是百度。

准备一个git project

在自己的git server上先创建一个project。git server可以大家各自选择，github or 自己的git服务器都可以。我选择之前自己用Gogs搭建的一个git server。关于如何搭建自定义git server，请点击
记录Gogs搭建
我这里就把它命名为CoreKit，里面依赖了网络框架库Alamofire, Pod文件内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
project 'CoreKit.xcodeproj'
# Uncomment this line to define a global platform for your project
platform :ios, '8.0'
target 'CoreKit' do
  # Comment this line if you're not using Swift and don't want to use dynamic frameworks
  use_frameworks!
  # Pods for CoreKit
  
  pod 'Alamofire', '3.4.1'
  
  target 'CoreKitTests' do
    inherit! :search_paths
    # Pods for testing
  end
  target 'CoreKitUITests' do
    inherit! :search_paths
    # Pods for testing
  end
end

这个地方非常简单。
执行pod install，并且增加一些很简单的测试代码。最终工程目录如下所示：

这里就是个单例，然后public了个test的方法，并且print形参。

编写podspec文件

命令行执行下面的命令来创建podspec文件：

1
pod spec create CoreKit

然后你就能在对应的目录下看到相应的文件了，如下图所示：

使用Sublime text打开CoreKit.podspec文件，

不要用文本编辑器
不要用文本编辑器
不要用文本编辑器

重要的事情说三遍，6666~！

至于podspec里面的参数说明相信我解释不如大家自行谷歌，我直接贴源码吧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
#
#  Be sure to run `pod spec lint CoreKit.podspec' to ensure this is a
#  valid spec and to remove all comments including this before submitting the spec.
#
#  To learn more about Podspec attributes see http://docs.cocoapods.org/specification.html
#  To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/
#
Pod::Spec.new do |s|
  # ―――  Spec Metadata  ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  These will help people to find your library, and whilst it
  #  can feel like a chore to fill in it's definitely to your advantage. The
  #  summary should be tweet-length, and the description more in depth.
  #
  s.name         = "CoreKit"
  s.version      = "0.0.1"
  s.summary      = "CoreKit，测试玩玩先"
  # This description is used to generate tags and improve search results.
  #   * Think: What does it do? Why did you write it? What is the focus?
  #   * Try to keep it short, snappy and to the point.
  #   * Write the description between the DESC delimiters below.
  #   * Finally, don't worry about the indent, CocoaPods strips it!
  s.description  = "对项目的具体描述信息，可以比较随意，写一些装逼的话就好了"
  s.homepage     = "随意，但是我直接用的是项目的git仓库地址"
  # s.screenshots  = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"
  # ―――  Spec License  ――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  Licensing your code is important. See http://choosealicense.com for more info.
  #  CocoaPods will detect a license file if there is a named LICENSE*
  #  Popular ones are 'MIT', 'BSD' and 'Apache License, Version 2.0'.
  #
  # s.license      = "MIT"
  s.license      = { :type => "MIT", :file => "LICENSE" }
  # ――― Author Metadata  ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  Specify the authors of the library, with email addresses. Email addresses
  #  of the authors are extracted from the SCM log. E.g. $ git log. CocoaPods also
  #  accepts just a name if you'd rather not provide an email address.
  #
  #  Specify a social_media_url where others can refer to, for example a twitter
  #  profile URL.
  #
  s.author             = { "bartonTang" => "你的邮箱地址" }
  # Or just: s.author    = "bartonTang"
  # s.authors            = { "bartonTang" => "472439901@qq.com" }
  # s.social_media_url   = "http://twitter.com/bartonTang"
  # ――― Platform Specifics ――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  If this Pod runs only on iOS or OS X, then specify the platform and
  #  the deployment target. You can optionally include the target after the platform.
  #
  s.platform     = :ios, "8.0"
  # s.platform     = :ios, "5.0"
  #  When using multiple platforms
  # s.ios.deployment_target = "5.0"
  # s.osx.deployment_target = "10.7"
  # s.watchos.deployment_target = "2.0"
  # s.tvos.deployment_target = "9.0"
  # ――― Source Location ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  Specify the location from where the source should be retrieved.
  #  Supports git, hg, bzr, svn and HTTP.
  #
  s.source       = { :git => "你的git仓库地址", :tag => "#{s.version}" }
  # ――― Source Code ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  CocoaPods is smart about how it includes source code. For source files
  #  giving a folder will include any swift, h, m, mm, c & cpp files.
  #  For header files it will include any header in the folder.
  #  Not including the public_header_files will make all headers public.
  #
  s.source_files  = "CoreKit/Source/*.{h, m}" #, "CoreKit/**/*.{h, m, swift}"
  # s.exclude_files = "Classes/Exclude"
  s.public_header_files = "CoreKit/Source/*.{h, m}"
  # ――― Resources ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  A list of resources included with the Pod. These are copied into the
  #  target bundle with a build phase script. Anything else will be cleaned.
  #  You can preserve files from being cleaned, please don't preserve
  #  non-essential files like tests, examples and documentation.
  #
  # s.resource  = "icon.png"
  # s.resources = "CoreKit/**/*.{png,xib,storyboard}"
  # s.preserve_paths = "FilesToSave", "MoreFilesToSave"
  # ――― Project Linking ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  Link your library with frameworks, or libraries. Libraries do not include
  #  the lib prefix of their name.
  #
  # s.framework  = "Foundation"
  # s.frameworks = "SomeFramework", "AnotherFramework"
  # s.library   = "iconv"
  # s.libraries = "iconv", "xml2"
  # ――― Project Settings ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #
  #  If your library depends on compiler flags you can set them in the xcconfig hash
  #  where they will only apply to your library. If you depend on other Podspecs
  #  you can include multiple dependencies to ensure it works.
  s.requires_arc = true
  # s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
  s.dependency 'Alamofire', '3.4.1'
end

OK，上面这里因为涉及到一些个人信息神马的，有些我换成了描述，具体有：

1
2
3
s.homepage = "随意，但是我直接用的是项目的git仓库地址"
s.author  = { "bartonTang" => "你的邮箱地址" }
s.source  = { :git => "你的git仓库地址", :tag => "#{s.version}" }

上面这些东西大家换成和自己对应的东西就好了。
下面说几个坑：

  1. CocoaPods是根据tag来做管理的，那么那个tag标签就很重要，一定要记得。
  2. s.license 不可缺省，而且最好指定license文件。
  3. s.source_files源文件的路径，是相对podspec文件而言的。
  4. s.frameworks需要用到的frameworks，不用再加.frameworks后缀。

写完podspec文件后对podspec文件进行检查，命令行在当前目录下执行

1
pod lib lint

如果有错的话好好修改下，一般不会有太大问题。成功后会出现类似：
xxx passed validation.

记得提交好你的工程到git server并且记得tag值要和podspec文件里的一致。

在Test工程中引入自定义库

创建一个TestPodsRef工程，并且引入自定义pod库

pod ‘CoreKit’, :git => ‘你的pod库所在的git server地址’

执行pod install。

最终应该都是可以测试成功调用方法的，如果不行，请注意刚才提到的那些坑。
最终运行结果如下图：

OK，回头有空再补充在github上那种，当然这种其实对项目私密保护性更好吧，不过就不开源啦~~~666

App微服务化的第一步就此迈出，吹逼ing~