如何制作自己的CocoaPod库

2017-01-24 10:21:19来源:http://www.jianshu.com/p/81d364c32432作者:OneTea人点击



制作流程图:



流程图
1.将代码托管在github上
1.1本地代码

如图:



Snip20161228_7.png


在github上创建 并上传



Snip20161228_3.png

切换到本地项目cd xxx路径后 用git命令行 (记不住命令行 git help) 步骤如下:


$ git init
$ git add /Users/kevin/Desktop/xxx //直接拖拉项目文件夹
$ git commit -m 'frsit commit' //推到本地仓库
$ git remote add origin https://github.com/xxx/xxx.git //本地仓库关联github
$ git push -u origin master //推到远程github


给项目branches打上指定的tag


# 打tag
git tag -m "New Tag" '1.0'
# 把tag推到远程仓库
git push --tags

2.构建Pod管理

拉取github代码到pods管理本地目录中(本地文件夹:~/.cocoapods/repos


# pod repo add [私有项目名(repo库)] [github地址]
$ pod repo add KKSWiftHUD https://github.com/xxx/xxx.git

执行后可以cmd+shift +G 输入~/.cocoapods/repos 查看文件的存在
ok ,接下来开始创建pod的一个关键文件(类似项目中Podfile文件)


还是回到项目文件中来(查看ls


一 、创建podspec文件
# 创建podspec文件
$ pod spec create KKSwiftHUD

这时项目中会生成一个KKSwiftHUD.podspec文件 用XCode 打开
把这个粘贴覆盖过去 ( 系统生成很多,这些参数够用了)


Pod::Spec.new do |s|
s.name = "KKSwiftHUD"
s.version = "1.0"
s.summary = "Notification HUD for ios."
s.homepage = "https://github.com/one-tea/KKSwiftHUD.git"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "Zhang KK" => "zhangkkwy@163.com" }
s.platform = :ios, "8.0"
s.source = { :git => "https://github.com/one-tea/KKSwiftHUD.git", :tag => "1.0" }
s.source_files = "KKSwiftHUDLib/*"
s.framework = "UIKit"
s.requires_arc = true
# s.frameworks = "SomeFramework", "AnotherFramework"
end

根据自己的信息 ,进行编辑xxx.podspec文件


s.name         = "xxx" //pod名字
s.version = "1.0"//版本号
s.summary = "Notification HUD for ios."//简介
s.homepage = "https://github.com/xxx.git"// 托管地址
s.license = "MIT"
s.author = { "Zhang KK" => "zhangkkwy@163.com" }// 个人信息
s.platform = :ios, "8.0"
s.source = { :git => "https://github.com/one-tea/KKSwiftHUD.git", :tag => "1.0" }// github上地址和tag
s.source_files = "KKSwiftHUDLib/*" //相对于``KKSwiftHUD.podspec``的路径地址,/**:表示在``KKSwiftHUDLib``下所有文件 ,如果是OC语言也可以用正则语法``KKSwiftHUDLib/**/*.{h,m} ``
s.framework = "UIKit" //依赖库
s.requires_arc = true
s.resources = "KKSwiftHUD/*.png" 图片资源


参数的注释:


 name: 导入pod后的目录名 
version: 当前版本号
deployment_target: 配置的target
prefix_header_file: 预编译头文件路径,将该文件的内容插入到Pod的pch文件内
source: 来源的具体路径,是http链接还是本地路径 requires_arc: 是否需要arc
source_files: 指定该目录下包含哪些文件 其他可选参数还包括: dependency: 指定依赖,如果依赖的库不存在或者依赖库的版本不符合要求将会报错
libraries: 指定导入的库,比如sqlite3
frameworks: 指定导入的framework
weak_frameworks: 弱链接,比如说一个项目同时兼容iOS6和iOS7,但某一个framework只在iOS7上有,这时候如果用强链接,那么在iOS7上运行就会crash,使用weak_frameworks可以避免这种情况。

通配符说明:


a{bb,bc}def.{h,m}表示四个文件abbdef.h abbdef.m abcdef.h abcdef.m
*.{h,m,mm}表示所有的.h .m .mm文件Class/**/*.{h,m}表示Class目录下的所有.h .m文件


二、测试下podspec配置文件是否有错误
$ pod lib lint  // 验证是否有合格
$ pod spec lint // 这个也可以验证

注:如果出现WARN 可以加入--allow-warnings忽略
需要花些时间,最后没有error提示则成功


三、 提交podspec到私有库
# pod repo push [repo仓名] [podspec文件名]
$ pod repo push xxx xxx.podspec

完成之后这个私有库就添加到我们的私有Spec Repo中,可以进入到~/.cocoapods/repos目录下查看


接下来推送到远端CocoaPod仓, 这样别人就可通过 pod search xxx来搜到并使用


四、创建一个trunk账号(用于上传到公共库Cocoapods)
$ sudo gem install cocoapods // 先更新下Cocoapods版本
$ pod trunk register 邮箱 '昵称' --verbose // 填写账号信息,注册完要去邮箱点一个验证邮件(邮箱最好和git的邮箱保持一致)
$ pod trunk me // 验证完成后可以查看账号信息

填写账号信息,注册完要去邮箱点一个验证邮件(邮箱最好和git的邮箱保持一致)
运行结果,成功



Snip20161229_11.png
五 最后一步 trunk提交就可以了
# 提交podspec文件到trunkpod trunk push NNATree.podspec
pod trunk push --allow-warnings

需要一会时间



图片.png

成功了!
pod search xxx 可能需要等一会才能搜到 或者运行 pod setup试试


最后:


删除一个私有库
$ pod repo remove xxx
这样就从本地删除了当然我们还可以通过下面的代码添加回来
$ pod repo add NNASpec http:// github.com/xxx.git
CocoPod管理命令


远程库管理

图片.png

Pod Search Money
Pod Search MM
Pod Search Happy


微信扫一扫

第七城市微信公众平台