iOS-组件化开发

一、创建远程私有索引库

    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文件即可

非常感谢这位老铁的文章 https://www.jianshu.com/p/1446a3c2f786

你可能感兴趣的:(iOS-组件化开发)