组件化的架构设计,是将每个模块作为一个组件.每个组件都当做一个独立工程,并建立主项目来集成所有组件.集成方式是在主项目中通过CocoaPods来集成,将所有组件当做第三方库集成到项目中.
创建Pod库文件
- 使用命令创建本地Pod库
输入 -pod lib create XMLYMain
- 命令后,会询问语言类型\是否创建Demo等信息,依次输入最终会创建一个如下图所示的文件目录.
What language do you want to use?? [ Swift / ObjC ]
> ObjC
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?
> XMLY
创建过程中没有提示我输入author等信息,应该是我之前已经在MBP上配置过github账号的原因
文件作用
license 文件
CocoaPods 强制要求所有的 Pod 依赖库都必须有 license 文件,否则验证不会通过.这里一般是MIT类型的license.Example
刚才创建的时候Would you like to include a demo application with your library?
选择了Yes
.这个文件就是命令帮我们创建的Demo工程文件.用来向其他使用者展示该Pod的使用.-
XMLYMain
与创建的Pod库同名,里面有两个文件夹Assets
和Classes
- Assets - 存放Pod库中所需的资源文件(如.png .plist)
- Classes - 存放Pod库的实例类
XMLYMain.podspec
.podspec
是Pod库的配置文件,其中属性已经自动生成.我们需要注意的是s.version
,以后每次对Pod库的修改都需要修改version,并创建提交修改的tag.
Pod::Spec.new do |s|
s.name = 'XMLYMain'
s.version = '0.1.0'
s.summary = 'XMLYMain'
s.description = <<-DESC
'XMLYMain':项目的主要框架
DESC
s.homepage = 'https://github.com/caiiiac/XMLYMain'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'caiiiac' => 'caiiiac@163.com' }
s.source = { :git => 'https://github.com/caiiiac/XMLYMain.git', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.source_files = 'XMLYMain/Classes/**/*'
# s.resource_bundles = {
# 'XMLYMain' => ['XMLYMain/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
- 验证的时候可能会遇到的问题
- WARN | summary: The summary is not meaningful.
请参照上面修改.podspec
文件里的s.summary
和s.description
字段
提交Pod到github
- 关联github
首先在github上创建同名项目,cd命令进入本地XMLYMain
目录
cd XMLYMain
git remote add origin https://github.com/caiiiac/XMLYMain.git
git push -u origin master
- 添加文件并设tag
将自己开发的.h .m文件保存到XMLYMain
->Classes
目录中
将需要的资源文件保存到XMLYMain
->Assets
目录中
git add .
git commit -m "0.1.0 init"
git push origin master
git tag '0.1.0'
git push --tags
- 验证Pod
pod lib lint
如果一切正常就会输出
-> XMLYMain (0.1.0)
XMLYMain passed validation.
部署Pod
这里我们将会使用到Trunk
,CocoaPods
使用 trunk
服务让我们来提交 Pod.
- 注册Trunk
pod trunk register caiiiac@163.com 'caiiiac' --description='trunk with MacBook Pro' --verbose
注意将邮箱 - 名字 - 描述文字改成自己的
稍候CocoaPods 会给你的邮箱发送验证链接,验证成功后,可以用 pod trunk me 命令查看自己的注册信息
- 部署Pod
通过pod trunk push XMLYMain.podspec
命令部署你的Pod
注意将podspec的文件换成你自己的文件名,成功后会出现提示信息
🎉 Congrats
🚀 XMLYMain (0.1.0) successfully published
📅 July 17th, 03:53
🌎 https://cocoapods.org/pods/XMLYMain
👍 Tell your friends!
搜索你的Pod
- 运行
pod reop update
来更新本地索引库 - 使用
pod search XMLYMain
命令来查找你刚刚部署成功的Pod
如果还是搜索不到,提示Unable to find a pod with name, author, summary, or description matching XMLYMain
- 解决方法: 前往缓存目录
/Users/你的目录名/Library/Caches/CocoaPods
删除search_index.json
文件,当你再次pod search
的时候会重新生成.