iOS 发布我的开源框架到CocoaPods

• 须要作的工做包括如下几点

1. 建立一个本地的仓库，将本身想要公开的代码搞进去
2. 将本身的代码上传到远程公开仓库中去
3. 建立一个pods 的描述文件 .podspec
4. 修改.podspec描述文件中的相关的描述信息
5. 将当前本地的.podspec文件传到CocoaPods官方的索引库中
6. 测试一下，有没有上传到CocoaPods的索引库中
7. 后期的升级维护

• 具体详细的步骤以下

1. 2. 建立远程仓库注意点

• 正规的仓库都有一个license文件，Pods依赖库对这个文件要求比较严格，须要有这个文件，建议使用MIT类型的license
• 代码版本要打tag(要在代码版本上传之后打tag)
• pod 支持 .a静态库、.framework 以及文件，不必定要是可运行的工程里面的某个组件
• 放代码的仓库不必定非要是Git仓库，只要是能够获取到相关代码文件就能够，能够是SVN的，也能够是zip包，区别就是在podspec中的source项填写的内容不一样

3. 建立一个pods 的描述文件 .podspec $ pod spec create MyViewExtension<这个名称通常和建立的项目名称同样就能够>
4. 修改.podspec描述文件中的相关的描述信息 详情可参考CocoaPods的官网的PodSpec语法

Pod::Spec.new do |s|
  # 项目的名称
  s.name             = "MyViewExtension"   
  # 项目的版本号，经过项目git的tag标签进行对应，这里的标签表明的版本 
  s.version          = "0.0.1"    
  # 项目简单的描述信息 
  s.summary          = "Just Testing."  
  # 项目的详细描述信息，注意，这里的文字的长度，必定要比上面的s.summary长，否则会认为格式不合格
  s.description  = <<-DESC
                      this project provide all kind of KeychainDeviceID for iOS developer 
                   DESC
  # 项目的网页主页信息，这里能够直接写本身的远程仓库的主页的地址
  s.homepage         = "https://github.com/RunOfTheSnail/MyViewExtension"
  # 开源协议
  s.license          = "MIT"   
  # 做者信息 
  s.author             = { "zhangyan" => "17***24@163.com" }                   
  # 这个比较重要，指的就是git的对应的远程仓库的地址以及版本号，版本号直接获取的是上面的s.version
  # 项目地址，这里不支持ssh的地址，验证不经过，只支持HTTP和HTTPS，最好使用HTTPS
  # Supported Keys:
  # :git => :tag, :branch, :commit, :submodules
  # :svn => :folder, :tag, :revision
  # :hg => :revision
  # :http => :flatten, :type, :sha256, :sha1
  s.source       = { :git => "https://github.com/RunOfTheSnail/MyViewExtension.git", :tag => s.version }                      
  # 支持的平台及版本
  s.platform     = :ios, "11.0"
  # 支持的ios最低版本
  s.ios.deployment_target = "7.0"
  # 若是是 Swift 的话指定 Swift 编译版本
  # s.swift_version = "4.0"
  # 必备项，代码源文件地址，若是有多个目录下则用逗号分开,不然"public_header_files"等不可用
  s.source_files  = "GSLXYKeychainDeviceID/KeychainDeviceID/**/*.{h,m}"                               
  # 公开头文件地址
  # s.public_header_files = "Pod/Classes/**/*.h"
  # 所需的系统framework，多个用逗号隔开，不须要后缀名
  # s.framework = "SomeFramework"
  s.frameworks = "UIKit", "AnotherFramework"
  # 须要弱连接的框架
  # s.weak_framework = "Twitter"
  # s.weak_frameworks = "Twitter", "SafariServices"
  #项目依赖的库文件(这个是系统的库文件),不须要后缀名,好比sqlite,libz等.以lib开头的须要省略掉lib这三个字母.例如:libz须要简写为z不然报错
  # s.library = "iconv"
  # s.libraries = "iconv", "xml2"
  # 第三方或本身建立的 .Framework的名称
  # s.vendored_frameworks = "YostarLib.framework"
  # 第三方或本身建立的 .a静态库的名称
  # s.vendored_libraries = "libYostarStaticLib.a"
  # 添加资源文件
  # s.resource = "XXX/XXXX/**/*.bundle"
  # s.resources = "XXX/XXXX/**/*.bundle"
  # CocoaPods会把这个库配置成static framework，同时支持Swift和Objective-C
  # s.static_framework = true
  # 依赖关系，该项目所依赖的其余，当在加载的时候也会一块把相关的依赖的库加载下来，若是有多个须要填写多个
  # s.dependency "JSONKit", "~> 1.4" 
  # 是否使用ARC，若是指定具体文件，则具体的文件使用ARC 
  s.requires_arc = true
  # 指定项目配置，如HEADER_SEARCH_PATHS、OTHER_LDFLAGS等
  # s.xcconfig = {"OTHER_LDFLAGS" => "-ObjC"}  
