美文网首页计算机语言工具文
CocoaPods私有库及本地资源github

CocoaPods私有库及本地资源github

作者: 凉风起君子意如何 | 来源:发表于2021-08-16 14:30 被阅读0次

    前言

    说句题外话,之前其实出于好奇照着网上资料 大概整过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?
    可以先看看该文章,待后续项目实例补充

    相关文章

      网友评论

        本文标题:CocoaPods私有库及本地资源github

        本文链接:https://www.haomeiwen.com/subject/mwvsbltx.html