cocoapods私有化组件

随着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 = { '[[email protected]](https://www.aliyun.com/jiaocheng/356960.html)' => '[[email protected]](https://www.aliyun.com/jiaocheng/356960.html)' }
# 这个比较重要,指的就是git的对应的远程仓库的地址以及版本号,版本号直接获取的是上面的s.version
# 项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
s.source = { :git => 'https://WANG19931123:[[email protected]](https://www.aliyun.com/jiaocheng/356960.html)/WANG19931123/DownLoader.git', :tag => s.version.to_s }
# 多媒体介绍地址
# s.social_media_url = 'https://twitter.com/'
# 支持的平台及版本
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
pod trunk push xxx.podspec --allow-warnings
pod trunk delete xxx 1.0.1 删除pod

所有以上操作全是在操作组件化代码，操作的目录也都是在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" => "[email protected]" }
  # Or just: s.author    = "SmallwolfiOS"
  # s.authors            = { "SmallwolfiOS" => "[email protected]" }
  # 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

以及集成之后的目录结构

pod trunk register 出现如下错误:

[!] There was an error registering with trunk: Failed to open TCP connection to trunk.cocoapods.org:443 (getaddrinfo: nodename nor servname provided, or not known)

修改你的DNS为114.114.114.114

希望对大家有所帮助
https://segmentfault.com/a/1190000012269307
https://www.jianshu.com/p/ea2a972a7b4b
https://www.cnblogs.com/wdsunny/p/5187528.html