建立CocoaPods私有源(1)
CocoaPods简介
CocoaPods是Swift和Objective-C 项目的依赖管理器。它拥有超过61000个第三方库,超过300万个应用程序都使用CocoaPods来管理第三方库。
CocoaPods使用
新建一个普通的xcode项目时,如果需要使用CocoaPods管理第三方库,需要新建一个Podfile文件,当你执行pod install
之后,CocoaPods 会生成一个名为Podfile.lock的文件,Podfile.lock 是Podfile文件序列化的文件,记录了各个第三方库的版本和和第三方库的依赖。
如果存在Podfile.lock文件,那么每次执行pod install
,都是从Podfile.lock文件来获取第三方库的版本,除非执行pod update
才会更新Podfile.lock文件。
CocoaPods 在执行 pod install 和 pod update 时,会更新一次 Specs 索引仓库。使用以下命令,强制不更新索引,
pod install --no-repo-update
pod update --no-repo-update
use_frameworks!
每次执行pod install时,CocoaPods 项目最终会编译成一个名为 libPods-XXX.a
的文件,主项目只需要依赖这个静态库便可。
如果在Podfile里面声明了use_frameworks!
,CocoaPods会生成framework方式的库(反之生成静态库.a),因为swift的项目需要使用framework方式导入第三方库。
- 不使用
use_frameworks!
-> static libraries 方式 -> 生成.a文件 -
use_frameworks!
-> dynamic frameworks 方式 -> 生成.framework文件
如果第三方库包含资源文件,CocoaPods 提供了一个名为 Pods-XXX-resources.sh
的 bash 脚本,该脚本在每次项目编译的时候都会执行,将第三方库的资源文件复制到主工程的目标目录中。
如果需要编辑第三方库的一些依赖和编译参数,可以修改相对应的第三方库的XXX.xcconfig
文件。
CocoaPods 管理第三方库
在电脑上安装CocoaPods后,可以在以下路径~/.cocoapods/repos/master/
看到CocoaPods相关的文件。简单来说,其实CocoaPods也是一个托管在GitHub上的一个普通的Git项目。在master目录下有一个Specs
文件夹,这个文件夹包含了CocoaPods所管理的所有第三方库的索引。
我们可以在Specs
文件夹找到被CocoaPods索引的所有第三方库的相关信息。
如AFNetworking的所有版本的索引文件
这个索引文件
AFNetworking.podspec.json
是一个普通的json文件,部分内容如下
{
"name": "AFNetworking",
"version": "3.2.1",
"license": "MIT",
"summary": "A delightful iOS and OS X networking framework.",
"homepage": "https://github.com/AFNetworking/AFNetworking",
"social_media_url": "https://twitter.com/AFNetworking",
"authors": {
"Mattt Thompson": "m@mattt.me"
},
"source": {
"git": "https://github.com/AFNetworking/AFNetworking.git",
"tag": "3.2.1",
"submodules": true
},
"requires_arc": true,
"public_header_files": "AFNetworking/AFNetworking.h",
"source_files": "AFNetworking/AFNetworking.h",
"prefix_header_contents": "#ifndef TARGET_OS_IOS\n #define TARGET_OS_IOS TARGET_OS_IPHONE\n#endif\n\n#ifndef TARGET_OS_WATCH\n #define TARGET_OS_WATCH 0\n#endif\n\n#ifndef TARGET_OS_TV\n #define TARGET_OS_TV 0\n#endif",
"platforms": {
"ios": "7.0",
"osx": "10.9",
"watchos": "2.0",
"tvos": "9.0"
},
发布在GitHub上的项目,如果想加入CocoaPods的索引库里面,需要在根目录添加一个.podspec
文件,此文件包含了此项目的版本信息,作者信息,依赖信息,资源路径等。
AFNetworking.podspec文件部分如下
Pod::Spec.new do |s|
s.name = 'AFNetworking'
s.version = '3.2.1'
s.license = 'MIT'
s.summary = 'A delightful iOS and OS X networking framework.'
s.homepage = 'https://github.com/AFNetworking/AFNetworking'
s.social_media_url = 'https://twitter.com/AFNetworking'
s.authors = { 'Mattt Thompson' => 'm@mattt.me' }
s.source = { :git => 'https://github.com/AFNetworking/AFNetworking.git', :tag => s.version, :submodules => true }
s.requires_arc = true
s.public_header_files = 'AFNetworking/AFNetworking.h'
s.source_files = 'AFNetworking/AFNetworking.h'
# 省略
CocoaPods的索引文件AFNetworking.podspec.json
和AFNetworking.podspec
很类似。其实两者是可以转换的,在项目的根目录下,执行以下命令便可。
$ pod ipc spec AFNetworking.podspec >> AFNetworking.podspec.json
对于一些没有写.podspec
文件的GitHub开源库,可以也可以在CocoaPods中导入,在Podfile文件中如下编写便可
直接导入
pod 'RNSVG', :git =>'[https://github.com/magicismight/react-native-svg.git](https://github.com/magicismight/react-native-svg.git)', :tag => '9.2.4'
一般导入
pod 'libwebp', '0.6.0'