在篇教程基于你对CocoaPods 和 iOS 开发有了一个基础的了解。
Setp1.创建一个git仓库
你需要为你的private Pod创建两个git 仓库。一个为Pod创建的,另外一个作为你的Podspec仓库。Podspec是你priavte pod保存信息的地方。为了添加private Podspec到你本地的CocoaPods中,运行下面的命令:
pod repo add [REPO_NAME] [SOURCE_URL]
你将会用[REPO_NAME]
这个名字来引用Podspec仓库。[SOURCE_URL]
是你仓库的git地址。如果上述操作顺利,你将会看到一个目录在你机器的~/.cocoapods/repos
目录下,目录名字是你仓库的名字。
Setp2.用pod lib create
创建你的Pod
CocoaPods有一个很nice的功能帮助你建立自己的Pod Project。里面还包括了test app和testing framework。运行下面命令即可:
pod lib create [POD_NAME]
Setp3. 编辑.podsepc
文件
一个Podspec或者Spec,描述了一个Pod library的版本。它包含了很多细节。包括source file的地址,build setting的设置,依赖frameworks等,和一些其他的metadata,比如,名称、版本、描述。下面是一个Grio's的private pod的Podspec文件:
Pod::Spec.new do |s|
s.name = "GrioCommon"
s.version = "1.1.7"
s.summary = "Common functions for Grio iOS apps"
s.description = <<-DESC
Common functions for Grio iOS apps. functionality includes:
* Universal User Settings
* Localytics libraries and support files
DESC
s.homepage = "[https://github.com/Grio/GrioCommoniOS](https://github.com/Grio/GrioCommoniOS)"
s.license = 'MIT'
s.author = { "Doug Kadlecek" => "[email protected]" }
s.source = { :git => "[https://github.com/Grio/GrioCommoniOS.git](https://github.com/Grio/GrioCommoniOS.git)", :tag => s.version.to_s }
s.platform = :ios, '7.0'
s.requires_arc = true
s.source_files = 'Pod/Classes/*.{h,m}'
s.resource_bundles = {
'GrioCommon' => ['Pod/Assets/*.*']
}
s.frameworks = 'UIKit'
s.dependency 'AFNetworking', '~> 2.4.1'
s.subspec 'Analytics' do |as|
as.source_files = 'Pod/Classes/Analytics/*.{h,m}', 'Pod/Classes/*.{h,m}'
as.dependency 'Localytics-iOS-Client', '~> 2.71.0'
end
s.subspec 'UserSettings' do |us|
us.source_files = 'Pod/Classes/UserSettings/*. {h,m}'
end
end
用Subspecs来组织Pod的功能和代码,是一个很棒的办法。注意,因为CocoaPods自动为你的Pod创建Xcode Project,你必须要使用目录而不是XCode来组织你的source 文件,注意下面的命令:
s.resource_blundles = {
'GrioCommon' => ['Pod/Assets/*.*']
}
这里创建了一个source bundle,名为GrioCommon
,被放在Pod/Assets
目录下面。
这些资源能从Pod里面访问到。
NSBundle *bundle = [NSBundle bundleWithPath:[[NSBundle mainBundle]
pathForResource:@"GrioCommon" ofType:@"bundle"]];
NSString *filePath = [bundle pathForResource:@"grio-user-settings" ofType:@"js"];
NSData *fileData = [NSData dataWithContentsOfFile:filePath];
你能够利用resource bundle里的资源访问任何你需要的非编码的文件。
在Podspec文件中还有很多其他选项。你可以在CocoPods的官方地址中查看。
Setp4.Push your repo
现在你已经建立并且测试了你的Pod(测试你的Pod,这一点很重要,本人在这里折腾了很久),是时候部署你的Private Podsepc 仓库了。
第一步为你的Pod的git仓库打上标签(版本号)
git tag '1.1.7'
git push --tags
tag要和你的.Podspec 仓库的版本号一样。一旦你把tag,push到Pod仓库,你就可以使用下面的命令了
pod repo push [REPO_NAME] [POD_NAME].podspec
把你的library,push到已经命名的private Podspec仓库里吗。如果你想要你团队的其他成员能够访问并且使用你创建的private pod。你必须要把他们加为你的library的developer。
我们团队使用的是GitLab来托管项目的,地址在我们自己的服务器上面。
或者,把私有仓库添加到他们机器上的
~/.cocoapods/repos
目录下。
pod repo add [REPO_NAME] [SOURCE_URL]
Congratulations!你已经发布了你的第一个Private Pod。你可以更简单的享受重用code的乐趣了,在你的iOS project之间。
参考文档如下
原文地址
官方Private Pod教程
在github上创建你自己的Public Pod