创建公共/私有pod --podspec
定义
私有pod: 个人理解,通过公司的服务器作为代码仓库保存的pod,除被分配了相应权限的人(一般为公司内部员工)外的其它人无法访问该pod. 在组件化开发中,以私有的pod作为组件.
公共pod:公开的pod,例如常用的github中的支持pod的库,能够被任何人访问.
基本步骤
1.在自己的服务器创建代码仓库, 地址可能长这样:ssh://git@192.168.250.150/HHCoreFrawmework.git;
2.本地clone一份,写代码..............;
3.创建并编辑podspec文件(描述当前代码仓库的信息), 参数设置看下面详情;
4.打tag(指定版本号), 主要用于版本控制(必须与podspec中版本一致), git tag -m "1.0.1" 1.0.0 ;
5. trunk push(私有pod时请跳过此步骤), pod trunk push yourProj.podspec ;
6.在Podfile中使用 pod ‘podName’ , :git => "ssh://git@192.168.250.150/HHCoreFrawmework.git”, :tag => ‘0.0.5’ (公共pod不需要指定git地址,只需要名称即可);
1.创建podspec文件
该文件用于描述当前代码仓库的具体信息:name,version,sourceFile等.
pod spec create podName
编写podspec文件
Pod::Spec.new do |s|
s.name = "podName" #名字
s.version = "0.1.0" #版本号
s.summary = "Custom Category" #简短的介绍
s.homepage = "https://github.com/515783034/podName" #主页,这里要填写可以访问到的地址,不然验证不通过
s.license = "MIT" #开源协议
s.author = { "shmily" => "shijian@hh-medic.com" } #作者信息
s.platform = :ios, "10.0" #支持平台及版本
s.source = { :git => "ssh://github.com/515783034/podName.git", :tag => s.version }
s.source_files = "podName/**/*" #代码源文件地址,**/*表示podName目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置(注意: 这个是物理路径,不是Xcode的项目里的路径)
s.requires_arc = true #项目是否使用 ARC
s.resources = "resource/**/*" #资源文件(*.xib,*.png, bundle等)
s.dependency "JSONKit", "~> 1.4" #当前依赖库,pod install时会自动下载该库(注意:没有=)
end
注意: 1. s.version应和tag的版本一致.先push该文件之后,再push --tags
2. 将源代码放置在固定的文件夹下,同时修改s.source_files
2.push修改后的文件
注意:一定要上传podspec文件
git add .
git commit -m ""
git pull
git push
3.打Tag(这个很重要)
git tag -m "注释" 0.0.2
git push --tags
4.修改Podfile文件
pod ‘podName’ , :git => "ssh://git@123.57.250.150/pacssvr.test.git”, :tag => ‘0.0.5’
# s.name source version
5.添加资源文件
1.添加xib
在pod中,xib不能当成源文件(即s.source_files),否则pod install之后会报错"Unable to run command 'StripNIB xxx.nib' - this target might include its own product".所以必须要将xib放入资源文件中(即s.resources)
使用此方式后,虽然可以在不改变原xib任何代码的情况下直接使用,但是需要将xib中使用到的图片文件拷贝到当前项目的Assets.xcassets中
2.添加图片
方式1:类似于xib,不需其它操作,将用到图片添加到当前项目Assets.xcassets中;
方式2:将图片放入s.Resource(或者s.resource_bundles)中
6.添加.a或.framework库
某些情况下, 当前pod需要导入第三方库, 比如libWeChatSDK.a, AlipaySDK.framework. 配置方法如下
1.podspec连接配置
s.xcconfig = {'OTHER_LDFLAGS' => '-ObjC' }
s.vendored_libraries = 'HHPay/Sources/WechatPay/SDK/libWeChatSDK.a'
s.framework = "AlipaySDK"
s.vendored_frameworks = 'HHPay/Sources/Alipay/AlipaySDK.framework'
2. 链接系统框架
// libWeChatSDK.a需要依赖其他系统库
s.framework = "PassKit", "SystemConfiguration", "CoreTelephony", "Security", "CoreMotion"
创建非私有pod
在github上造了一个轮子,希望别人可以通过pod引用你的轮子,那么你就要建一个非私有的pod(可以被公开访问)
1.前三步和创建私有pod相同
2.使用trunk
A.如果是第一次使用,需要注册*
pod trunk register yourmail@gmail.com 'yourName'
B.检查是否注册成功*
pod trunk me
C. 验证podspec文件是否有误
pod lib lint
D.push pod spec文件
pod trunk push yourProj.podspec
如果在创建的过程中遇到问题, 可是查看我之前遇到的一些问题总结.
推荐袁峥Seemygo 的文章教你从0到1如何实现组件化架构,写的很详细。