CocoaPods 私有化Podspec

一、主要流程

• 1、创建并设置一个本地私有的Spec Repo，绑定远程Spec仓库
• 2、创建一个本地Pod库MGAPIClient，绑定远程Pod库
• 3、修改podspec文件，并验证可用性
• 4、podspec验证通过后，本地测试使用MGAPIClient.podspec文件
• 5、向远程私有的Spec Repo中提交podspec
• 6、完毕，使用制作成功的私有库MGAPIClient了。

二、傻瓜式教学

1、创建一个本地私有的Spec Repo：MGSpec，绑定托管到远程仓库

• 1、使用bitbucket托管服务，创建远程MGSpec仓库
  Snip20171213_4.png
• 2、创建本地私有Spec Repo，绑定托管到远程MGSpec仓库

1. 打开命令行终端，输入如下命令：
 
pod repo add  MGSpec https://jennyCjp@bitbucket.org/jennyCjp/mgspecs.git

2.  ~/.cocoapods/repos目录下就可以看到 MGSpec

Snip20171213_5.png

2、创建远程仓库MGAPIClient，创建本地Pod的项目工程库，如：MGAPIClient ，利用命令行将本地项目托管到远程仓库MGAPIClient

• 1. 使用bitbucket托管服务，创建远程Pod私有仓库

     
     Snip20171213_19.png

• 2. 创建Pod的项目工程库

     
     Snip20171213_6.png

• 3. 添加自定义类APIClient，放入MGAPIClient/MGAPIClient/Classes/

import UIKit
public class APIClient: NSObject {
   public class func requestAPI(){
        print("APIClient  requestAPI 网络请求 !")
    }
}

Snip20171213_20.png Snip20171213_21.png

# 1. 终端进入MGAPIClient根目录下的Example目录中
cd /Users/asahanayuujuu/MGAPIClient/Example 

# 2. 执行pod update 后查看项目
pod update

Snip20171213_22.png

• 4. 添加提交, 并打tag0.1.0后 ，推送到刚才创建的远程MGAPIClient仓库

Snip20171213_28.png

# 终端进入MGAPIClient根目录下
cd /Users/asahanayuujuu/MGAPIClient

# 添加，提交本地仓库，并推送到远程仓库MGAPIClient
git add .
git commit -s -m "初始化MGAPIClient库"
git remote add origin git@bitbucket.org:jennyCjp/mgapiclient.git
git push -u origin master

# podspec文件中获取Git版本控制的项目需要tag号，要打tag
 git tag -m '初始化 release' 0.1.0
 git push --tags   #推送tag到远程仓库

• 5. 查看远程MGAPIClient源码，已经将本地仓库，推送到远程

     
     Snip20171213_29.png

3、修改本地pod库MGAPIClient中的podspec文件，并验证可用性，验证通过后，将本地Pod库推送到远程

• 1、配置podspec文件

  Pod::Spec.new do |s|
  s.name             = 'MGAPIClient'
  s.version          = '0.1.0'   #版本号 要与刚才提交到远程仓库MGAPIClient打的tag标识一致。
  s.summary          = 'MGAPIClient 封装了一个网络框架，便于以后快速集成开发.'
  
  s.description      = <<-DESC
             MGAPIClient 是 测试Pod的一个Demo，封装了一个网络框架，便于以后快速集成开发。
                      DESC
  # 主页，填写可以访问到的地址，否则验证不通过
  s.homepage         = 'https://jennyCjp@bitbucket.org/jennyCjp'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  
  # 开源协议
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'jennyCheng' => '2271648527@qq.com' }
  
  # Pod库远程地址，不支持ssh，请使用Https
  s.source           = { :git => 'https://jennyCjp@bitbucket.org/jennyCjp/mgapiclient.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 = 'MGAPIClient/Classes/**/*'
  
  # 资源文件地址
  # s.resource_bundles = {
  #   'MGAPIClient' => ['MGAPIClient/Assets/*.png']
  # }
  
  
  #公开头文件地址
  # s.public_header_files = 'Pod/Classes/**/*.h'
  
  #所需的framework，多个用逗号隔开
  # s.frameworks = 'UIKit', 'MapKit'
  
  #依赖库，该项目所依赖的其他库，如果有多个需要填写多个s.dependency
  # s.dependency 'AFNetworking', '~> 2.3'
  end
  

• 2. 验证

# 进入本地MGAPIClient根目录
cd /Users/asahanayuujuu/MGAPIClient
# 验证，
pod lib lint
# 如下则验证通过后，podspec就是一个符合CocoaPods规则的配置文件了。
 -> MGAPIClient (0.1.0)
MGAPIClient passed validation.

# 推送到远程MGAPIClient仓库

可能警告错误：

1、 验证podspec文件时

-> MGAPIClient (0.1.0)
    - WARN  | [iOS] swift_version: The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: 
    `echo "2.3" > .swift-version`

• 解决方式：

 终端执行 echo 3.0 > .swift-version
 后执行验证  pod lib lint

4、podspec验证通过后，本地测试MGAPIClient项目中的MGAPIClient.podspec使用

• 1. 修改MGAPIClient中的Podfile文件

Podfile原文件

use_frameworks!
target 'MGAPIClient_Tests' do  
 pod 'MGAPIClient', :path => '../'
end

修改成

use_frameworks!
target 'MGAPIClient_Tests' do
  # pod 'MGAPIClient', :path => '../'
  pod 'MGAPIClient', :podspec => '../MGAPIClient.podspec'
end

• 2. 更新pod库

# 进入本地MGAPIClient根目录Example文件
cd /Users/asahanayuujuu/MGAPIClient/Example
# 执行更新
pod update

在之前pod update前与后，文件对比

更新前.png 更新后.png

5、向远程私有的Spec Repo中提交podspec

• 1、提交推送本地MGAPIClient库修改，到远程MGAPIClient仓库

# 进入本地MGAPIClient根目录
cd /Users/asahanayuujuu/MGAPIClient
git add .
git commit -s -m "podspec文件测试修改"
git push origin master #提交到远程仓库

• 2、推送MGAPIClient.podspec到私有远程spec仓库

# 进入本地MGAPIClient根目录
cd /Users/asahanayuujuu/MGAPIClient

# podspec文件推送到私有远程spec仓库
# 注意：MGSpec：之前本地创建的spec名字， MGAPIClient.podspec： 创建本地pod项目中的podspec名字。
pod repo push MGSpec MGAPIClient.podspec 

• 3. 成功推送

Validating spec
 -> MGAPIClient (0.1.0)

Updating the `MGSpec' repo

Already up-to-date.

Adding the spec to the `MGSpec' repo

 - [Add] MGAPIClient (0.1.0)

Pushing the `MGSpec' repo

• 4. 对比之下推送podspec文件到远程spec仓库的前与后：

     
     前.png

后.png

• 5. 查看远程Spec仓库，查看推送podspec文件后。

     
     推送podspec文件后.png

6、完毕，使用制作成功的私有库MGAPIClient

• 1、新建iOS项目tesstPod，创建profile文件，添加MGAPIClient仓库

# 私有Spec Repo
source 'https://git.coding.net/kensla/DDSpecs.git' 
pod 'MyLib', '~> 0.1.0'

Snip20171213_38.png