iOS包依赖管理工具(一):CocoaPods了解篇

iOS包依赖管理工具(一):CocoaPods了解篇

IOS小彩虹2021-07-11 9:57:16110A+A-

iOS包依赖管理工具系列

iOS包依赖管理工具(一):CocoaPods了解篇

iOS包依赖管理工具(二):CocoaPods原理和知识

iOS包依赖管理工具(三):创建自己的 Pod 库

iOS包依赖管理工具(四):Swift Package Manager(SPM)了解篇

iOS包依赖管理工具(五):Swift Package Manager(SPM)自定义篇

iOS包依赖管理工具(六):CocoaPods VS SPM 总结篇

一、前言

1.1、CocoaPods是什么?

它是一个专为Xcode工程(项目)所需第三方包的一个包依赖管理工具!类似于Java的Maven、Android的JCenter、Node的npm、yarn,工作职责都是一样。

1.2、一定需要这个工具么?

理论上并不是必需的,但实际上却是必需的!特别是苹果开发者(因为都涉及到Xcode来开发)。

1.3、手动引入第三方开源库的步骤

  1. 将开源库源码复制到项目中;
  2. 添加依赖框架和动态库;
  3. 手动配置(编译阶段、连接器选项),设置ARC环境下的-ObjC,-fno-objc-arc等参数;
  4. 管理该库的版本更新;
  5. 若该库还涉及到其它第三方,请重复以上步骤;

1.4、CocoaPods的目的

CocoaPods旨在改善第三方开源Cocoa库的参与度和可发现性,这些项目目标影响并推动了CocoaPods的设计:

  • 创建和共享库,并在项目中使用它们,而无需为库作者创建额外的工作;
  • 集成非CocoaPods库,并使用简单的透明Podspec标准在任何CocoaPods库的自己的分支上进行破解;
  • 允许库作者按自己的喜好构建库;
  • 通过自动执行许多与其库功能无关的Xcode工作,为库作者节省时间;
  • 支持任何源代码管理工具(目前支持的是git, svn,mercurial,bazaar,和各类可通过HTTP下载);
  • 促进在Pod上进行分布式协作的文化,但也提供只有通过集中式解决方案才能培养社区的功能;
  • 在核心Cocoa开发系统之上构建工具,包括通常部署到其他操作系统(例如Web服务)的工具;
  • 提供有目的且自动的集成,但使其完全可选,您可以根据需要将CocoaPods依赖项手动集成到Xcode项目中,无论有无工作区;
  • 为Cocoa和Xcode开发人员解决日常问题;

1.5、CocoaPods给我们带来的好处

  • 该工具是开源的,在GitHub上可查;
  • 通过CocoaPods配置文件,可方便引入所需第三方开源库;
  • 第三方库版本管理简单,升级容易;
  • 方便查找第三方库(官网 or 命令行);
  • 一般的项目都是团队合作,团队成员只需安装该工具就能完成第三方库引入(无需每人都做1.3中的步骤);
  • 制作公共库,并发布至CocoaPods上,其他人可方便使用;

二、CocoaPods安装

CocoaPods是由Ruby开发的,因此,在macOS上安装需要安装Ruby。

在正式安装以下工具时,建议先保证 xcode、xcode-select 都安装OK!

  • xcode 可以通过 App Store来更新;
  • xcode-select 可以通过命令行来执行: $ xcode-select --install

2.1、HomeBrew

Homebrew是一款Mac OS平台下的软件包管理工具,拥有安装、卸载、更新、查看、搜索等很多实用的功能。简单的一条指令,就可以实现包管理,而不用你关心各种依赖和文件路径的情况,十分方便快捷。所以我们需要下载Homebrew来安装Ruby。

  • 安装HomeBrew
$ /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
  • 卸载HomeBrew
$ cd `brew --prefix`
$ rm -rf Cellar
$ brew prune
$ rm `git ls-files`
$ rm -r Library/Homebrew Library/Aliases Library/Formula Library/Contributions
$ rm -rf .git
$ rm -rf ~/Library/Caches/Homebrew
  • HomeBrew使用

查看Homebrew命令:brew help

安装任意包:brew install // eg:brew install node

卸载任意包:brew uninstall // eg:brew uninstall git

查询可用包:brew search

查询已安装包列表:brew list

查看任意包信息:brew info

更新Homebrew:brew update

Homebrew帮助信息:brew -h

查看brew版本:brew -v

更新brew版本:brew update

整理重复语句:open ~/.zshrc -e、open ~/.bash_profile -e

