注册trunk
终端执行以下命令,这里的作者名和podspec中设置的s.author保持一致
$ pod trunk register 邮箱 '作者名称’
收到邮件并确认之后再执行以下命令
$ pod trunk me
创建一个pod库
如果当前已经存在一个 project,创建pod也非常简单:
$ pod spec create PodName
随后编辑podspec文件并执行
$ pod spec lint PodName.podspec
然而创建并配置工程这种费力的活交给 cocoapods 会更好。
所以我们这里使用 pod lib create PodName 去创建一个pod,过程如下:
$ pod lib create YDDemoSDK
Cloning `https://github.com/CocoaPods/pod-template.git` into `YDDemoSDK`.
Configuring YDDemoSDK template.
------------------------------
To get you started we need to ask a few questions, this should only take a minute.
If this is your first time we recommend running through with the guide:
- https://guides.cocoapods.org/making/using-pod-lib-create.html
( hold cmd and double click links to open in a browser. )
What platform do you want to use?? [ iOS / macOS ]
> iOS
What language do you want to use?? [ Swift / ObjC ]
> Objc
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> None
Would you like to do view based testing? [ Yes / No ]
> No
What is your class prefix?
> YD
Running pod install on your new library.
Analyzing dependencies
Fetching podspec for `YDDemoSDK` from `../`
Downloading dependencies
Installing YDDemoSDK (0.1.0)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `YDDemoSDK.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.
[!] Automatically assigning platform ios with version 9.3 on target YDDemoSDK_Example because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.
Ace! you're ready to go!
We will start you off by opening your project in Xcode
open 'YDDemoSDK/Example/YDDemoSDK.xcworkspace'
To learn more about the template see `https://github.com/CocoaPods/pod-template.git`.
To learn more about creating a new pod, see `http://guides.cocoapods.org/making/making-a-cocoapod`.
替换代码
将Classes文件夹下的代码替换为自己将要发布的代码
编辑podspec
.podspec 文件描述了一个 pod 库的版本。它详细说明了这个 pod 库中源码应该从哪里取出、应用怎样的构建设置以及其他基本的信息,比如名称、版本、描述等。
podspec 文件的内容如下:
Pod::Spec.new do |s|
s.name = 'YDDemoSDK' #项目名
s.version = '0.0.1' #相应的版本号
s.summary = 'A short description of YDDemoSDK.' #简述
s.description = <<‐ DESC #详细描述
TODO: Add long description of the pod here.
DESC
s.homepage = 'https://github.com/herody/YDDemoSDK' #项目主页
s.license = { :type => 'MIT', :file => 'LICENSE' } #开源协议
s.author = { 'herody' => '[email protected]' } #作者
s.platform = :ios, '8.0' #支持的平台
s.requires_arc = true #arc和mrc选项
spec.compiler_flags = '-DOS_OBJECT_USE_OBJC=0', '-Wno-format' #A list of flags which should be passed to the compiler.
s.libraries = 'z', 'sqlite3' #表示依赖的系统类库,比如libz.dylib等
s.frameworks = 'UIKit','AVFoundation' #表示依赖的系统framework
s.ios.vendored_frameworks = 'YDDemoSDK/Classes/YDKit.framework' # 依赖的第三方/自己的framework
s.vendored_libraries = 'YDDemoSDK/Classes/libWeChatSDK.a' #表示依赖第三方/自己的 .a 库
#依赖的第三方的或者自己的静态库文件必须以lib为前缀进行命名,否则会出现找不到的情况,这一点非常重要
s.preserve_paths = "IMPORTANT.txt","Frameworks/*.framework" #Any file that should not be removed after being downloaded.
#平台信息
s.platform = :ios, '7.0'
s.ios.deployment_target = '7.0'
#文件配置项
s.source = { :git => 'https://github.com/herody/YDDemoSDK.git', :tag => s.version.to_s }
#配置项目的目标路径,如果不是本地开发,pod init/update会从这个路去拉去代码
s.source_files = 'YDDemoSDK/Classes/**/*.{h,m}' #你的源码位置
#cocoapods 官方推荐使用 resource_bundles,因为 resources 指定的资源会被直接拷贝到目标应用中,
#因此不会被 Xcode 优化,在编译生成 product 时,与目标应用的图片资源以及其他同样使用 resources 的 Pod 的图片一起打包为一个 Assets.car 文件。
#这样全部混杂在一起,就使得资源文件容易产生命名冲突。而 resource_bundles 指定的资源,
#会被编译到独立的 bundle 中,bundle 名就是你的 pod 名,
#这样就很大程度上减小了资源名冲突问题,并且 Xcode 会对 bundle 进行优化。
#一个 bundle 包含一个 Assets.car,获取图片的时候要严格指定 bundle 的位置,
#很好的隔离了各个库或者一个库下的资源文件。
#s.resources = ['YDDemoSDK/Assets/*.png'] #资源,比如图片,音频文件,xib等资源
s.resource_bundles = {
'MapBox' => ['MapView/Map/Resources/*.png'],
'OtherResources' => ['MapView/Map/OtherResources/*.png']
}
s.public_header_files = 'YDDemoSDK/Classes/YDDemoSDK.h' #需要对外开放的头文件
#依赖的项目内容 可以多个
s.dependency 'YYModel'
s.dependency 'AFNetworking' '2.3'
#s.static_framework = true
end
项目调试
进入Example目录,执行
$ pod install
随后运行项目,保证项目正确性
进行本地校验
推送之前,先在本地进行校验
$ pod lib lint PodName.podspec
如果使用了其他私有库,需要指定其他私有库的仓库地址和公有库仓库的地址
$ pod lib lint PodName.podspec --verbose --sources='私有库地址,https://github.com/CocoaPods/Specs.git'
将代码push到远程仓库
在github上创建远程仓库,并将本地代码推送到远程仓库
$ git status -- 查看当前git存了什么文件
$ git add . -- 将所有文件缓存到待提交文件区域
$ git commit -m "上传工程" -- 提交文件,写上备注
$ git remote add origin 远程仓库地址 -- 添加要推送的远程仓库地址
$ git push -u origin master -- 将代码推送到远程仓库的master分支
为项目打标签
这时候直接进行远程校验会报错,需要先为项目打标签
$ git tag "0.0.1"
$ git push --tags
远程校验
打完标签之后,再进行远程校验,远程校验与本地校验几乎一致,命令如下
$ pod spec lint PodName.podspec
上传spec
$ pod trunk push PodName.podspec --allow-warnings
最后验证
终端执行以下命令进行搜索
$ pod search PodName
如果没有搜索到,就删除本地索引库,再进行尝试
$ rm ~/Library/Caches/CocoaPods/search_index.json