end
复制代码

• 修改完毕以后进行检验一下.podspec的格式有木有问题

$ pod lib lint
完整lint格式
$ pod lib lint --allow-warnings --use-libraries --verbose --no-clean --sources='http://10.11.180.29/mobileDevelopers/YZT-Loan-Pod-Spec.git'
--verbose:打印错误
--allow-warnings:容许警告,默认有警告的podspec会验证失败
--fail-fast:遇到错误立刻中止，默认会完成全过程再中止
--use-libraries:若是本身私有库包含library,引用了.a、.framework,在验证和提交时须要加
--no-clean:检查问题
--sources:若是依赖了其余不包含在官方specs里的pod，则用它来指明源，好比依赖了某个私有库。多个值以逗号分隔
复制代码

5. 将当前本地的podspec文件传到CocoaPods官方的索引库中 5.1. 第一次须要上传须要注册 $ pod trunk register zy_iOS2163.com 'zy' --description='macbook air' --verbose 你注册的时候须要替换邮箱和名字，加上 --verbose 能够看到详细信息，而后你会收到一份邮件，须要点击验证

   

   5.2. 使用$ pod trunk me查看注册信息是否注册成功

   

   5.3. 若是你的pod是由多人维护的，你也能够添加其余维护者 $ pod trunk add-owner JLC kyle@163.com（即：pod trunk add-owner 库名 邮箱） 移除某个管理员 $ pod trunk remove-owner TTLockSDK 邮箱地址（即：pod trunk remove-owner 库名 邮箱） $ pod trunk info TTLockSDK查看库当前状态，版本，全部人等 5.4. 在提交 spec 文件前，若是发布的是 Swift 框架，须要指定 Swift 的版本，不然会报错，执行$ echo "4.0" > .swift-version便可指定版本为 4.0 5.5. 执行命令，将 .podspec push到cocopods的trunk中 $ pod trunk push MyViewExtension.podspec
6. 测试一下，有没有上传到CocoaPods的索引库中

• $ pod search SGExtension若是没有搜到，可能就是本地仓库没有更新
• 更新本地仓库$ pod repo update再次执行$ pod search SGExtension
• 若是还搜索不到，执行$ rm ~/Library/Caches/CocoaPods/search_index.json这句话是移除已经生成的搜索目录缓存文件,移除以后,执行pod search会从新生成一份最新的缓存列表
• 查看本地索引库:$ open ~/.cocoapods/repos

7. 在我的项目中增长刚刚制做好的Podfile并使用 新建一个测试工程测试，用CocoaPods初始化项目，编辑Podfile文件:

#CocoaPods官方spec仓库
source 'https://github.com/CocoaPods/Specs.git'
#本身私有spec仓库
source 'https://github.com/wenmobo/WBSpecs.git'

platform :ios, '8.0'

target 'TestDemo' do
  #防Crash库
  pod 'WBAvoidCrash'
end
复制代码

编辑好podfile文件以后，终端执行:

$ pod install 安装时使用，更新库使用update命令
或
$ pod update 更新时使用
复制代码

8. 后期的升级维护 8.1. 更新远程公开库中的代码 8.2. 修改.podspec中的配置，version升级一个版本 8.3. 给当前的远程仓库的代码，从新打个tag，tag和.podspec的version同样 8.4. 远程仓库的代码更新完毕，接下来执行上面的 5.将当前本地的spec文件传到CocoaPods官方的索引库中 8.5. 检查使用上面的 6.测试一下，有没有上传到CocoaPods的索引库中

• 移除索引版本，纠正意外推送
• 移除该版本，而后从新push，在终端执行下面指令 $ pod trunk delete TTLockSDK 2.6.4（即：pod trunk delete 库名 版本号）
• 也能够放弃整个pod和全部版本 $ pod trunk deprecate TTLockSDK（即：pod trunk deprecate 库名） 确认时，回复一个"y"(小写字母 y)
• 清理CocoaPods本地缓存 特殊状况下，因为网络或者别的缘由，经过CocoaPods下载的文件可能会有问题

1. 手动删除(~/Library/Caches/CocoaPods/Pods/Release目录)
2. 打开终端,输入$ pod cache list,会列出全部本地已经缓存的第三方库，在终端中输入$ pod cache clean AAA会删除AAA缓存库，使用$ pod cache clean --all清除全部缓存

附：个人博客地址