组件化系列传送门
iOS组件化(一)----- 创建私有组件库(在码云上操作)
iOS组件化(二)----- 组件的更新
iOS组件化(三)----- 加载图片等资源文件
一、远程私有索引库创建(Spec)
A、创建远程私有索引库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、创建文件夹MyTest
B、本地私有代码库
# cd到指定的目录,这个MyTest是自己创建的一个文件目录
cd /Users/hf/MyTest
# 这里的HFMyTest代表想要封装的组件名称, 这个根据自己的需求而定
pod lib create HFMyTest
可能之后出现登录码云的需求,按照要求登录码云账号即可:
Cloning `https://github.com/CocoaPods/pod-template.git` >into `HFMyTestNew`. Configuring HFMyTestNew template. ! Before you can create a new library we need to setup >your git credentials. security: SecKeychainSearchCopyNext: The specified item >could not be found in the keychain. What is your name? > What is your email? >
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. 创建完成过后,我们的工程会自动打开,创建完成后,工程的目录如下
可以发现在
Pods
文件下面现在有一个HFMyTest
的文件夹,就是我们上面pod lib create HFMyTest
时候创建的文件夹名
3. 添加功能的代码copy
到Classes
目录中新建的MyView
目录下,如下图所示
4. 前往码云https://gitee.com创建项目HFMyTest
5. 创建成功后配置HFMyTest
项目的.podspec
文件,文件位置
6. 在配置.podspec
文件时,需要修改的地方有如下几处:
7. 经过前6步,接下来将这个组件提交到码云上
C、远程私有代码仓库
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
- 上面
git remote add origin https://gitee.com/CuteHf/HFMyTest.git
可能出现问题:fatal: not a git repository (or any of the parent directories): >.git
表示在当前指向的文件夹里找不到库(.git文件夹)
解决办法是对目录进行初始化git init
git push -u origin master
可能会出现error: src refspec master does not match any. error: failed to push some refs to >'https://gitee.com/CuteHf/HFMyTestNew.git'
出现错误的主要原因是码云中的
README.md
文件不在本地代码目录中,可以通过如下命令进行代码合并[注:pull=fetch+merge
]git pull --rebase origin master
经过上面一步会发现本地的代码已经提交到码云的HFMyTest
上面去了
D、对文件进行本地验证和远程验证(在工程目录下)
1. 从本地验证你的pod
能否通过验证
pod lib lint --use-libraries --allow-warnings
--verbose
:有些非语法错误是不会给出错误原因的,这个时候可以使用--verbose
来查看详细的验证过程来帮助定位错误。
--use-libraries
:表示使用静态库或者是framework,这里主要是解决当我们依赖一些framework库后校验提示找不到库的时候用到。
--allow-warnings
:表示允许警告。
2. 从本地和远程验证的pod
能否通过验证
pod spec lint --use-libraries --allow-warnings
3. 将spec
文件提交到本地的私有仓库,然后再push
到远程仓库
pod repo push MyTestSpec HFMyTest.podspec --use-libraries --allow-warnings
E、此时打开/Users/hf/.cocoapods/repos/MyTestSpec
,发现下面多出HFMyTest
文件
F、查看远程私有索引库
G、使用终端查看自己的私有组件
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
文件,格式如下
其中的资源库地址指定去哪个资源去搜索资源