【iOS】制作Cocoapods库

注册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

你可能感兴趣的:(【iOS】制作Cocoapods库)