iOS - cocoa pods 的使用

cocoapods官网查看

  • 创建Podspec描述文件,cd 到文件的跟目录下,在终端中输入pod spec create 描述文件名称,一般描述文件名称最好和项目名称一致。

pod spec create TestLib

Snip20171003_1.png

  • 在项目目录中可以查看到已创建成功的spec描述文件
Snip20171003_2.png
  • 用Xcode工具 打开项目中的spec描述文件 在文件中 需要设置以下内容:
  s.name         = "TestLib"  // 名称
  s.version      = "0.0.1"    // 版本
  s.summary      = "A short description of TestLib."  // 简介
  s.description  = “TestLib, 这个是详细描述 一定要注意! 字数比s.summary长 ”

  s.homepage     = "https://github.com/Mrhuangchina/testFiel" // 首页 以TestLib结尾。即以spec描述文件名称结尾 可以换成仓库地址
  s.license      = "MIT"
  s.author             = { "Mrhuangchina" => "xxxx@qq.com" } //这里的是你的Github里的名字 还要你的登录帐号邮箱
  Or just: s.author    = "Mrhuangchina"
  s.authors            = { "Mrhuangchina" => "xxxx@qq.com" }  //这里的是你的Github里的名字 还要你的登录帐号邮箱
       // source 这里 将改成你的spec描述文件的仓库地址  tag 和s.version 版本 保持一致 也就是Github仓库中的releases版本号
  s.source       = { :git => "https://github.com/Mrhuangchina/testFiel.git", :tag => "#{s.version}" }
        // 在指定该的文件中 ** 通配符 标示目录 *.{h,m}:* 代表的是文件夹
  s.source_files  = "Classes", "Classes/**/*.{h,m}"
  s.exclude_files = "Classes/Exclude"

Pod::Spec.new do |s|
  s.name             = "PodTestLibrary"    #名称
  s.version          = "0.1.0"             #版本号
  s.summary          = "Just Testing."     #简短介绍,下面是详细介绍
  s.description      = <<-DESC
                       Testing Private Podspec.
 
                       * Markdown format.
                       * Don't worry about the indent, we strip it!
                       DESC
  s.homepage         = "https://coding.net/u/wtlucky/p/podTestLibrary"                           #主页,这里要填写可以访问到的地址,不然验证不通过
  # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2"           #截图
  s.license          = 'MIT'              #开源协议
  s.author           = { "wtlucky" => "wtlucky@foxmail.com" }                   #作者信息
  s.source           = { :git => "https://coding.net/wtlucky/podTestLibrary.git", :tag => "0.1.0" }      #项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
  # s.social_media_url = 'https://twitter.com/<twitter_username>'                       #多媒体介绍地址
 
  s.platform     = :ios, '7.0'            #支持的平台及版本
  s.requires_arc = true                   #是否使用ARC,如果指定具体文件,则具体的问题使用ARC
 
  s.source_files = 'Pod/Classes/**/*'     #代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
  s.resource_bundles = {
    'PodTestLibrary' => ['Pod/Assets/*.png']
  }                                       #资源文件地址
 
  s.public_header_files = 'Pod/Classes/**/*.h'   #公开头文件地址
  s.frameworks = 'UIKit'                  #所需的framework,多个用逗号隔开
  s.dependency 'AFNetworking', '~> 2.3'   #依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
end</twitter_username>
Snip20171003_4.png
  • 在上述设置spec描述文件中,我们看到tag => "#{s.version} tagspec描述文件版本号需要一致,但我们并没有设置tag,所以接下来需要设置tag
git tag '0.0.1'   //设置tag 并且tag值必须和spec描述文件version一致
git push --tags  // 将tag 值 push 到远程仓库。
Snip20171003_5.png
Snip20171003_6.png
  • cocoapods官网中找到GUIDES里并找到Getting setup with Trunk 注册Trunk,其Trunk作用则是将我们之前创建的spec描述文件上传到cocoapods远程索引库中。
$ pod trunk register orta@cocoapods.org 'Orta Therox' --description='macbook air'  // 即下面这行解释  description 描述信息(可写可不写)
$ pod trunk register 邮箱地址 '名字' --verbose  //--verbose 打印一些详细信息

Snip20171003_8.png

在你刚刚填写的邮箱中打开收到的邮件注意有可能会在你的垃圾箱里,找到邮件打开里面的链接则完成显示如下图表示成功:

Snip20171003_11.png

依据刚刚验证的网站中的提示:在终端中输入:pod trunk push 描述文件名称

Snip20171003_12.png
-> TestLib (0.0.1)
    - ERROR | file patterns: The `source_files` pattern did not match any file.

[!] The spec did not pass validation, due to 1 error.

这个是在指定共享的类库时, 文件路径不对, 也就是设置 s.source_files字段时, 发生了错误, 这里的路径是相对于TestLib.podspec文件的, 如果是与TestLib.podspec同级的文件夹, 直接写文件夹名称即可, 如:

s.source_files = "TestLib"

如果有多级目录, 一定要逐级添加. 这里也可以这么写:

s.source_files = "TestLib/*.{h,m}"

需要注意的是s.source_files参数,如果配置为s.source_files = '/*.{h,m}’,会报错:

- ERROR | File Patterns: File patterns must be relative and cannot start with a slash (source_files).

其它可能的报错:

 - ERROR | [iOS] file patterns: The `source_files` pattern did not match any file.
  • pod search 项目名称 来验证是否上传到检索库成功
    • 搜索不到
      Unable to find a pod with name, author, summary, or description matching TestLib.
  • 解决办法:
    • 1.pod install --repo-update
    • 2.或者全部删除:使用命令:rm ~/Library/Caches/CocoaPods/search_index.json
    • 3.重新search GKFramework

可参考 cocoapods Error

  • —————————————————————————————
  • cocoapods 本地私有库的使用

    • 在本地私有库的文件中先创建一个spec文件
      Snip20171007_1.png
    • 修改spec文件中的source_file的路径,因为是本地私有库文件 所以直接删除远程库配置的git路径中的URL
      Snip20171007_2.png
    • 进入到需要引用本地私有库的工程文件中,并且创建Podfile文件
      Snip20171007_3.png
    • 修改Podfile文件,:patch =>'../TestLib/TestLib'代表在某个文件路径下寻找到spec文件,否则会自动在远程索引库中去寻找。
      Snip20171007_5.png
    • Pod install安装本地私有库文件,并可以在工程文件中使用。
  • —————————————————————————————
  • cocoapods 远程私有库的使用

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 162,825评论 4 377
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,887评论 2 308
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 112,425评论 0 255
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,801评论 0 224
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 53,252评论 3 299
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 41,089评论 1 226
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,216评论 2 322
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 31,005评论 0 215
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,747评论 1 250
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,883评论 2 255
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,354评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,694评论 3 265
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,406评论 3 246
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,222评论 0 9
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,996评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 36,242评论 2 287
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 36,017评论 2 281

推荐阅读更多精彩内容