创建私有repo
Spec Repo
可以当成是所有pod内容的索引的集合,本质是一个git仓库,目前默认的repo使用的是Master这个仓库,当使用pod setup
命令时会将spec repo
拉取到本地~/.cocoapods/repos
目录下,pod会根据索引的内容拉取内容。创建私有库需要使用一个私有的仓库,并将将这个仓库加入到repo中之后管理这个仓库。创建过程如下:
- 创建一个私有仓库
- 在终端中执行如下命令添加repo
pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
如果添加成功在~/.cocoapods/repos会找到添加repo的文件夹。
创建podspec
使用podspec模板
cocoaPods提供了podspec模板,可以直接在模板中开发
在终端中执行如下命令
pod lib create [项目名]
创建模板
之后会出现一些选项比如选择Swift还是Objc构建项目,你是否选择一个测试框架等根据需求选择即可。之后会在目标路径创建一个项目,同时项目中存在了一个podspec文件,需要将开发用到的文件放入Classes
文件夹中不需要另外配置podspec中的文件路径,并将项目提交到git中,之后配置好podspec就可以提交了。
对于已有项目创建podspec
已有项目中可以直接在项目中创建spec文件
在终端中执行如下命令
[pod spec create] [项目名]
创建spec文件,之后配置podspec文件,就可以上传了。
podspec格式
#
# Be sure to run `pod lib lint TestPod.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
#名称
s.name = 'TestPod'
#版本号
s.version = '0.1.1'
#简介
s.summary = 'A short description of testPod.'
# This description is used to generate tags and improve search results.
# * Think: What does it do? Why did you write it? What is the focus?
# * Try to keep it short, snappy and to the point.
# * Write the description between the DESC delimiters below.
# * Finally, don't worry about the indent, CocoaPods strips it!
s.description = "A test description of testPod.description should be logger than summary "
#主页,直接填项目的git地址就可以了
s.homepage = 'https://github.com/...'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
#开源协议 需要加对应的协议文件否则验证是会出现warning
s.license = {:type => "MIT"}
#作者
s.author = { 'zys' => '857785163@qq.com' }
#项目地址,添加项目的git地址,可以在后面添加tag号,commit号或者是否为子模块等内容
s.source = {
:git => 'https://github.com/dulaccc/SDLoginKit.git',
:tag => '1.0.2',
:submodules => true
}
#代码源文件所在目录,如果有多个目录下则用逗号分开
#“*” 表示匹配所有文件
#“*.{h,m}” 表示匹配所有以.h和.m结尾的文件
# “**” 表示匹配所有子目录
s.source_files = 'Library/*'
#支持的平台及版本
s.platform = :ios, '7.0'
s.ios.deployment_target = '8.0'
#资源文件地址
# s.resource = "TestPod/TestPod/Resource/test.plist"
#公开头文件地址
#s.public_header_files = 'TestPod/*.h'
#所需的framework,多个用逗号隔开
s.frameworks = 'UIKit','JavaScroptCore'
#子模块可以将模块中内容分开,可以依赖其他子模块
spec.subspec 'SDKit' do |sdkit|
sdkit.source_files = 'SDKit/**/*.{h,m}'
sdkit.resources = 'SDKit/**/Assets/*.png'
end
#依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
# s.dependency 'AFNetworking', '~> 2.3'
#s.dependency 'JSONKit'
end
提交podspec
编辑好后最好先确定 .podspec 是否有有效可以执行以下命令判断
pod spec lint podspec名字
pod lib lint podspec名字
这两种方法都可以验证,如果不加podspec名字就直接验证当前文件夹所有podspec。验证如果有error是无法提交podspec的
验证成功后使用以下命令
pod repo push [Repo名] [podspec 文件名字] --use-libraries --allow-warnings
提交 --allow-warnings 可以忽视warning内容,--use-libraries 表示使用静态库
命令行问题可以参考官网文档
常见问题
字符格式不对
s.version = “0.3.0”
^
使用文本编辑使得引号格式不对,需要使用vim进行编辑