项目开发中会用到第三方库, 相信大家都使用过CocoaPods, 可以方便我们管理那些第三方的框架。那么我们今天就来说下我们自己怎么将项目中的工具类封装成库并发布到CocoaPods官方。
一、代码上传到Github
1. 在github官网创建项目
打开Github官网, 注册/登录账号后, 点击 New repository 新建项目, 如图
要选择
MIT License, 很重要, 点击 Create repository等待片刻, 项目就创建完成了, 查看项目git地址, 如图
如果忘记选择 MIT License, 请移步GitHub 给已存在的仓库增加开原协议LICENSE
2. 上传本地代码
打开终端, 切换路到Desktop, 克隆项目。如果需要学习git命令请移步Git教程
git clone https://github.com/lvdlGit/LoopScrollViews.git
看到100%就是clone完成了, 打开clone的项目文件夹, 把要上传的工具类代码copy进去, 打开终端cd到项目文件夹下, 提交代码到github远程仓库
git add . // 添加所有文件到本地仓库
git commit -am "first commit" // 保存所有代码到本地仓库
git push origin master // 将本地仓库内容提交到github远程仓库
提交完成 成如下图所示:
二、创建podspec文件
1. 安装Cocoapods
首先我们需要安装CocoaPods环境,没安装的同学可以跟着安装下,最好安装最新的环境。参考 CocoaPods安装细节 和 CocoaPods安装
镜像源目前使用: https://gems.ruby-china.com
2018.8.28 镜像源https://gems.ruby-china.org/更改为https://gems.ruby-china.com
2. 新建podspec文件
在终端输入命令
pod spec create LoopScrollViews
在工程目录下会出现后缀为.podspec的文件, 用xcode打开它
因为很多都是注释掉的, 精简后的内容
Pod::Spec.new do |spec|
spec.name = "LoopScrollViews" // 名称
spec.version = "0.0.1" // 版本号
spec.summary = "A short description of LoopScrollViews." // 简单描述
spec.description = <<-DESC // 详细描述
DESC
spec.homepage = "http://EXAMPLE/LoopScrollViews" // 组件homepage地址
spec.license = "MIT (example)" // 许可证
spec.author = { "lvdl" => "1453162022@qq.com" } // 作者
spec.source = { :git => "http://EXAMPLE/LoopScrollViews.git", :tag => "#{spec.version}" } // 组件source地址
spec.source_files = "Classes", "Classes/**/*.{h,m}" // 组件中资源文件路径
spec.exclude_files = "Classes/Exclude"
# spec.dependency "JSONKit", "~> 1.4" // 组件的依赖库
end
3. 配置podspec文件
根据自己需求修改相应内容即可
此处修改内容为
Pod::Spec.new do |spec|
spec.name = "LoopScrollViews"
spec.version = "1.0.0"
spec.summary = "An iOS loop scroll image views"
spec.description = <<-DESC
An iOS loop scroll image views
DESC
spec.homepage = "https://github.com/lvdlGit/LoopScrollViews"
spec.license = "MIT"
spec.author = { "lvdl" => "1453162022@qq.com" }
spec.source = { :git => "https://github.com/lvdlGit/LoopScrollViews.git", :tag => "#{spec.version}" }
spec.source_files = "LoopScrollViews", "LoopCollectionView/*.{h,m}"
spec.exclude_files = "LoopScrollViews/Exclude"
spec.platform = :ios, "8.0"
spec.dependency "SDWebImage", "~> 4.4.0"
end
保存后本地验证一下, 终端命令
pod lib lint LoopScrollViews.podspec --allow-warnings
结果多种多样，如果有错，则按照提示进行修改即可。可以参考
http://www.jianshu.com/p/283584683b0b
这篇文章查找问题
看到这行绿色的字就说明验证通过了
三、上传podspec文件到远端仓库
1. 在Github上创建release版本
打开GitHub, 找到上面创建的项目, 开始创建release版本
2. 上传podspec文件
下面又是在终端的操作
git add .
git commit -am "上传podspec文件"
git push origin master
3. 给当前版本打个tag
git tag -m "first release" "1.0.0" // 打tag, 要和podspec文件里spec.version = "1.0.0" 一致
git tag // 查看tag版本号是否成功
git push --tags // 上传tags
四、上传代码到CocoaPods
1. 注册CocoaPods账号
此步骤必须有CocoaPods账号, 在终端输入
pod trunk register 邮箱地址 ‘用户名’
会出现一段黄色字体, 提示发送了一个验证码到邮箱，打开你的邮箱验证即可。验证通过后, 可以通过
pod trunk me
检查是否创建成功(会显示注册的邮箱,用户名和时间)。
2. 上传代码到CocoaPods
上面已经验证过了podspec文件, 如果担心会出错, 可以再验证下, 警告可以忽略, 没有Error就可以
pod spec lint --allow-warnings
或者
pod lib lint LoopScrollViews.podspec --allow-warnings
验证通过后, 然后开始上传, 执行命令
pod trunk push LoopScrollViews.podspec --allow-warnings
上传的比较慢, 可能需要等一会
出现这个就说明上传成功了。可以通过
pod search LoopScrollViews
验证一下, what ! ! ! 竟然搜索不到~~~~
一番查阅后, 在终端执行
rm ~/Library/Caches/CocoaPods/search_index.json
删除Cocoapods的搜索文件，下次pod search的时候会重新加载这个文件, 再次用命令pod search LoopScrollViews验证, 搜索到了, 结果如图
这样自己的cocoapods库就制作发布成功了, 可以在通过pod 'LoopScrollViews', '~> 1.0.0' 让别人下载使用了。
总结:在制作自己的cocoapods库过程中遇到很多很多的问题，这个时候千万不要轻言放弃, 静下心来查阅资料学习, 一定会成功的。作为程序猿, 对于常用到的demo或工具类，上传到Cocoapods上进行管理，非常的方便。
