CocoaPods私有库及本地资源github

前言

说句题外话，之前其实出于好奇照着网上资料 大概整过pod私有库，但理解不深，也就没什么印象。然而昨天下午看到用 CocoaPods 私有库提高团队的整体效率这篇文章时，具体说应该是这个题头的时候，心里稍稍有点触动。再好的工具都是为了提高效率，不管开发效率还是团队协作效率。
最近因为公司项目空隙期，一直处在各种知识探究中，例如学习Flutter，Swift等等，陆陆续续接触到它们一些优秀的知识点及框架，发现很多有趣又好用的工具。例如Flutter里面Getx框架，简单好用的状态和路由管理，swift里简洁灵活的转model HandyJson协议，以及swift里面向协议分类清晰的Moya网络请求框架等等。

关于pod私有库开发搭建，感觉理解点有三：

1. 本身承载功能的lib库开发及推送到远程库
2. 元信息库创建制作及推送到远程私有仓库
3. podspec文件 支持lib库的相关文件，资源文件、源文件以及依赖库或者文件

正题

使用Pod私有库主要分为以下几步

1. 创建Pod私有库

例如现在我们要开发个DeviceHelper私有库，用来封装跟操作设备相关的一些功能，我们就可以用如下命令来创建私有库

pod lib create DeviceHelper

终端执行以上命令之后，会让你输入各种选项，按照提示一步一步选择即可，完成之后系统会自动打开Xcode项目，如下目录结构：

pod lib create 会为我们创建一个 Workspace，里面包含两个 Project， DeviceHelper 是我们 Pod 库的 Demo 项目, Pods 是我们实际开发的库的代码。

我们可以修改 Pods/Development Pods/DeviceHelper/ReplaceMe.swift 这个文件，首先将它重命名为 DeviceHelper.swift, 然后写入自己的开发代码,这里简单写下iPhone X判断代码：

import UIKit

public class DeviceHelper  {
    public class func isPhoneX() -> Bool {
        if UIDevice().userInterfaceIdiom == .phone {
            if UIScreen.main.nativeBounds.height == 2436 {
                return true
            }
        }
        return false
    }
}

注意 public 和class的使用。
开始func没用public修饰，运行demo项目的时候 会发现找不到该方法；
开始func用static修饰，新建项目集成该私有库的时候，会出现也未找到该方法；
综上 权限开放和static/class使用需注意使用

编辑Demo里ViewController.swift

import UIKit
import DeviceHelper

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        
        print(DeviceHelper.isPhoneX())
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }

}

这里面直接把 DeviceHelper 的调用结果输出到命令行中。 我们直接运行 Demo 工程就可以看到结果。至此，DeviceHelper私有库的开发调试就完成了

---

2. 发布私有库

2.1 准备发布
提交私有库工程 到github仓库。

a、在github上新建DeviceHelper仓库
b、执行如下命令将本地相关代码提交到远程仓库

cd  "刚创建的lib库根目录"
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/git账号/DeviceHelper.git
git push -u origin main

创建空仓库后，git给出的提示命令

2.2 打tag发布私有库
为刚才的提交打上tag
选择直接在github网页上创建tag，步骤为 release -> 创建tag （待截图）；
git命令方式打tag；

git tag  tagName
git push origin tagName

3. 验证podSpec文件

在Pod库项目根目录中执行如下命令

pod spec lint  --allow-warnings

若是swift语言开发，在spec文件里须添加如下设置：

s.swift_version = '5.0'

以上命令成功执行的话，会提示 DeviceHelper.podspec valid successfully.

4. 创建元信息库

4.1 创建放置原信息库的远程仓库

4.2 添加本地仓库，并上传podspec元文件
仓库创建好之后，使用这条命令将远程仓库添加到 CocoaPods 本地的仓库列表中：

 pod repo add 本地仓库名称(例如chxR) https://github.com/git账户/PodSpecs

执行pod repo list命令查看本地仓库列表

pod repo list

本地仓库设置好之后， 我们还需要将我们刚刚创建的 DeviceHelper Pod 库的 podspec 元信息文件推送进来，还是在 Pod 库工程的根目录运行：

pod repo push chxR DeviceHelper.podspec

