创建公共/私有pod --podspec

定义

私有pod: 个人理解,通过公司的服务器作为代码仓库保存的pod,除被分配了相应权限的人(一般为公司内部员工)外的其它人无法访问该pod. 在组件化开发中,以私有的pod作为组件.

公共pod:公开的pod,例如常用的github中的支持pod的库,能够被任何人访问.

---

基本步骤

1.在自己的服务器创建代码仓库, 地址可能长这样:ssh://[email protected]/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://[email protected]/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" => "[email protected]" }  #作者信息
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://[email protected]/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 [email protected] 'yourName' 

   B.检查是否注册成功*

    pod trunk me

  C. 验证podspec文件是否有误

   pod lib lint

 D.push pod spec文件

  pod trunk push yourProj.podspec

如果在创建的过程中遇到问题, 可是查看我之前遇到的一些问题总结.

创建私有仓库中踩过的坑

推荐袁峥Seemygo 的文章教你从0到1如何实现组件化架构，写的很详细。