2018/4/16 15:10:04当前位置推荐好文程序员浏览文章

   这篇文章详细的讲解如何发布自己的开源框架到Cocoapods,比较基础,如有错误,欢迎指正。

要点:

  • pod的版的本依赖于Git的tag,将一个tag视为工程的一次release
  • 一个pod版的本对应一个tag,pod版的本最好与tag一致
  • pod 命令能使消耗--verbose 开启啰嗦模式查看日志

一、创立github repository

image
  1. 项目名称:自己填写项目名称,最好是自己想发布的库的名称,方便管理
  2. 项目形容:可选项,形容当前项目
  3. 公开项目:选择public别人才可以看到和下载这个库,创立私有库需要$$
  4. README:一个好的项目需要一个README文件来详情库文件如何使消耗
  5. .gitignore: Git管理项目的忽略文件,一般选择对应语言就可,对其修改为Git管理知识,这里不做铺开
  6. 开源许可证:开源许可证,根据自己的需要设置,我选择MITcocoapods对开源许能设置比较在意,所以需要设置一个

二、克隆项目到本地

  1. 在github上找到项目的地址


    image
  2. 克隆项目到本地

$ git clone git@github.com:read0nly/DemoKit.git

  1. 将写好的开源库源代码放入本地的Git仓库下


    image

三、注册pod trunk

  要将一个开源库或者者私有库发布到pods之前你需要注册trunk

pod trunk register [email] [name] --description=[desc]

  • email:任意邮箱,推荐使消耗你注册github的邮箱
  • name:推荐使消耗github的name
  • desc:简单的形容信息

  例如我自己注册一个:

pod trunk register nj.readonly@gmail.com read0nly --description=macbook pro

  注册之后需要进入上面填的邮箱,点击链接进行邮箱验证 </br>
完成之后能使消耗pod trunk me检测能否注册成功

pod trunk me

  注册成功后将看到如下信息:

$ pod trunk me </br>

  • Name: read0nly</br>
  • Email: nj.readonly@gmail.com</br>
  • Since: April 12th, 08:49</br>
  • Sessions:</br>
    • April 12th, 08:49 - August 19th, 19:56. IP: 167.99.173.25

四、发布pod

1.创立.podspec

$ pod spec create [name]

  • name: podspec 文件的名称,一般与git上创立的repository名称相同</br>
    // 如:</br>
    pod spec create DemoKit

  执行此命令事实上是在当前目录创立了一个.podspec文件(纯文本文件),这个文件记录了pod发布执行的动作,以及资源配置信息。


image

2.修改.podspec文件

  .podspec文件生成之后里面有一个模板,有很多的注释和配置,比较全面,但是有些内容可可以是我们目前使消耗不到的。这里提供一个简洁版的的.podspec文件,假如后续有其余需求,例如子板块之类的,能再自行增加。

Pod::Spec.new do |s|



s.name = "DemoKit"

s.version = "0.0.1"

s.summary = "A demo for cocoapods."

s.homepage = " read0nly/DemoKit"

s.license = { :type => "MIT", :file => "LICENSE" }

s.author = { "nj" => "nj.readonly@gmail.com" }

s.platform = :ios, "8.0"

s.source = { :git => " read0nly/DemoKit.git", :tag => s.version.to_s }

s.requires_arc = true

s.source_files = "DemoKit/"

#s.exclude_files = ""

s.framework = "UIKit","Foundation"

s.swift_version = "4.0"
end

  • name:pod库的名字
  • version:版的本号
  • summary:总结
  • homepage :主页,项目在github上的主页
  • license :开源证书,type为类型,file是文件,注意文件路径,假如.podspec在同一目录下,能不写路径
  • author :作者,包含名字和联络方式
  • platform:支持的平台,这里支持iOS8,也能支持OSX,tvOS,watchOS等
  • source:项目源,写自己项目在github上的地址,要发布的版的本建议与pod版的本一致
  • requires_arc:能否支持arc
  • source_files:要包含的文件,/代表包含这个目录下面的所有文件,也可匹配某一个类型的文件,例如:DemoKit//.siwft 或者者 DemoKit//.{h,m}分别代表DemoKit下所有目录的swift 或者.h .m文件
  • exclude_files:不包含的文件,规则同上,假如在包含文件里面没有需要排除的文件,则删除此行
  • framework:依赖的系统库
  • swift_version:swift版的本,对于swift项目来说这个参数很重要,肯定要填写库文件所使消耗的swift版的本,否则会导致编译失败

  其余的配置信息,需要的时候能到Cocoapods项目官方文档podspec部分查阅

