以前在有道云整理的笔记,分享出来,有问题望大家指正,来从零开始构建一个私有库,分解为四步:
1. 创建远程私有索引库(基于码云)
- 在码云上创建私有库仓库
// 私有库地址
https://gitee.com/enlake/library
// git地址
https://gitee.com/enlake/library.git
// ssh
git@gitee.com:enlake/library.git
- 初始化,将远程私有库关联到本地
cd /Users/liqun/.cocoapods/repos
liqun@liqundeMacBook-Pro repos % pod repo add MyLib https://gitee.com/enlake/library.git
- 查询之前创建好的私有库
liqun@liqundeMacBook-Pro LQCommon % pod repo list
MyLib
- Type: git (unknown)
- URL: https://gitee.com/enlake/library.git
- Path: /Users/liqun/.cocoapods/repos/MyLib
- 下载克隆到本地
/Users/liqun/Desktop/gitee项目/Library
2. 创建私有库demo仓库(码云)
- 再创建一个demo仓库
// 私有库demo地址
https://gitee.com/enlake/lib-demo
// git地址
https://gitee.com/enlake/lib-demo.git
// ssh
git@gitee.com:enlake/lib-demo.git
- 初始化,下载克隆到本地
liqun@liqundeMacBook-Pro ~ % cd /Users/liqun/Desktop/gitee项目/Lib-Demo
接下来创建私有库
//Cloning https://github.com/CocoaPods/pod-template.git into ProjectName.
//创建一个和指定的项目名相同的文件夹,然后将pod-template克隆下拉
//Configuring TemplateDemo template
//对当前项目进行配置
//pod-template是cocoapods官方提供的一个模板,主要模板是否下载成功,报错看文末备注1,报错就多试几次。
//这段指令的解读可以看文末备注2
liqun@liqundeMacBook-Pro Lib-Demo % pod lib create LQCommon
创建成功后,会得到一个空项目,
使用完整的库代码替换
/Users/liqun/Desktop/gitee项目/Lib-Demo/LQCommon/LQCommon/Classes/ReplaceMe.m
在/Users/liqun/Desktop/gitee项目/Lib-Demo/LQCommon/Example,执行pod install,podfile内容见备注2。
liqun@liqundeMacBook-Pro LQCommon % cd Example
liqun@liqundeMacBook-Pro Example % pod install
3. 上传至远程库
- 私有库拉一个的标号为0.1.0的版本。
liqun@liqundeMacBook-Pro LQCommon % cd /Users/liqun/Desktop/gitee项目/Lib-Demo/LQCommon
liqun@liqundeMacBook-Pro LQCommon % git remote add origin https://gitee.com/enlake/lqcommon.git
liqun@liqundeMacBook-Pro LQCommon % git status
// 无有改动跳过添加、提交
liqun@liqundeMacBook-Pro LQCommon % git add .
liqun@liqundeMacBook-Pro LQCommon % git commit -m 'common-lib'
// 如果有冲突,将冲突改掉,标记解决,再次提交
liqun@liqundeMacBook-Pro LQCommon % git pull --rebase origin master
liqun@liqundeMacBook-Pro LQCommon % git rebase --continue
liqun@liqundeMacBook-Pro LQCommon % git tag 0.1.0
liqun@liqundeMacBook-Pro LQCommon % git push --tags
// 如果原来存在标签,需要删除标签,再添加推送。
// 删除本地tag
liqun@liqundeMacBook-Pro LQCommon % git tag -d 0.1.0
// 删除远端tag
liqun@liqundeMacBook-Pro LQCommon % git push origin :refs/tags/0.1.0
- 修改文件LQCommon.podspec
// 私有库对外公开的头文件,没有这行的话默认所有文件都是公开的
# s.public_header_files = 'Pod/Classes/**/*.h'
- s.public_header_files与s.source_files说明
s.source_files 配置三方库的源文件(.h或.m文件),swift是配置.swift文件
写法:
OC:s.source_files = "Classes/**/*.{h,m}"#Classes路径下的所有匹配文件
s.source_files = "Classes/*.{h,m}"#Classes文件夹下的所有匹配文件
s.source_files = “Classes/PageController.{h,m}"#直接指定文件名
Swift:s.source_files = "Classes/**/*.{swift}"#Classes路径下的所有匹配文件
s.source_files = "Classes/*.{swift}"#Classes文件夹下的所有匹配文件
s.source_files = “Classes/PageController.{swift}"#直接指定文件名
public_header_files头文件
s.public_header_files = "Classes/**/*.h"#Classes路径下所匹配的.h文件
s.public_header_files = "Classes/*.h"
s.public_header_files = "Classes/Public.h"
// 从本地和远程验证pod能否验证通过
liqun@liqundeMacBook-Pro LQCommon % pod spec lint --allow-warnings
// 允许警告,用来解决由于代码中存在警告导致不能通过校验的问题
liqun@liqundeMacBook-Pro LQCommon % pod lib lint --allow-warnings
4. 关联LQCommon.podspec和MyLib
liqun@liqundeMacBook-Pro LQCommon % pod repo push MyLib LQCommon.podspec --verbose --allow-warnings
-> LQCommon (0.1.0)
包含创建App基础代码,包括了常用宏定义,还包含了公共方法:颜色、日期、图片、对象、字符串、系统等。
liqun@liqundeMacBook-Pro LQCommon % pod search LQCommon
pod 'LQCommon', '~> 0.1.0'
- Homepage: https://gitee.com/enlake/lqcommon
- Source: https://gitee.com/enlake/lqcommon.git
- Versions: 0.1.0 [MyLib repo]
如果提示:[!] The EQXActivityView.podspec specification does not validate.
pod repo push MyLib LQCommon.podspec --verbose --allow-warnings --use-libraries --skip-import-validation
备注1:
- 我们去自己的码云或者gitlab上边上传下载好的模版,下载地址: https://github.com/CocoaPods/pod-template.git
- 上传到自己的仓库中:https://gitee.com/enlake/pod-template.git,以后使用。
备注2:
我们需要先知道下边代码的含义:(失败尽量多试几次,或者过段时间使用,GitHub经常访问失败)
pod lib create ObjcName
实际上等同于:
pod lib create ProjectName --template-url=https://github.com/CocoaPods/pod-template.git
备注3:
//注意平台版本
use_frameworks!
platform :ios, '10.0'
target 'LQCommon_Tests' do
pod 'LQCommon', :path => '../'
end