【10】iOS开发·私有库的创建
一、创建本地私有库
1、项目目录中，新建文件夹Lib进入，然后执行pod lib create 库名，根据提示进行模板创建库；例：
pod lib create FXGBaseKit
2、第一步完成之后，会有个子工程，可在Classes文件夹中存放代码，Assets中存放图片资源等；
（注1：加载图片资源中，需要在XXX.podspec文件中配置，具体格式后面会贴上来；）
（注2：图片加载方式也不能再用[UIImage imageName:@""],需要指定bundle加载图片）
3、抽离代码，在原有项目工程中的Podfile文件中导入本地路径，例：
pod 'FXGBaseKit', :path => 'Lib/FXGBaseKit'
（注：新版的cocoapods需要在开头加上source路径）
新版Podfile格式范例：
use_frameworks!
platform :ios, '9.0'
source 'https://github.com/CocoaPods/Specs.git'
target 'XXX' do
pod 'FXGBaseKit', :path => 'Lib/FXGBaseKit(你的本地私有库路径)'
target 'XXX_Tests' do
inherit! :search_paths
end
end
备注：本地私有库的创建比较简单，此处不再过多叙述。
二、创建远程私有库
1、工程创建
pod lib create FXGBaseKits
2、新建远程仓库(GitHub/GitLab/coding等)
3、将远程索引库关联到本地
pod repo (查看本地已关联仓库源)
pod repo add 本地索引库名称 远程索引库仓库地址 (添加关联私有库)
pod repo update 索引库名称 (更新私有库)
pod repo remove 本地索引库名称 (移除私有库)
4、进入到本地项目工程FXGBaseKits中，关联远程仓库
git remote add origin 你的仓库地址
git add .
git commit -m "commit"
git push origin master 或者 git push -u origin master 【这个一般是第一次提交的时候】
5、修改XXX.podspec文件，简易的格式及名词解释(请勿直接复制)：【此处为注释】
Pod::Spec.new do |s|
s.name = 'FXGBaseKits'【库名】
s.version = '0.1.0' 【版本号】
s.summary = '' 【短描述】
s.description = <<-DESC
（此处需要填写）【详细的描述，需要比短描述长】
DESC
s.homepage = 'https://github.com/xxx' 【你仓库所在的网页网址，不是仓库地址】
s.license = { :type => 'MIT', :file => 'LICENSE' }【MIT许可证，一般不用动】
s.author = { 'xxx' => 'xxx' } 【作者名，默认会给你，一般也不需要动】
s.source = { :git => 'https://github.com/xxx.git', :tag => s.version.to_s } 【你仓库的Git地址】
s.ios.deployment_target = '9.0' 【系统版本号】
s.source_files = 'xxx/Classes/*' 【代码存放的路径，是相当于XXX.podspec的路径，一定要正确，否则会报错】
# s.resource_bundles = {
# 'XXX' => ['XXX/Assets/*.png'] 【这是图片资源的路径】
# }
# s.public_header_files = 'Pod/Classes/**/*.h' 【在这个属性中声明的.h文件能够使用<>方法联想调用】
# s.frameworks = 'UIKit', 'MapKit' 【依赖系统的动态库】
# s.vendored_framework = 'XXX.framework' 【依赖非系统的动态库，未验证】
# s.libraries = 'XXX.a' 【依赖系统的静态库】
# s.vendored_libraries = 'XXX.a' 【依赖非系统的静态库，例：libWeiboSDK.a】
s.dependency 'AFNetworking', '~> 4.0.1' 【依赖的pod库】
end
注：当有多级库的时候，可分解出多个子库，只需要将s.source_files = 'xxx/Classes/*'注释，在XXX.podspec添加以下代码：
s.subspec 'Category' do |c|【此处"||"中的字母不能写大写的，注意】
c.source_files = 'FXGBaseKit/Classes/Category/**/*'【子库的路径】
end
s.subspec 'General' do |g|
g.source_files = 'FXGBaseKit/Classes/General/**/*'【子库的路径】
end
s.subspec 'Utils' do |u|
u.source_files = 'FXGBaseKit/Classes/Utils/**/*'【子库的路径】
end
s.subspec 'Vendor' do |v|
v.source_files = 'FXGBaseKit/Classes/Vendor/**/*'【子库的路径】
end
6、验证XXX.podspec文件，终端执行：
pod lib lint XXX.podspec --allow-warnings【本地验证】
pod spec lint XXX.podspec --allow-warnings 【远程验证】
注 ①：若使用了静态库，需要在后面加 --use-libraries；
注 ②：当依赖了其他第三方库，需要在--allow-warnings 前面加上 --source='https://xxx.git【你的仓库地址】, https://github.com/CocoaPods/Specs.git'
7、当XXX.podspec验证通过后，给远程master分支添加tag
git tag 0.1.0 【添加本地tag】
git push --tags 【push到远程tag】
git tag -d 0.1.0 【删除本地tag】
git push origin :0.1.0 【删除远程tag】
git tag 【查看tag列表】
8、给master设置完tag之后，执行发布命令
pod repo push XXX XXX.podspec --allow-warnings
注 ①：若使用了静态库，需要在后面加 --use-libraries；
注 ②：当依赖了其他第三方库，需要在--allow-warnings 前面加上 --source='https://XXX.git【你的仓库地址】, https://github.com/CocoaPods/Specs.git'
9、发布完成之后，私有库便已经创建完毕，附上使用方法：
新建工程，编辑Podfile，编辑完毕后，pod install或者pod update；
注意：私有库需要指定git的写法，否则可能会install不成功，备注：当第一次使用的时候，需要先更新本地索引库；
pod repo update 【更新所有的索引库】
pod repo update xxx 【指定更新某个索引库】
指定git的写法
pod 'AFNetworking', :git => 'https://github.com/AFNetworking/AFNetworking.git'
pod 'AFNetworking', :git => 'https://github.com/AFNetworking/AFNetworking.git', :branch => 'dev'
pod 'AFNetworking', :git => 'https://github.com/AFNetworking/AFNetworking.git', :tag => '3.1.1'
pod 'AFNetworking', :git => 'https://github.com/AFNetworking/AFNetworking.git', :commit => '0f506b1c45'
指定podspec的写法
pod 'AFNetworking', :podspec => '~/Desktop/AFNetworking/AFNetworking.podspec'
指定subspecs的写法（这也是subspec的另一个用法）
pod 'MyThirdparty', '~> 0.0.1', :subspecs => ['Sparta', 'GotyeSDK', 'TalkingData', 'Tingyun', 'BaiduPanorama']
