概述
一般来说,我们如果要在工程里面添加其他工程的代码,都是copy一份过来。手动copy比较麻烦,且容易出错,如果是.a库,还需配置路径等。遇到多个工程都需要的时候,更加浪费劳动力。下面介绍如何用cocoapods来管理本地代码,使用方法跟第三方pod的类似。
实践
1、这里我们新建一个工程ManageLocalCode,如下图。当然你也可以使用你已经存在的工程。
2、新建类Test。添加test方法。这样我们暴露了一个test接口。
3、在工程根目录下,新建podspec文件ManageLocalCode.podspec。
可以通过命令pod spec create ManageLocalCode,这样生成的spec文件各个条目都有,比较繁多,可以选自己所需要的填写。最终精简如下。
Pod::Spec.new do |s|
s.name = "ManageLocalCode"
s.version = "0.0.1"
s.summary = "ManageLocalCode desc"
s.homepage = "https://github.com/silan-liu"
s.license = { type: 'MIT', file: 'LICENSE' }
s.author = { "summer-liu" => "413769707@qq.com" }
s.platform = :ios, "8.0"
s.source = { :git => "~/Documents/code/mycode/ManageLocalCode" }
s.source_files = "ManageLocalCode/Test.{h,m}"
s.requires_arc = true
end
s.version是pod版本号。
s.source是工程地址。可以是本地路径,svn,zip包,或者是git上的代码。只是写法不一样。
// 本地文件
s.source = { :git => '~/Desktop/ChartboostSDK' }
// git
s.source = { :git => 'https://github.com/silan-liu/RGB.git' }
// zip
s.source = {:http=> 'http://xxx.zip', :tag => "1.0.0" }
// svn
s.source = {:svn=> 'http://path', :tag => "1.0.0" }
s.source_files是暴露的源码。
s.requires_arc表示arc工程。
s.dependency表示所依赖的库。 如s.dependency "JSONKit", "~> 1.4"。
s.preserve_paths表示需要保留的文件路径。
s.vendored_libraries表示对外提供的.a。在打成.a库时有用。
然后输入命令pod lib lint进行验证,验证通过后进行下一步。
4、另外新建一个工程TestDemo,来引入ManageLocalCode的代码。并新建podfile。
target 'TestDemo' do
pod 'ManageLocalCode', :path => '~/Documents/code/mycode/ManageLocalCode'
// 或者这样写
//pod 'ManageLocalCode', :podspec => '~/Documents/code/mycode/ManageLocalCode/ManageLocalCode.podspec'
end
path是podspec的本地路径
pod install。pod成功之后,在Development pods可以看到我们的代码。
5、添加测试代码。
查看console输出"aaa"。
创建私有pod
假如有同事需要使用你的代码,那么本地代码的方式就不太友好了。可以将代码托管到git,创建私有podspec,其他人只需要用git上的podspec就可以了。
1、将本地代码托管到git。具体步骤略过。可以参考代码托管到git
2、创建tag。
git tag -m "tag" "0.0.1"
git push --tags
3、在git上面创建spec repo。我创建的地址是http://github.com/silan-liu/Spec.git.
4、pod repo add MySpec http://github.com/silan-liu/Spec.git。
将spec repo clone到本地。在~/.cocoapods/repos会看到MySpec。
5、将之前我们创建的ManageLocalCode.spec的s.source改成git地址。
s.source = { :git => "https://github.com/silan-liu/ManageLocalCode.git", :tag => s.version }
cd到ManageLocalCode.podspec的目录
pod repo push MySpec ManageLocalCode.podspec,将podspec提交到MySpec。同时我们的git spec上面也会有更新。
成功验证如下:
6、在测试工程中,podfile修改如下:
source "http://github.com/silan-liu/Spec.git" 这句必须。告知到哪里去找podspec文件。
source "http://github.com/silan-liu/Spec.git"
platform :ios, '8.0'
target 'TestDemo' do
pod 'ManageLocalCode', '0.0.1'
end
再次pod install。pod成功后,可看到在Pods下面,而不是在Developments Pods文件夹下。Run。成功输出"aaa"。
更改版本号
1、对于本地代码,将podspec的s.version修改即可。
2、对于git上的私有pod,同样需要将podspec的s.version修改,然后push,pod repo push MySpec ManageLocalCode.podspec。最后打对应的tag。
参考:
使用Cocoapods创建私有podspec
CocoaPods进阶:本地包管理
==========
续:后面会写
cocoapods管理.a,.framwork库
《cocoapods模块化管理工程》