iOS代码组件化（利用CocoaPods创建私有库）

Posted 2023-02-04 漂泊_

前言，最近因为工作需求，研究了一下代码组件化，中间遇到了很多问题，下面就把结合网上的一些文章和自己的实际操作，梳理一下操作流程，希望能帮到有需要的朋友，中间有需要改正的地方请指正。

一、远程索引库

什么是远程索引库？

每创建一个组件都会带有一个 xxx.podspec 的索引文件。专门用来存放这些索引文件的库就叫做索引库。我们需要将这些索引文件上传到远程索引库才能保证其他的同事能够拿来用。

创建远程索引库（ 注：这里是在github上创建了一个public的organization名字叫FFComponent），自己公司的项目创建private的私有索引库即可，私有索引的步骤和pubic的操作方式一样

远程索引库已经创建成功，可以看到远程索引库的地址

二、本地索引库 （本地索引库就是用来存放本地索引文件的库）

1. 打开终端 pod repo 查看一下当前有哪些本地索引库（如果你之前没有创建过，应该只有一个master）
   

2. 通过pod repo add <本地索引库的名字> <远程索引库的地址> ，创建本地索引库并和远程索引库做关联（注：本地索引库的名字建议和远程索引库起的名字一样）
   

3. 通过下面的方式可以查看本地索引库的物理地址，要先打开Mac的隐藏文件，终端输入命令为

   隐藏文件
   不显示
   defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder
   显示
   defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder

   然后通过finder文件->前往文件夹 /.cocoapods/repos/
   
   

三、远程代码库 （代码实际存放的远程仓库）

创建远程代码仓库（和创建远程索引库的方式一样），创建一个FFCategoryKit的远程代码库，用来存放FFCategory组件的代码。同样获取到FFCategoryKit组件的远程代码库地址。

四、本地代码库

创建FFCategoryKit组件的远程代码库以后，创建本地代码库

1. pod lib create <组件名> 创建本地代码组件模版库，组建名可以和远程代码库一致（根据自身需求对下面的提示信息做选择就好）
   
2. 编译运行通过看下效果。在Xcode彻底删除ReplaceMe.m文件，接着把自己封装好的组件化代码的文件夹拖入到组件FFCategoryKit的classes路径下。
   
3. 接着cd到Example下进行pod install （把刚才拖入到classes里的文件夹pod进来，这里会通过podfile里面默认的设置，自动把classes里的文件pod过去）
   

4. 编译组件看是否报错，编译通过后需要修改podspecs索引文件，一般需要修改下面几个问题。

   a. 修改版本号

   b. 修改项目的简单概述和详细描述

   c. 修改homepage和source地址

   d. 添加依赖库

修改前的状态如下图所示：

修改对应的地方即可

这个就是远程代码库的地址，修改以后如下：

5. 编译运行通过后，提交组件到远程代码库并打tag.

• git add .
• git commit -m “xxx”
• git remote add origin 远程代码仓库地址
• git push origin master 或者 git push -u origin master（一般第一次提交用）
• git tag 版本号/git tag -a 版本号 -m “version 版本号”（注：这里的版本号必须和podspec里写的版本号一致）
• git tag 查看版本号是否提交成功
• git push - -tags

6.通过pod spec lint - -allow-warnings 命令验证podspec索引文件(注：pod lib lint是检索本地索引文件，pod spec lint 是本地和远程库同时检索)

7.验证通过后，pod repo push <本地索引库> <索引文件名> - -allow-warnings 提交索引文件到远程索引库。

本地也可以查看已成功

8. 接下来回到FlowerField_Component工程（这是一个demo工程）修改podfile文件,把FFCategoryKit组件pod进来（注：需要在Podfile中指定组件远程索引库地址，如果不指定默认会从master的索引库查找就会报找不到组件）

执行pod install

同样在项目查看已经pod进来了。

五、遇到的一些错误

1.私有库依赖私有库or公有库

在s.dependency添加依赖库

这里在检索的时候会遇到这个问题,校验podspec文件时会到远程podspec库查找相关依赖，默认只会到官方specs库校验，此时需要指定远程specs库去校验。（https:// github.com /FFComment /FFSpecs这个远程私有库地址不需要添加.git,我试了网上的添加还是会报错）

   pod spec lint 文件名.podspec --sources='https://github.com/FFComment/FFSpecs,https://github.com/CocoaPods/Specs.git' --allow-warnings