组件化开发流程__(组件打包发布)

1. 编辑 podspec 文件

这一步非常重要，能不能验证通过就主要看这个文件的内容编辑是否正确了。

• pod自动生成了一部分必须的字段，如果需要设置更多字段，点击这里，以下部分字段并不是必须的，根据需求编辑即可。

#
# Be sure to run `pod lib lint BSDModuleNet.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see https://guides.cocoapods.org/syntax/podspec.html
#

Pod::Spec.new do |s|
  s.name             = 'BSDModuleNet'  
  s.version          = '0.1.0'
  s.summary          = '组件化/基础工具/网络请求'

# 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      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'http://114.55.74.197/ios-team/Modulization/BSDModuleNet'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'linjiangfeng' => 'linjiangfeng@basestonedata.com' }
  s.source           = { :git => 'git@114.55.74.197:ios-team/Modulization/BSDModuleNet.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

  s.source_files = 'BSDModuleNet/Classes/**/*'
  
  # s.resource_bundles = {
  #   'BSDModuleNet' => ['BSDModuleNet/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
   s.dependency 'AFNetworking', '~> 2.3' #第三方库
   s.dependency 'BSDModuleTools' #私有库
end

• 修改其中的内容，讲解一下各字段的含义，xxx 处就是需要修改的内容。

s.name = 'xxx' ：框架名称，也是 pod search 搜索的关键词，并且一定要和 .podspec 文件的名称一样，否则验证报错。（必须）

s.version = 'xxx' ：框架版本号。（必须）

s.summary = 'xxx' ： pod search 搜索框架时，显示的框架简介。（必须）

s.homepage = 'xxx' ：项目主页地址.（必须）

s.license = { :type => 'MIT', :file => 'LICENSE' } ：许可证，这里就这样写不用修改。（必须

s.author = { 'xxx' => 'xxx' } ：作者，前面填你的英文名，后面填你的个人邮箱。（必须）

s.source = { :git => 'xxx', :tag => s.version } ：GitHub 项目的仓库地址。（必须）

s.social_media_url = 'xxx' ：社交网址。(非必须)

s.ios.deployment_target = '8.0'  ：系统类型和系统版本。(必须)

s.source_files = 'xxx/*.{h,m}' ：要添加 CocoaPods 支持的文件路径。

几种写法：
s.source_files = 'xxx/*'
s.source_files = 'xxx/*.{h,m}'
s.source_files = 'xxx/**'

'*'：表示匹配所有文件
'*.{h,m}'：表示匹配所有以 .h 和 .m 结尾的文件
'**'：表示匹配所有子目录

s.resource_bundle = { 'xxx' => ['xxx/**/*.xcassets'] } ：要添加 CocoaPods 支持的图片资源。

如果要在主工程中使用 pod 中的图片，方法如下：

// 假如 podspec 中定义的 Bundle 名字为 TestBundle
s.resource_bundle = { 'TestBundle' => ['xxx/**/*.xcassets'] }
// 调用的时候要注意一下方法

s.ios.vendored_frameworks = 'xxx/xxx.framework' ：用于引入自己打包的framework

s.frameworks = 'UIKit'：用于引入官方的 framework

s.dependency 'xxx' ：项目依赖的其他 pod 库，不能依赖未发布的库，版本号可以不写。

多个依赖可以这样写：
s.dependency 'xxx'
s.dependency 'xxx'
s.dependency 'xxx'

指定版本可以这样写：
s.dependency 'xxx', '1.0.0'

s.subspec 'xxx' do |s|

end

表示建立一个名字为 xxx 的子文件夹，可以将文件分类，我上面用 ... 跳过了，不需要可以不写，里面写法和外面是一样的，例如：

s.subspec 'xxx' do |s|

    s.source_files       = 'xxx/*.{h,m}'
    s.resource_bundle    = { 'xxx' => ['xxx/**/*.xcassets'] }

end

注意：不同子文件夹下 source_files 中的文件是单独编译的，如果文件中引入了别的子文件夹下的代码是编译不通过的。

---

2. 验证 podspec 文件

podspec 文件修完完成以后，command + s 保存一下，接下来开始验证。

• 依旧用终端 cd 到你的项目目录执行以下命令：

pod lib lint

• 如果是提示只有 warning 错误，并提示 but you can use '--allow-warnings' to ignore them 的话，就执行以下命令忽略 warning 来验证：

pod lib lint --allow-warnings

• 如果提示有 error 错误的话，就必须按照提示将错误解决掉，大多数都是 podspec 文件信息编辑有误，解决完后重新进行验证，如果提示信息不足，可以执行以下命令以获取更多错误信息：

pod lib lint --verbose

• 如果出现如下图的 BSDModuleTools passed validation. 就是验证成功了。

  
  验证成功.png

3.给项目打上 tag 版本

因为 CocoaPods 是依赖项目的 tag 版本的，所以必须打上 tag 版本。

• podspec 文件验证成功后，先将改动后的文件 commit 提交，接着 push 推送到 Git仓库 。
• 然后执行以下命令打上 tag 版本，版本名必须要和之前podspec 文件中的 s.version 一致。

git tag "1.0.0" // 为 git 提交打上 tag
git push --tags // 将 tag 推送到远程仓库

---

4.发布到私有仓库

• 发布之前需要先创建一个用来存放私有库的 Git仓库 (已经建好，链接为地址)，然后将仓库 git clone 到 ~/.cocoapods/repos/ 这个目录。

• 然后在终端输入 pod repo 就可以看到除了有一个 master 的官方库以外，还多了一个自己的私有仓库。

  
  clone私有库.png

• 然后依旧先 cd 到你的项目目录，接着要注意的是，发布时会再次验证你的 podspec 文件，如果刚才验证时使用了 --allow-warnings ，那么发布的时候也应该使用，否则会出现相同的报错，BSDModuleCocoapodsRepo 是我们自己的私有仓库的名字，BSDModuleTools 改成你自己维护的 podspec 文件的名字。

• 如果刚才是用 pod lib lint 验证成功的，就执行以下命令发布：

pod repo push BSDModuleCocoapodsRepo BSDModuleTools.podspec

• 如果刚才是用 pod lib lint --allow-warnings 验证成功的，就执行以下命令发布：

pod repo push BSDModuleCocoapodsRepo BSDModuleTools.podspec --allow-warnings

• 最后出现绿色的 Updating the 'BSDModuleCocoapodsRepo' repo
Adding the spec to the 'BSDModuleCocoapodsRepo' repo
Pushing the 'BSDModuleCocoapodsRepo' repo
  就算成功了

• 如要项目中要使用私有仓库来 pod install ，必须在 podfile 开头指明私有仓库的地址和官方仓库地址，注意两个地址都要指定，例如： pod引用私有库.png

5. 私有库依赖私有库

这个情况就比较特殊了，如果私有库中依赖了另一个私有库，podspec 文件中依旧要使用 s.dependency 'xxx' 来指明依赖的私有库，但是在验证 podspec 时就不能使用 pod lib lint 来验证了，否则会找不到依赖的私有库，需要从远程验证并指定私有库的地址，下面是验证步骤。

依赖私有库.png

• podspec 文件的编辑没有区别，编辑完以后，由于需要远程验证而不是本地验证，所以需要先将编辑完的 podspec 文件 git push 再打上 tag 。
• 然后使用以下命令开始验证，后面指明私有仓库的地址和官方仓库地址，注意两个地址都要指定。

pod spec lint --sources='私有仓库地址,https://github.com/CocoaPods/Specs.git' --allow-warnings
(例如：pod spec lint --sources='git@114.55.74.197:ios-team/BSDModuleCocoapodsRepo.git,https://github.com/CocoaPods/Specs.git' --allow-warnings)

• 验证成功后发布到私有仓库时，也需要指明私有仓库的地址和官方仓库地址，如下。

pod repo push 私有仓库名 xxx.podspec --sources='私有仓库地址,https://github.com/CocoaPods/Specs.git' --allow-warnings
(例如：pod repo push BSDModuleCocoapodsRepo BSDModuleNet.podspec --sources='git@114.55.74.197:ios-team/BSDModuleCocoapodsRepo.git,https://github.com/CocoaPods/Specs.git' --allow-warnings)

好了，大功告成，其实过程挺简单的，只要 podspec 文件编辑正确，就会少走很多坑，以后再次更新框架的话，只需要修改 podspec 文件中的 s.version 版本，然后把你的项目再打一个 tag 版本，接着再次提交到 私有库 就可以了。