3.检验.podspec文件

  修改完.podspec文件之后,我们使消耗lint命令进行本地测试

pod lib lint

  能使消耗 --verbose 参数开启啰嗦模式,能查看详细日志信息

pod lib lint --verbose

  假如有错误,能根据错误提醒处理错误,文章最后部分列举了几种错误会决方式。假如有警告能不消耗管,也可尝试处理

4.将库文件打上tag,push到github

  • 查看没有提交的文件

git status -s

image
  • 增加所有文件

git add .

  • 提交文件

git commit -m commit version 0.0.1

  使消耗-m参数增加提交时候的日志信息,肯定要填

  • push 代码到github

git push

  • 打上标签 tag

git tag 0.0.1

  cocoapods发布依赖与标签tag,前面.podspec文件里面的版的本正是每一个tag的版的本,建议tag与需要发布的版的本相同

  • push tag到github

git push --tag

5.push到cocoapods

  使消耗push命令,发布自己的版的本库到cocoapods

pod trunk push DemoKit.podspec

  假如有警告能使消耗--allow-warnings选项允许警告

pod trunk push DemoKit.podspec --allow-warnings

  假如依赖了第三方库,需要加上 --use-libraries 选项

  发布成功之后能看到如下信息:

image

6.查看自己的pod库

  提交成功几分钟之后即可以使消耗pod search DemoKit 来查看自己的库了

pod search DemoKit

  假如查询不到,能尝试初始化,或者者升级本地的spec

pod repo init
pod repo update

  假如还是查询不到,能删除本地的pod索引文件

sudo rm ~/Library/Caches/CocoaPods/search_index.json

  删除之后再重新执行pod search

五、lint 错误

<span id = lint_issuse ></span>

NO.1

  • ERROR | [iOS] unknown: Encountered an unknown error (The Pods-App target has transitive dependencies that include static binaries: (/private/var/folders/m7/7t1r7_993fbgs40fppwxrsm80000gn/T/CocoaPods-Lint-20180301-60100-1meifl-Payment/Pods/openssl-ios-bitcode/lib/libcrypto.a /private/var/folders/m7/7t1r7_993fbgs40fppwxrsm80000gn/T/CocoaPods-Lint-20180301-60100-1meifl-Payment/Pods/openssl-ios-bitcode/lib/libssl.a)) during validation.

  依赖了其余库,增加--use-libraries选项

$ pod lib lint --use-libraries

NO.2

xcodebuild: error: Unable to find a destination matching the provided destination specifier:

{ id:6AC7A44D-6523-4371-AAAB-C5191451D58E }



Available destinations for the "App" scheme:

{ platform:iOS Simulator, id:9C15AC46-816E-4A85-9F21-A693CE34D542, OS:11.2, name:iPhone SE }

{ platform:iOS Simulator, id:626866A7-B843-4CCF-B27D-00420F5F16DB, OS:11.2, name:iPhone X }



Ineligible destinations for the "App" scheme:

{ platform:iOS, id:dvtdevice-DVTiPhonePlaceholder-iphoneos:placeholder, name:Generic iOS Device }

{ platform:iOS Simulator, id:dvtdevice-DVTiOSDeviceSimulatorPlaceholder-iphonesimulator:placeholder, name:Generic iOS Simulator Device }

Testing with xcodebuild.

  这个问题困扰了我很久,我是在查看cocoapods的issues#7454中才找理解决方案。问题起因因为本地模拟器设置,在“Generic iOS Device”设施下无法通过编译。目前暂行处理方式是在Xcode -> Window -> Devices & simulators 里面删除模拟器,直到剩下错误信息中“Available destinations”下的设施,或者者lint检验通过。

  遇到问题,能查看错误日志,或者者查看Cocoapods的issues来处理问题。

网友评论