iOS-使用CocoaPods在私人Pod Specs发布pod仓库

由于GitHub访问太慢,我在Gitee上搭建

环境准备

  • 安装Xcode
  • 安装cocoapods

公共Specs

使用cocoapods,如果不指定仓库来源的话,默认为公共Specs:https://github.com/CocoaPods/Specs.git

如果 pod install 太慢可以指定来源为cocoapods在gitee的镜像:https://gitee.com/mirrors/CocoaPods-Specs.git

在Podfile上面添加指定来源:

source 'https://gitee.com/mirrors/CocoaPods-Specs.git'

创建个人specs远程仓库

在gitee上创建一个带有Readme 文件的仓库,命名为CSPublicSpecs(名称自己决定)
PS:这里不能创建空仓库,否则会导致无法推送podspec

添加创建好的specs到本地:

pod repo add CSPublicSpecs https://gitee.com/hcsaaron/cspublic-specs.git

添加成功后,可以在本地~/.cocoapods/repos下看到CSPublicSpecs

新建本地仓库

默认模板 创建

pod lib create CSPublicSDK

指定模板创建

pod lib create CSPublicSDK --template-url=https://gitee.com/Pods-Lib/pod-template.git

等待下载模板完成后,按步骤选择类型

基于已有的本地仓库

  1. cd到xxx.xcodeproj工程目录下
  2. 执行pod spec create xxx生成xxx.podspec文件,修改相关配置
  3. 执行pod init生成Podfile文件,添加依赖
  4. 执行pod install生成. xcworkspace

编辑.podspec

根据自己项目情况修改.podspec文件,关于Podspec的学习,请看 CocoaPods - Podspec Syntax Reference

Pod::Spec.new do |s|
  s.name             = 'CSPublicSDK'
  s.version          = '0.1.0'
  s.summary          = 'A short description of CSPublicSDK.'

  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://gitee.com/hcsaaron/cspublic-sdk'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'hcsaaron@163.com' => 'hcsaaron@163.com' }
  s.source           = { :git => 'https://gitee.com/hcsaaron/cspublic-sdk.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '9.0'

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

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

创建远程仓库

在gitee上创建一个名为CSPublicSDK的仓库(名称自己决定)

创建完成后复制git地址为:https://gitee.com/hcsaaron/cspublic-sdk.git

将本地仓库关联远程仓库:

git remote add origin https://gitee.com/hcsaaron/cspublic-sdk.git

将所有文件暂存:

git add .

提交:

git commit -m "初次提交"

推送到远程仓库:

git push -u origin master

推送成功:

Enumerating objects: 79, done.
Counting objects: 100% (79/79), done.
Delta compression using up to 16 threads
Compressing objects: 100% (70/70), done.
Writing objects: 100% (79/79), 27.92 KiB | 5.58 MiB/s, done.
Total 79 (delta 17), reused 0 (delta 0)
remote: Powered by GITEE.COM [GNK-5.0]
To https://gitee.com/hcsaaron/cspublic-sdk.git
 * [new branch]      master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.

打开https://gitee.com/hcsaaron/cspublic-sdk可以看到远程仓库已经更新了

验证.podspec文件

cd到xxx.podspec文件所在目录下:

pod lib lint

验证失败,报错:

[!] CSPublicSDK did not pass validation, due to 2 warnings (but you can use `--allow-warnings` to ignore them).
You can use the `--no-clean` option to inspect any issue.

则按提示添加--allow-warnings参数:

pod lib lint --allow-warnings

看到以下提示,则说明验证成功:

CSPublicSDK passed validation.

如果pod lib lint验证失败,可以视情况附加以下参数:
--verbose:查看详细信息
--allow-warnings:允许警告,用到第三方框架时,用这个参数可以屏蔽警告
--use-libraries:如果用到的第三方库需要使用库文件的话,会用到这个参数
--sources:如果一个库的podspec包含除了cocoapods仓库以外的其他库的引用,则需要改参数指明,用逗号分隔。例如:pod lib lint --sources='https://gitee.com/hcsaaron/cspublic-sdk.git'
还有另外两个参数可以使用:
--fail-fast:在出现第一个错误时就停止
--subspec=Name:用来校验某个子模块的情况

发布podspec

打tag并push到远程(tag版本号要和podspec中的s.version一致):

git tag '0.1.0'
git push --tags

CSPublicSDK.podspec提交到CSPublicSpec中:

pod repo push CSPublicSpecs CSPublicSDK.podspec

如果报错,则添加--allow-warnings参数:

pod repo push CSPublicSpecs CSPublicSDK.podspec --allow-warnings

推送成功后,可以看到CSPublicSpecs已经有对应的.podspec

搜索一下自己刚刚发布的pod库:

pod search CSPublicSDK

已经可以搜出来了

集成SDK

新建demo工程:

cd进demo工程目录,执行pod init生成Podfile

pod init

编辑Podfile添加pod 'CSPublicSDK', '~> 0.1.0',还需指定来源source 'https://gitee.com/hcsaaron/cspublic-specs.git'

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

source 'https://gitee.com/hcsaaron/cspublic-specs.git'

target 'CSDemo' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for CSDemo
  pod 'CSPublicSDK', '~> 0.1.0'

end

然后执行pod install生成.xcworkspace

pod install

已经可以愉快地使用了

参考资料

CocoaPods - Using Pod Lib Create

CocoaPods - Podspec Syntax Reference

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

推荐阅读更多精彩内容