随着iOS APP越来越复杂,功能越来越多,对于iOS项目的工程化要求也越来越高了,对于复杂的APP一般都需要对项目进行模块化管理。但是对于公司的项目,全都放到cocoapods公开组件也并不安全,而且有些组件是不能够放到公开组件上的,所以就有了私有化组件的需求。
今天给大家带来超级详细的使用cocoapods进行私有化组件的方案。
1.podspec文件的详细说明:
Pod::Spec.new do |s|
# 项目的名称
s.name = 'DownLoader'
# 项目的版本号,通过项目git的tag标签进行对应,这里的标签代表的版本
s.version = '0.1.1'
# 项目简单的描述信息
s.summary = '简单的下载器##0.1.1'
# 项目的详细描述信息,注意,这里的文字的长度,一定要比上面的s.summary长,不然会认为格式不合格
s.description = <<-DESC
简单的下载器,支持断点下载
DESC
# 项目的网页主页信息,这里可以直接写自己的远程仓库的主页的地址
s.homepage = 'https://coding.net/u/WANG19931123/p/DownLoader'
# 截图
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
# 开源协议
s.license = { :type => 'MIT', :file => 'LICENSE' }
# 作者信息
s.author = { '[aliyunzixun@xxx.com](https://www.aliyun.com/jiaocheng/356960.html)' => '[aliyunzixun@xxx.com](https://www.aliyun.com/jiaocheng/356960.html)' }
# 这个比较重要,指的就是git的对应的远程仓库的地址以及版本号,版本号直接获取的是上面的s.version
# 项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
s.source = { :git => 'https://WANG19931123:[aliyunzixun@xxx.com](https://www.aliyun.com/jiaocheng/356960.html)/WANG19931123/DownLoader.git', :tag => s.version.to_s }
# 多媒体介绍地址
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
# 支持的平台及版本
s.ios.deployment_target = '8.0'
# 代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
# s.source_files = 'DownLoader/Classes/**/*'
s.subspec 'Category' do |category|
category.source_files = 'DownLoader/Classes/Category/**/*'
category.dependency 'AFNetworking', '~> 3.0'
end
s.subspec 'DownLoader' do |downLoader|
downLoader.source_files = 'DownLoader/Classes/DownLoader/**/*'
end
# 资源文件地址
# s.resource_bundles = {
# 'DownLoader' => ['DownLoader/Assets/*.png']
# }
# 公开头文件地址
# s.public_header_files = 'Pod/Classes/**/*.h'
# 所需的framework,多个用逗号隔开
s.frameworks = 'UIKit'
# 依赖关系,该项目所依赖的其他,当在加载的时候也会一块把相关的依赖的库加载下来,如果有多个需要填写多个
# s.dependency 'AFNetworking', '~> 2.3'
# 是否使用ARC,如果指定具体文件,则具体的问题使用ARC
s.requires_arc = true
end
三方库的目录表specs:终端输入cd ~/.cocoapods/repos/master可看到里面放的都是一个个的podspec文件大小仅仅为几KB,是三方库的索引文件。
私有库目录表的远程仓库:是目录表文件的远程存放地址。
私有库的远程仓库:这是我们自己写的想作为一个组件的代码。
2.创建远程仓库(用于存放组件库的索引和组件代码)
2.1首先创建一个索引库HPLibRepo
2.2然后创建一个存放组件的库
HPLibTool
2.3把组件的代码clone到本地,因为你要把你的组件代码放到上面去
cd Desktop/
git clone https://git.coding.net/mahaiping/HPLibTool.git
2.4拷贝代码到你的组件库里,我这里为了目录清晰,放了一个Classes文件夹,因为比如你有很多个子文件夹,这里可以进行区分
2.5 创建pod描述文件,让组件代码具有被cocoapod管理的能
cd到你的组件库的根目录
cd HPLibTool
pod spec create HPLibTool//这样就会在根目录生成一个HPLibTool.podspec文件
2.6 编辑podspec描述文件,主要就是讲清楚你这个私有库的地址和依赖关系等,下面是必须修改才能通过的地方
s.platform = :ios, "9.0"
s.source = { :git => "https://git.coding.net/mahaiping/HPLibTool.git", :tag => "#{s.version}" }
s.source_files = "Date", "Tool"
s.description = "ssss"
s.homepage = "https://git.coding.net/mahaiping/HPLibTool.git"
2.7 设置完了以后,在终端中验证下HPLibTool这个项目是否真的具有了被cocoapod管理的能力,注意要添加allow-warning
才可以通过。
pod lib lint --verbose --allow-warnings
2.8 给组件库打tag,并上传到git服务器,注意还是在HPLibTool代码的目录下执行一下命令
git add .
git commit -m "添加了Date和Tool代码"
git tag -a 0.0.1 -m "添加0.0.1tag"
git push origin --tags
git push
所有以上操作全是在操作组件化代码,操作的目录也都是在HPLibTool这个项目的目录下。接着开始整项目索引文件
3.索引文件
3.1把远程repo--也就是库的索引文件(最后要通过这个找到你制作的组件)复制到本地pod管理目录文件夹中
pod repo add HPLibRepo https://git.coding.net/mahaiping/HPLibRepo.git
cd ~/.cocoapods/repos/
open .
这时系统中.cocoapod的本地文件夹就出现了我们自己的项目索引文件HPLibRepo文件
3.2一句代码添加刚才验证好的podsec到本地这个文件夹并且上传到远程目录管理服务器
注意这个时候必须回到HPLibTool这个具体项目的目录下来执行
cd /HPLibTool
pod repo push HPLibRepo HPLibTool.podspec --verbose --allow-warnings
- 必须回到HPLibTool具体项目的目录下
- 虽然是git上传但口令是pod repo push,不是git push
- HPLibRepo写的是项目索引的名称,不是项目名称
- HPLibTool.podspec 是具体项目的描述文件podspec,就是刚才验证 通过的文件
- 要加--allow-warnings 因为我们的描述文件有些不规范的地方
4.尝试集成一下我们自己的组件
4.1创建一个demo项目来用用吧
xcode创建一个demo名称的工程,退出
cd /demo
pod init
pod search HPLibTool
4.2搜索自己的私有库
终端中搜索到自己的私有库,这一步就很有成就感了,bingo!
这时编辑demo项目中多出的podfile文件,如下
4.3 编辑podfile
特别注意要添加两个源
,并且使用use_frameworks
source 'https://github.com/CocoaPods/Specs.git'
source 'https://git.coding.net/mahaiping/HPLibRepo.git'
#以上两个就是所谓的两个源
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
target 'podDemo' do
# Uncomment the next line if you're using Swift or would like to use dynamic frameworks
# use_frameworks!
# Pods for podDemo
pod 'HPLibTool', '~> 0.0.7'
end
4.4最后的安装组件
终于到最后一步安装了
pod install
最后贴出来我自己的组件化的podspec
#
# Be sure to run `pod spec lint HPLibTool.podspec' to ensure this is a
# valid spec and to remove all comments including this before submitting the spec.
#
# To learn more about Podspec attributes see http://docs.cocoapods.org/specification.html
# To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/
#
Pod::Spec.new do |s|
# ――― Spec Metadata ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# These will help people to find your library, and whilst it
# can feel like a chore to fill in it's definitely to your advantage. The
# summary should be tweet-length, and the description more in depth.
#
s.name = "HPLibTool"
s.version = "0.0.7"
s.summary = "A short description of HPLibTool."
# This description is used to generate tags and improve search results.
# * Think: What does it do? Why did you write it? What is the focus?
# * Try to keep it short, snappy and to the point.
# * Write the description between the DESC delimiters below.
# * Finally, don't worry about the indent, CocoaPods strips it!
s.description = "ssss"
s.homepage = "https://git.coding.net/mahaiping/HPLibTool.git"
# s.screenshots = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"
# ――― Spec License ――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# Licensing your code is important. See http://choosealicense.com for more info.
# CocoaPods will detect a license file if there is a named LICENSE*
# Popular ones are 'MIT', 'BSD' and 'Apache License, Version 2.0'.
#
s.license = "MIT"
# s.license = { :type => "MIT", :file => "FILE_LICENSE" }
# ――― Author Metadata ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# Specify the authors of the library, with email addresses. Email addresses
# of the authors are extracted from the SCM log. E.g. $ git log. CocoaPods also
# accepts just a name if you'd rather not provide an email address.
#
# Specify a social_media_url where others can refer to, for example a twitter
# profile URL.
#
s.author = { "SmallwolfiOS" => "1348748408@qq.com" }
# Or just: s.author = "SmallwolfiOS"
# s.authors = { "SmallwolfiOS" => "1348748408@qq.com" }
# s.social_media_url = "http://twitter.com/SmallwolfiOS"
# ――― Platform Specifics ――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# If this Pod runs only on iOS or OS X, then specify the platform and
# the deployment target. You can optionally include the target after the platform.
#
s.platform = :ios , "9.0"
# s.platform = :ios, "5.0"
# When using multiple platforms
# s.ios.deployment_target = "5.0"
# s.osx.deployment_target = "10.7"
# s.watchos.deployment_target = "2.0"
# s.tvos.deployment_target = "9.0"
# ――― Source Location ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# Specify the location from where the source should be retrieved.
# Supports git, hg, bzr, svn and HTTP.
#
s.source = { :git => "https://git.coding.net/mahaiping/HPLibTool.git", :tag => "#{s.version}" }
# ――― Source Code ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# CocoaPods is smart about how it includes source code. For source files
# giving a folder will include any swift, h, m, mm, c & cpp files.
# For header files it will include any header in the folder.
# Not including the public_header_files will make all headers public.
#
s.source_files = "Classes/Header.h"
# s.public_header_files = "/HPLibTool/Classes/Header.h"
s.subspec 'Tool' do |tool|
tool.source_files = "Classes/Tool/*.{h,m}"
# Tool.public_header_files = "Classes/FCCache/*.h"
end
s.subspec 'Date' do |date|
date.source_files = "Classes/Date/*.{h,m}"
# Tool.public_header_files = "Classes/FCCache/*.h"
end
# s.source_files = "Tool"
# , "Classes/**/*.{h,m}"
# s.exclude_files = "Classes/Exclude"
# ――― Resources ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# A list of resources included with the Pod. These are copied into the
# target bundle with a build phase script. Anything else will be cleaned.
# You can preserve files from being cleaned, please don't preserve
# non-essential files like tests, examples and documentation.
#
# s.resource = "icon.png"
# s.resources = "Resources/*.png"
# s.preserve_paths = "FilesToSave", "MoreFilesToSave"
# ――― Project Linking ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# Link your library with frameworks, or libraries. Libraries do not include
# the lib prefix of their name.
#
# s.framework = "SomeFramework"
# s.frameworks = "SomeFramework", "AnotherFramework"
# s.library = "iconv"
# s.libraries = "iconv", "xml2"
# ――― Project Settings ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
#
# If your library depends on compiler flags you can set them in the xcconfig hash
# where they will only apply to your library. If you depend on other Podspecs
# you can include multiple dependencies to ensure it works.
# s.requires_arc = true
# s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
# s.dependency "JSONKit", "~> 1.4"
end
以及集成之后的目录结构
希望对大家有所帮助
https://segmentfault.com/a/1190000012269307
https://www.jianshu.com/p/ea2a972a7b4b
https://www.cnblogs.com/wdsunny/p/5187528.html
网友评论