[TOC]

如何使用CocoaPods创建静态库

1 创建workspace

1. 首先准备了一个新的iOS工程PodDemo,可以使用现有的工程。如果已经使用cocoapods或有workspace可以跳过这一步。

   
   
   proj.png

2. 找到工程的根目录（PodDemo.xcodeproj），这了可以直接右键 「Show in Finder」。
   

   show.png

3. 打开终端，切换到工程的根目录，创建 Podfile文件。这里可以使用终端命令Pod init。
   

   podinit.png

4. 使用终端命令pod install创建workspace文件。
   

   podinstall1.png
   
   
   podinstall2.png

5. 关闭原来的工程（PodDemo.xcodeproj）。使用PodDemo.xcworkspace重新打开之前的工程，工程中会多出一个Pods。
   

   proj2.png

2 增加静态库

1. 现在根目录创建一个Frameworks文件夹对我们的静态库进行统一管理。

   frams.png

2. 新建文件夹Crazs1,并在其中创建必要的LICENSE文件和.podspec文件,最终文件结构如下。Crazs1就是静态库根目录了，Core主要存放我们的代码

   spec1.png
   
   
   spec2.png

   [图片上传中...(spec3.png-afe0c-1656947312562-0)]

3. 修改Crass.podspec文件内容，删除无用信息。关于podspec文件修改和参数意义，可以查看文件中的注释或者从Cocoapods官网获取帮助。需要注意的是，spec.source_files以静态库根目录为准。
   [图片上传中...(podfile1.png-baa6a7-1656947338446-0)]

spec3.png

4. 回到我们的工程中， 打开PodFile文件，并在文件中添加我们静态库。Cocoapos如果使用本地的库，需要指定库相对工程根目录的路径（在这是Frameworks/Crazs1）。
   

   podfile1.png

5. 回到终端操作。cd至工程根目录,执行pod install，如果一切顺利，稍作等待之后，就可以在工程中看到我们刚刚创建的静态库了。备注：后续所有的`pod install命令都是在工程本目录执行，不再特殊说明目录。
   

   podinstall3.png

这里提示我们有两个错误，source设置错误和描述错误。打开我们的Crazs1.podspec文件，对错误内容进行修改。

podinstall4.png

修改完毕后重新执行pod install。稍作等待之后，导入库完成。工程中也能看到我们的静态库。

spec4.png

podinstall5.png

3 静态库开发

如果是使用第三方已经打包好的静态库，可以跳过

1. 选中Crazs1，右键新增文件。注意文件添加位置的选择的Targets。

add2.png

2. 在新增的类中添加自己的功能代码。

3. 在工程中需要使用的地方，导入头文件。如果提示"file not found"，请排查下列事项。

   1. 终端执行pod install命令，刷新工程目录，看工程中是否有相应文件。

   2. podspec文件是否有特殊说明。如exclude_files。

      add3.png

3. podspec文件是否指定了public_header_files但并没有包含目标文件。

   add4.png

4. podspec修改之后是否执行pod install。

如何将静态库上传至自己的仓库

1 创建仓库

1. 在Git平台创建一个仓库作为我们的源。例如https://github.com/Crazs/CocoaPods-Repo.git

2. 在本地添加源。

   pod repo add CrazsRepo https://github.com/Crazs/CocoaPods-Repo.git
   

repoadd.png

或者直接使用命令查看本地的repo list

pod repo list

repoadd2.png

3. 在Git平台上创建另外一个仓库，用来存放我们的代码。例如https://github.com/Crazs/CocoaPods-libCrazs.git

4. 克隆仓库到本地。建议创建一个单独的目录来对代码仓库进行管理。

5. 将本地的静态库拷贝至仓库的根目录下，推送代码至远端仓库。tag也要同时创建和推送。

   gitp1.png

gitp2.png

完成之后，远端仓库页面如下。

gitp3.png

2 推送静态库

1. 终端切换至静态库根目录,执行命令：

   // 当前目录下只有一个podspec文件
   pod repo push CrazsRepo
   // 指定podspec进行推送
   pod repo push [repo] NAME.podspec
   

   • CrazsRepo是本地的源，参考（2. 在本地添加源。）

   Cocoapods会自动执行Git脚本，将相应的.podspec文件推送到源仓库，commit信息也采用统一模版。远端的仓库如下：

   gitp4.png

.
├── Specs
    └── [SPEC_NAME]
        └── [VERSION]
            └── [SPEC_NAME].podspec

其中Crazs1是静态库的名字，0.0.1是静态库的版本，[Add] Crazs1(0.0.1)表示新增库。

2. pod search会创建索引（trunk源的静态库巨多，执行起来会很耗时，可以跳过这一步）。

   repouse1.png

3. 在工程中的Podfile中，添加「source」就可以使用刚刚创建的Crazs1了。

   repouse2.png
   repouse3.png

工程中的Crazs1会从Frameworks移动到Pods下。

repouse4.png

3 更新静态库

1. 更新我们代码库中的文件，并同步更新podspec文件。注意：更新的是本地clone下来的Git仓库中的内容，不是工程中的内容。

2. Git推送到远端仓库，同时推送tag。

   repoup1.png

3. 推送到远端CrazsRepo源。

   pod repo push CrazsRepo Crazs1.podspec --allow-warnings
   

4. 更新本地的CrazsRepo源。

   pod repo update CrazsRepo
   

   <img src="img/repoup2.png" style="width:80%" align="left">

5. 终端跳转至工程本目录下，执行更新命令。

   pod update Crazs1
   

   repoup3.png

4 推送问题排查

1. Your configuration specifies to merge with the ref 'refs/heads/master'

   from the remote, but no such ref was fetched.

   • 新创建的源仓库没有分支，pod不知道向哪个分支进行推送。可以手动创建一个readme.md文件，然后推送到远端的master分支。项目的路径可以使用命令pod repo list查询。

2. The Crazs1.podspec specification does not validate.

   • spec文件内容不规范，包含warn级别的信息。可以按照提示修改相应的地方，或者命令后增加--allow-warnings,整体为

     pod repo push CrazsRepo --allow-warnings
     

5 补充

1. 源仓库也是一个Git仓库。你甚至模仿CocoaPods的操作来手动创建一个静态库。在源仓库地址下拷贝Crazs1文件夹重命名为Crazs2,并修改Crazs2.podspec中的「name」。

   gitp5.png

手动push之后，可以在远端看到新的静态库。他可以被搜索到，也可以在工程中使用。

repouse5.png

repouse6.png

虽然两个静态库都是使用同一个仓库，并且远端仓库中只存在Crazs1.podspec文件，但真正起作用的是源仓库CrazsRepo中的podspec文件。