一、创建远程私有索引库
1. 创建远程私有索引库,然后复制仓库的地址
2. 打开终端,将远程私有库关联到本地
cd /Users/hf/.cocoapods/repos
pod repo add MyTestSpec https://gitee.com/CuteHf/MyTestSpec.git
cd到自己本地的.cocoapods/repos库,MyTestSpec是指你所要创建的本地索引库的名字,后边的地址就是你远程索引库的地址,即第一步复制的仓库地址
操作完之后,你就会看到本地.cocoapods/repos目录下面多了个MyTestSpec目录
二、创建私有代码仓库
1. 本地私有代码库
# cd到指定的目录(这个MyTestSpec是自己创建的一个文件目录 )
cd /Users/hf/MyTestSpec
# 这里的HFMyTest代表想要封装的组件名称， 这个根据自己的需求而定
pod lib create HFMyTest
1.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
1.2. 创建完成过后，我们的工程会自动打开，创建完成后，工程的目录如下
工程目录
1.3. 添加功能的代码copy到Classes 目录下，如下图所示(MyView为自己的功能代码)
目录代码
注意: 默认
Classes文件夹中存放的文件就是pod install时要下载下来的文件，当然可以通过修改spec文件的配置来更改位置,然后删除文件夹下的ReplaceMe.m文件,Assets存放的图片资源
1.4.前往远程创建项目HFMyTest文件
1.5. 创建成功后配置HFMyTest项目的.podspec文件，文件位置
修改HFMyTest.podspec
1.6. 修改配置.podspec文件(详细解读)
s.version = '1.0.4' --- 组件的版本号,每次修改文件提交都需要修改版本号
s.homepage = '' --- 远程创建项目的地址,即上边1.4的地址
s.author = '' --- 作者的名字
s.source = '' --- 和上边s.homepage的地址一样
s.ios.deployment_target = '' --- 支持的iOS版本号
s.swift_versions = '4.2' --- 支持的语言的版本号(当前用的swift)
s.resource_bundles = --- 加载图片资源
///
s.source_files = 'BIComponent/Classes/**/*' --- 加载功能代码,用此方法加载,所有的文件都在一个文件夹下,如果想分开不同的文件夹,需用下面的方法加载
s.subspec '文件夹的名字' do |随意起,底下使用(ve)|
ve.source_files = 'BIComponent/Classes/BIImage/*'// 文件位置
ve.dependency 'BIComponent/BITools'// 如果依赖你自己的组件,需要引用
ve.dependency 'SDWebImage' // 文件里用到第三方,需要引用
ve.resources = ['BIComponent/Assets/**/*'] // 图片资源文件,只有当前组件文件夹使用
end
///
1.7. 修改完之后保存退出
2. 远程私有代码仓库
2.1. 把本地的代码提交到远程仓库(注意要cd到你创建的工程目录下)
cd /Users/hf/MyTestSpec/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
3.对文件进行本地验证和远程验证(还是在上边的目录下)
3.1. 从本地验证你的pod能否通过验证
pod lib lint --use-libraries --allow-warnings
--verbose：有些非语法错误是不会给出错误原因的，这个时候可以使用来查看详细的验证过程来帮助定位错误
--use-libraries：表示使用静态库或者是framework，这里主要是解决当我们依赖一些framework库后校验提示找不到库的时候用到。
--allow-warnings：表示允许警告。
===注意: 如果上边的方法报错,试试不加--use-libraries试试(下边都一样)
验证成功结果
3.2. 从本地和远程验证的pod能否通过验证
pod spec lint --use-libraries --allow-warnings
验证成功结果
3.3. 将spec 文件提交到本地的私有仓库，然后再push到远程仓库
pod repo push MyTestSpec HFMyTest.podspec --use-libraries --allow-warnings
MyTestSpec为你第一步创建的私有索引库的名称
HFMyTest.podspec为你创建本地私有代码库之后自动生成的.podspec文件
push到远程仓库
4.此时打开/Users/hf/.cocoapods/repos/MyTestSpec，发现下面多出HFMyTest文件
MyTestSpec目录
5.查看远程私有索引库,发现上传上去
6.使用终端查看自己的私有组件
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
三、在新的项目中引用这个组件
1.新建一个项目MyTest，添加Podfile文件，格式如下
其中的资源库地址指定去哪个资源去搜索资源
也可以使用下面的方法
pod 'BIComponent', :git => '地址为你在配置文件中配置的地址,与上边方法的地址不一样'
上边的方法为导入这个组件所有的文件,如果只想导入组件里某个文件夹,使用下边的方法
pod 'BIComponent/BIImage', :git => '地址为你在配置文件中配置的地址'
四、使用组件
swift项目中，在import前面加@_exported,就可不需要每个文件都导入
OC项目中，导入pch文件即可
网友评论