pod repo push 这条命令做的就是将我们创建的 Pod 库的元信息，推送到我们自己的私有元信息库中，而不是公共的 master 库。 这样就保证了这些组件只有我们自己有权限的人才能访问。

推送成功后，命令行中会显示如下提示：

此时回回到github网页也能查看到相应的信息，如4.1截图所示

注意
执行 pod repo push chxR DeviceHelper.podspec命令之后，出现如下错误

解决过程：
执行pod repo list命令之后，发现本地仓库type为unknown，网上查阅说是空仓库 没有任何分支导致，手动在github添加lib文件之后，默认会有main分支。此时再执行pod repo push命令发现还是出以上问题；网上各种查阅都没有很好的解决方法，最终细看错误提示发现点端倪，貌似提示远程没有master这个分支 导致合并失败。回到本地仓库路径 查看具体的configuration，如截图将master修改成main

如上修改 再次执行 pod repo push chxR DeviceHelper.podspec命令，成功！

5. 使用私有库

最后，我们来看看其他项目如何引用这个私有 Pod， 我们随意创建一个工程， 然后在它的根目录中用 pod init 命令初始化一个 Podfile，并且做一些修改：

source "https://github.com/替换成你自己的github账号/PodSpecs"

platform :ios, '9.0'

target 'TestDemo' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for TestDemo
  pod 'DeviceHelper'

end

可以发现，除了第一句的source指定私有源外，其他与pod集成无区别，至此再执行pod install命令成功之后，新项目引用即可。

6. CocoaPods私有库更新

6.1 lib库开发更新后，push到远程仓库
6.2 如下命令打提交tag

git tag tagName   // 例如： git tag 0.1.1
git push origin 0.1.1 

6.3 修改原信息文件DeviceHelper.podspec里s.version版本，与刚才更新tag保持一致
6.4 提交元信息文件DeviceHelper.podspec到远程仓库

---

问题
1、safri 访问localhost 提示mac无法找到服务器"localhost" 或 Chrome访问提示localhost拒绝访问
问题出现过程：
打开佛跳墙应用发现localhost无法访问。百度查询各种方法有改hosts的，有改hosts文件后缀的，有让取消网络代理和防火墙的等，尝试各种都没起作用，最后如下方法解决：

如果文件配置正确
那么 删除 /private/var/log/下的apache2文件夹
然后在终端输入 sudo mkdir /private/var/log/apache2
重启apache (如下命令，都未成功执行，但localhost问题已解决)
sudo apachectl -k start 启动
sudo apachectl -k stop 停止
sudo apachectl -k restart 重启

另打开活动监视器，强制退出佛跳墙 （可能这个才是重点）

2、遗留问题：访问github网页须翻墙，但终端访问git相关 不能翻墙，为何？
3、遗留问题：在github网页上手动添加文件 默认新建的是main分支，此时若再用命令提交podspec文件，发现git上会默认多出master分支。此种现象可能还是git的遗留问题。具体看这个GitHub 将使用 “main”替换掉 “master”等术语。所以现在一般在提交代码到远程仓库之前，会执行git branch -M main 将当前分支重命名为main分支
4、待更新后续的复杂私有库开发

参考

该文章主要参考
用 CocoaPods 私有库提高团队的整体效率文章，很多地方也复制自该文章。
因为参考该文章搭建的过程中 遇到几个奇葩的问题，还有自己的一些理解，就有了这篇文章总结。感谢网友的无私分享！

Git中tag标签的使用

另：命令行上传github提示授权失败，需更新github access token

这里面的 -u指什么意思？
去掉-u 继续执行，输入用户名和access token即可

push的过程中另外一个错误

解决：
执行git pull --rebase origin main命令后，再执行git push origin main
需要开启佛跳墙代理。

问题重现
每次提交本地资源到github时，执行如下命令之后都会出现如上错误

git init
git add ./
git commit -m "first commit"
git branch  (查看当前分支)
git branch -M main  (重命名分支 github之前远程手动创建之后是master，现在改成默认main)
git remote add origin 你的远程仓库地址   （添加远程仓库源）
git push origin main   (提交到远程仓库)

以下下就是报错了

今天来研究下rebase到底是干嘛用的，为什么要rebase？
可以先看看该文章，待后续项目实例补充