cocoaPods构建私有库

以前在有道云整理的笔记，分享出来，有问题望大家指正，来从零开始构建一个私有库，分解为四步：

1. 创建远程私有索引库（基于码云）

• 在码云上创建私有库仓库

// 私有库地址
https://gitee.com/enlake/library
// git地址
https://gitee.com/enlake/library.git
// ssh
[email protected]: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
[email protected]: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