2.2、安装Ruby

macOS都自带Ruby,不过版本可能比较低。

$ sudo brew install ruby // 强烈建议升级ruby至最新

安装完成后,系统中就有了RubyGems这个东东,它是Ruby的高级包管理器(Sophisticated Package Manager)。Ruby还有另一个工具:RVM(Ruby Version Manager)。

// 查看Ruby源
$ gem source -l
*** CURRENT SOURCES ***
https://rubygems.org/

// 移除现有源
$ gem source --remove https://rubygems.org/

// 添加新源(国内Ruby镜像)
$ gem source -a https://gems.ruby-china.com/

2.3、安装CocoaPods

$ sudo gem install cocoapods
(
    如果报错 =====> 
    ERROR:  While executing gem ... (Gem::FilePermissionError)
        You don't have write permissions for the /usr/bin directory.

    改用如下命令:
    sudo gem install -n /usr/local/bin cocoapods
)

// 安装成功后,还需执行一条命令才大功告成
$ pod setup

// 有时 cocoapods 安装也会有问题
~/.cocoapods/repos 可能没有生成,所以我们只能手动:
$ mkdir -p ~/.cocoapods/repos
$ cd ~/.cocoapods/repos
$ git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
$ pod setup

三、创建Pod项目

3.1、查找第三方包“AFNetworking”

$ pod search AFNetworking

-> AFNetworking (4.0.1)
   A delightful networking framework for Apple platforms.
   pod 'AFNetworking', '~> 4.0.1'
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 4.0.1, 4.0.0, 3.2.1, 3.2.0, 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3, 3.0.0-beta.2, 
    3.0.0-beta.1, 2.7.0, 2.6.3,2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 2.5.2, 2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 
   2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0, 2.0.3,2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4, 
   1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2,1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 
   0.9.0, 0.7.0, 0.5.1 [trunk repo]
   - Subspecs:
     - AFNetworking/Serialization (4.0.1)
     - AFNetworking/Security (4.0.1)
     - AFNetworking/Reachability (4.0.1)
     - AFNetworking/NSURLSession (4.0.1)
     - AFNetworking/UIKit (4.0.1)
     
-> 其它版本

:
// control + z 退出即可

3.2、创建工程及Pod文件

// Xcode 创建工程 demo
// 在demo根目录下创建 Pod 文件
$ touch Podfile

3.3、配置第三方库(Podfile)

# Define a global platform for your project
platform :ios, '9.0'

# 官方仓库地址
source 'https://github.com/CocoaPods/Specs.git'

target 'demo' do
     # 开头4个空格
     # 可以指定版本号 pod 'AFNetworking', '~> 4.0.1'
    # 不指定版本号默认使用最新版本
    pod 'AFNetworking'
end

3.4、安装第三方库

查看安装前目录结构

$ ls -l
total 8
-rw-r--r--  1 chris  staff  312 12  7 16:04 Podfile
drwxr-xr-x  9 chris  staff  288 12  7 16:08 demo
drwxr-xr-x@ 5 chris  staff  160 12  7 16:08 demo.xcodeproj
  • 安装第三方依赖包
$ pod install
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (4.0.0)
Generating Pods project
Integrating client project

 [!] Please close any current Xcode sessions and use `demo.xcworkspace` for this 
 project from now on. Pod installation complete! There is 1 dependency from the 
Podfile and 1 total pod installed.
  • 查看安装后目录结构
$ ls -l
total 16
-rw-r--r--  1 chris  staff  312 12  7 16:04 Podfile
-rw-r--r--  1 chris  staff  798 12  7 16:11 Podfile.lock
drwxr-xr-x  8 chris  staff  256 12  7 16:11 Pods
drwxr-xr-x  9 chris  staff  288 12  7 16:08 demo
drwxr-xr-x@ 5 chris  staff  160 12  7 16:11 demo.xcodeproj
drwxr-xr-x  3 chris  staff   96 12  7 16:11 demo.xcworkspace

podproj.png

  • 双击“demo.xcworkspace”,就能看到Pod管理的工程

proj-struct.png

点击这里复制本文地址 以上内容由权冠洲的博客整理呈现,请务必在转载分享时注明本文地址!如对内容有疑问,请联系我们,谢谢!

支持Ctrl+Enter提交

联系我们| 本站介绍| 留言建议 | 交换友链 | 域名展示
本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除

权冠洲的博客 © All Rights Reserved.  Copyright quanguanzhou.top All Rights Reserved
苏公网安备 32030302000848号   苏ICP备20033101号-1

联系我们