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?
可以先看看该文章,待后续项目实例补充

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,026评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,655评论 1 296
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,726评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,204评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,558评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,731评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,944评论 2 314
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,698评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,438评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,633评论 2 247
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,125评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,444评论 3 255
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,137评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,103评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,888评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,772评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,669评论 2 271

推荐阅读更多精彩内容