iOS组件化(一)----- 创建私有组件库(在码云上操作)
组件化系列传送门
iOS组件化(一)----- 创建私有组件库(在码云上操作)
iOS组件化(二)----- 组件的更新
iOS组件化(三)----- 加载图片等资源文件
一、远程私有索引库创建(Spec)
A、创建远程私有索引库MyTestSpec
(和创建远程工程一样),复制仓库地址(点击克隆/下载)
码云上MyTestSpec
B、打开终端,将远程私有库关联到本地
cd /Users/hf/.cocoapods/repos
pod repo add MyTestSpec https://gitee.com/CuteHf/MyTestSpec.git
https://gitee.com/CuteHf/MyTestSpec.git
为上面点击克隆/下载 复制的链接
这个时候/Users/hf/.cocoapods/repos
目录下面多了个MyTestSpec
目录
二、私有代码仓库
A、本地私有代码库
# cd到指定的目录,这个MyTest是自己创建的一个文件目录
cd /Users/hf/MyTest
# 这里的HFMyTest代表想要封装的组件名称, 这个根据自己的需求而定
pod lib create HFMyTest
1. 在输入之后会有一些对组件工程的设置,具体如下:
What platform do you want to use?? [ iOS / macOS ]
>iOS
//开发语言设置,根据自己而定,这里为ObjC
What language do you want to use?? [ Swift / ObjC ]
>ObjC
//是否需要创建一个demo用来测试你的组件,这里选择Yes,是为了之后对写好的组件进行测试
Would you like to include a demo application with your library? [ Yes / No ]
>Yes
//测试框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
>None
//是否要做基础的视图测试
Would you like to do view based testing? [ Yes / No ]
>No
//文件前缀
What is your class prefix?
>FF
2. 创建完成过后,我们的工程会自动打开,创建完成后,工程的目录如下
3. 添加功能的代码copy
到Classes
目录中新建的MyView
目录下,如下图所示
4. 前往码云https://gitee.com创建项目HFMyTest
5. 创建成功后配置HFMyTest
项目的.podspec
文件,文件位置
6. 在配置.podspec
文件时,需要修改的地方有如下几处:
7. 经过前6步,接下来将这个组件提交到码云上
B、远程私有代码仓库
1. 把本地的代码提交到远程仓库(注意要cd到工程目录下
)
cd /Users/hf/MyTest/HFMyTest
git remote add origin https://gitee.com/CuteHf/HFMyTest.git #添加远程仓库
git push -u origin master #第一次可能会报错可尝试用 git push -u origin master -f 可能会覆盖远程的修改
git add . #记得后面一定要有 .
git commit -m "创建我的组件"
git push -u origin master
git tag '0.1.0' #注意:这里的tag号必须和.podSpec文件的版本号一致
git push --tags
C、对文件进行本地验证和远程验证(在工程目录下)
1. 从本地验证你的pod
能否通过验证
pod lib lint --use-libraries --allow-warnings
本地验证pod
--verbose
:有些非语法错误是不会给出错误原因的,这个时候可以使用--verbose
来查看详细的验证过程来帮助定位错误。
--use-libraries
:表示使用静态库或者是framework,这里主要是解决当我们依赖一些framework库后校验提示找不到库的时候用到。
--allow-warnings
:表示允许警告。
2. 从本地和远程验证的pod
能否通过验证
pod spec lint --use-libraries --allow-warnings
本地远程验证pod
3. 将spec
文件提交到本地的私有仓库,然后再push
到远程仓库
pod repo push MyTestSpec HFMyTest.podspec --use-libraries --allow-warnings
push到远程仓库
D、此时打开/Users/hf/.cocoapods/repos/MyTestSpec
,发现下面多出HFMyTest
文件
MyTestSpec目录
E、查看远程私有索引库
码云上MyTestSpecF、使用终端查看自己的私有组件
pod search HFMyTest
如果提示
[!] Unable to find a pod with name, author, summary, or description matching HFMyTest
没有找到的话可以删除search_index.json
终端输入:
rm ~/Library/Caches/CocoaPods/search_index.json
此时再
pod search HFMyTest
三、在新的项目中引用这个组件
新建一个项目MyTest
,添加Podfile
文件,格式如下
其中的资源库地址指定去哪个资源去搜索资源