一、创建私有的Spec Repo (备注:Git仓库1)
二、创建Pod项目工程,并且有可以访问的项目版本控制地址 (备注:Git仓库2)
三、创建并提交MyLib
Pod库的podspec文件到私有Spec Repo
仓库
四、使用制作好的Pod
说明:在以上步骤一、二中需要创建两个Git创库:
1、Git仓库1
的作用类似于CocoaPods的官方spec repo专门存放podspec具体可以参考:CocoaPods官方源、Specs;
2、Git仓库2
的是私有库的源码Git版本控制地址。
一、创建私有的Spec Repo
Spec Repo
是所有的Pods的一个索引,是所有公开的Pods 的podspec 文件的一个仓库,其实就是一个部署在服务器的Git仓库,当你使用CocoaPods 后它会被Clone到本地的 ~/.cocoapods/repos
目录下,大概的文件目录如下:
.
├── MySpecs
│ ├── MyLib
│ │ └── 0.1.1
│ │ └── MyLib.podspec
│ └── README.md
└── master
├── CocoaPods-version.yml
├── README.md
└── Specs
├── !ProtoCompiler
│ ├── 3.0.0
│ ├── 3.0.0-beta-3.1
│ └── 3.0.0-beta-4
├── !ProtoCompiler-gRPCPlugin
│ ├── 0.14.0
│ ├── 1.0.0
│ ├── 1.0.0-pre1
│ ├── 1.0.0-pre1.1
│ └── 1.0.0-pre1.2
Tip:~/.cocoapods/repos文件是一个隐藏目录,在Mac 上默认是看不到隐藏目录的,但是我们可以通过「终端」应用程序打开。在Terminal中执行以下命令显示隐藏文件:
$ defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder
执行以下命令恢复隐藏文件:
$ defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder
上文的目录树形图就是我电脑的本地的 ~/.cocoapods/repos
目录,其中master就是官方的Sepc Repo,跟master同目录级别的MySpecs目录就是我自己的创建的私有Sepc Repo
。
1、首先在coding.net上创建一个MySpecs
项目,当然你也是可以在公司内网创建的。
2、然后在Terminal中执行以下命令
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add MySpecs https://git.coding.net/kensla/MySpecs.git
注意:这个Git 仓库地址要换成你自己的创建的 Specs git 地址!!!成功后会在~/.cocoapods/repos目录下就能看到MySpecs了,至此,第一步创建私有Spec Repo就完成了。
二、创建Pod项目工程
1.创建Pod项目工程首先,在coding.net上创建一个MyLib
项目,当然你也是可以在公司内网创建的。然后,使用Cocoapods提供的一个Using Pod Lib Create 工具创建一个工程。
在Terminal中执行cd进入要创建项目的目录然后 执行以下命令:
#pod lib create [项目名]
$pod lib create MyLib
接着在Terminal控制台会输出:
Cloning `https://github.com/CocoaPods/pod-template.git` into `MyLib`.
Configuring MyLib template.
------------------------------
To get you started we need to ask a few questions, this should only take a minute.
If this is your first time we recommend running through with the guide:
- http://guides.cocoapods.org/making/using-pod-lib-create.html
( hold cmd and double click links to open in a browser. )
What language do you want to use?? [ Swift / ObjC ]
> ObjC
第一个问题是问你选择Swift还是Objc构建项目。此教程选的是ObjC
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
第二个问题问你是否需要创建一个Demo项目,此教程选的是Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> Specta
第三个问题让你是否选择一个测试框架,此教程选 Specta
Would you like to do view based testing? [ Yes / No ]
> Yes
第四个问题是否基于View测试,选Yes
What is your class prefix?
> ZYK
设置完成后控制台输出:
Running pod install on your new library.
[!] No `Podfile' found in the project directory.
Ace! you're ready to go!
We will start you off by opening your project in Xcode
open 'MyLib/Example/MyLib.xcworkspace'
The file /Users/ken/Desktop/工作/MyLib/Example/MyLib.xcworkspace does not exist.
To learn more about the template see `https://github.com/CocoaPods/ pod-template.git`.
To learn more about creating a new pod, see
`http://guides.cocoapods.org/making/making-a-cocoapod`.
成功后会在目录中创建好一个MyLib工程,结构如下:
Mylib
├── Example ** 这个是第二个问题的 Demo项目
│ ├── MyLib
│ │ ├── Images.xcassets
│ │ │ ├── AppIcon.appiconset
│ │ │ │ └── Contents.json
│ │ │ └── LaunchImage.launchimage
│ │ │ └── Contents.json
│ │ ├── Main.storyboard
│ │ ├── MyLib-Info.plist
│ │ ├── MyLib-Prefix.pch
│ │ ├── ZYKAppDelegate.h
│ │ ├── ZYKAppDelegate.m
│ │ ├── ZYKViewController.h
│ │ ├── ZYKViewController.m
│ │ ├── en.lproj
│ │ │ └── InfoPlist.strings
│ │ └── main.m
│ ├── MyLib.xcodeproj
│ │ ├── project.pbxproj
│ │ ├── project.xcworkspace
│ │ │ └── contents.xcworkspacedata
│ │ └── xcshareddata
│ │ └── xcschemes
│ │ └── MyLib-Example.xcscheme
│ ├── Podfile
│ └── Tests
│ ├── Tests-Info.plist
│ ├── Tests-Prefix.pch
│ ├── Tests.m
│ └── en.lproj
│ └── InfoPlist.strings
├── LICENSE
├── MyLib
│ ├── Assets
│ └── Classes
│ └── ReplaceMe.m **注意存放你自己实现的库相关代码!!!**
├── MyLib.podspec ** 库的podspec文件,这个是下一步需要重点配置的文件 !!!**
├── README.md
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj
2、添加实现代码
├── MyLib
│ ├── Assets
│ └── Classes
│ └── ReplaceMe.m **注意存放你自己实现的库相关代码!!!**
在本教程中我在上面的Classes文件目录添加了 MyLib.h、UIColor+Fetch.h、UIColor+Fetch.m 等几个文件。现在目录结构如下:
.
├── Example
│ ├── Build
│ │ ├── Intermediates
│ │ │ ├── MyLib.build
│ │ │ ├── Pods.build
│ │ │ └── PrecompiledHeaders
│ │ └── Products
│ │ └── Debug-iphoneos
│ ├── MyLib
│ │ ├── Images.xcassets
│ │ │ ├── AppIcon.appiconset
│ │ │ └── LaunchImage.launchimage
│ │ ├── Main.storyboard
│ │ ├── MyLib-Info.plist
│ │ ├── MyLib-Prefix.pch
│ │ ├── ZYKAppDelegate.h
│ │ ├── ZYKAppDelegate.m
│ │ ├── ZYKViewController.h
│ │ ├── ZYKViewController.m
│ │ ├── en.lproj
│ │ │ └── InfoPlist.strings
│ │ └── main.m
│ ├── MyLib.xcodeproj
│ │ ├── project.pbxproj
│ │ ├── project.xcworkspace
│ │ │ ├── contents.xcworkspacedata
│ │ │ └── xcuserdata
│ │ ├── xcshareddata
│ │ │ └── xcschemes
│ │ └── xcuserdata
│ │ └── zhongyuanke.xcuserdatad
│ ├── MyLib.xcworkspace
│ │ ├── contents.xcworkspacedata
│ │ └── xcuserdata
│ │ └── zhongyuanke.xcuserdatad
│ ├── Podfile
│ ├── Podfile.lock
│ ├── Pods
│ │ ├── Expecta
│ │ │ ├── Expecta
│ │ │ ├── LICENSE
│ │ │ └── README.md
│ │ ├── Expecta+Snapshots
│ │ │ ├── EXPMatchers+FBSnapshotTest.h
│ │ │ ├── EXPMatchers+FBSnapshotTest.m
│ │ │ ├── ExpectaObject+FBSnapshotTest.h
│ │ │ ├── ExpectaObject+FBSnapshotTest.m
│ │ │ ├── LICENSE.md
│ │ │ └── README.md
│ │ ├── FBSnapshotTestCase
│ │ │ ├── FBSnapshotTestCase
│ │ │ ├── LICENSE
│ │ │ └── README.md
│ │ ├── Headers
│ │ ├── Local\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ Podspecs
│ │ │ └── MyLib.podspec.json
│ │ ├── Manifest.lock
│ │ ├── MyLib
│ │ │ ├── LICENSE
│ │ │ ├── MyLib
│ │ │ └── README.md
│ │ ├── Pods.xcodeproj
│ │ │ ├── project.pbxproj
│ │ │ ├── project.xcworkspace
│ │ │ └── xcuserdata
│ │ ├── Specta
│ │ │ ├── LICENSE
│ │ │ ├── README.md
│ │ │ └── Specta
│ │ └── Target\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ Support\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ Files
│ │ ├── Expecta
│ │ ├── Expecta+Snapshots
│ │ ├── FBSnapshotTestCase
│ │ ├── MyLib
│ │ ├── Pods-MyLib_Example
│ │ ├── Pods-MyLib_Tests
│ │ └── Specta
│ └── Tests
│ ├── Tests-Info.plist
│ ├── Tests-Prefix.pch
│ ├── Tests.m
│ └── en.lproj
│ └── InfoPlist.strings
├── LICENSE
├── MyLib
│ ├── Assets
│ └── Classes ## 把你的库代码放在这个Classes文件夹 !!!##
│ ├── MyLib.h
│ └── UIColor+Category
│ ├── UIColor+Fetch.h
│ └── UIColor+Fetch.m
├── MyLib.podspec
├── RE.md
├── README.md
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj
3.开发模式下测试pod库的代码(可以略过这个步骤)
打开Example工程目录Podfile文件:
pod 'MyLib', :path => '../' # 指定路径
#pod 'MyLib', :podspec => '../MyLib.podspec' # 指定podspec文件
然后在Example工程目录下执行 pod update
命令安装依赖,打开项目工程,可以看到库文件都被加载到Pods子项目中了不过它们并没有在Pods目录下,而是跟测试项目一样存在于Development Pods/MyLib中,这是因为我们是在本地测试,而没有把podspec文件添加到Spec Repo中的缘故。测试库文件没有问题,接着我们需要执行第4步
4.提交Pod库到Git仓库2在Terminal
中执行 cd进入MyLib项目根目录然后,执行以下命令:
$ git add .
$ git commit -s -m "初始化MyLib 库"
$ git remote add origin git@git.coding.net:kensla/MyLib.git #添加远端仓库
$ git push origin master #提交到远端仓库
$ git tag -m "first release" "0.1.0" #打上标签,这个很重要
$ git push --tags #推送tag到远端仓库
到这里,成功提交到远程 Git仓库2,MyLib Pod 库就初步完成了代码实现
三、创建并提交MyLib
Pod库的podspec文件到私有Spec Repo仓库
1.配置MyLibPod库的podspec 文件
#
# Be sure to run `pod lib lint MyLib.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
#名称
s.name = 'MyLib'
#版本号
s.version = '0.1.0'
#简介
s.summary = '这个是我的私有库项目Demo.'
# This description is used to generate tags and improve search results.
# * Think: What does it do? Why did you write it? What is the focus?
# * Try to keep it short, snappy and to the point.
# * Write the description between the DESC delimiters below.
# * Finally, don't worry about the indent, CocoaPods strips it!
s.description = <<-DESC
这个是教程的 私有库项目 学习Demo.
DESC
#主页,这里要填写可以访问到的地址,不然验证不通过
s.homepage = 'https://coding.net/u/kensla'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
#开源协议
s.license = { :type => 'MIT', :file => 'LICENSE' }
#作者
s.author = { 'kensla' => '604217454@qq.com' }
#项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS。
#这里的s.source须指向存放源代码的链接地址,而不是托管spec文件的repo地址
s.source = { :git => 'https://git.coding.net/kensla/MyLib.git', :tag => "0.1.0" }
#s.social_media_url = 'http://weibo.com/kensla'
#支持的平台及版本
s.ios.deployment_target = '7.0'
#代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则
#用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
s.source_files = "MyLib/Classes/**/*"
#资源文件地址
# s.resource_bundles = {
# 'MyLib' => ['MyLib/Assets/*.png']
# }
#公开头文件地址
#s.public_header_files = 'MyLib/Classes/DDCommonBase.h'
#所需的framework,多个用逗号隔开
s.frameworks = 'UIKit'
#依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
# s.dependency 'AFNetworking', '~> 2.3'
end
打开MyLib工程目录下的MyLib.podspec文件并参考上面的说明配置好相关选项。podspec更多配置请参考:官方文档
2.编辑完MyLib.podspec文件后,需要验证一下这个MyLib.podspec文件是否可用
在Terminal中执行cd进入MyLib项目根目录然后,执行以下命令:
$ pod lib lint
当你看到 Terminal 中输出:
-> MyLib (0.1.0)
MyLib passed validation.
表示这个MyLib.podspec 验证通过,是一个符合CocoaPods规则的配置文件。
3.本地测试MyLib.podspec文件(可以略过这个步骤)
打开Example工程目录Podfile文件修改下pod 的引用
#pod 'MyLib', :path => '../' # 指定路径
pod 'MyLib', :podspec => '../MyLib.podspec' # 指定podspec文件
然后在Example工程目录下执行pod update命令安装依赖,打开项目工程,现在可以看到库文件都被加载到Pods子项目中了
4.向Spec Repo提交podspec测试库文件没有问题我们就把MyLib.podspec提交到远程Spec Repo仓库中,就是本文开头说的Git仓库1在Terminal中执行 cd进入MyLib项目根目录然后,执行以下命令:
# pod repo push [Repo名] [podspec 文件名字]
$ pod repo push MySpecs MyLib.podspec
如果提交成功,在Terminal会输出:
Validating spec
-> MyLib (0.1.0)
Updating the `MySpecs' repo
Already up-to-date.
Adding the spec to the `MySpecs' repo
- [No change] MyLib (0.1.0)
Pushing the `MySpecs' repo
Username for 'https://git.coding.net': kensla
Password for 'https://kensla@git.coding.net':
To https://git.coding.net/kensla/MySpecs.git
59b080c..b44123d master -> master
表示提交成功了!这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/MySpecs目录下查看
.
├── MyLib
│ └── 0.1.0
│ └── MyLib.podspec
└── README.md
再去看我们的Spec Repo远端仓库 也就是Git仓库1,也有了一次提交,这个podspec也已经被Push上去了。
至此,我们的这个组件库就已经制作添加完成了,使用pod search命令就可以查到我们自己的库了.在Terminal中执行 pod search MyLib
-> MyLib (0.1.0)
这个是我的私有库项目Demo.
pod 'MyLib', '~> 0.1.0'
- Homepage: https://coding.net/u/kensla
- Source: https://git.coding.net/kensla/MyLib.git
- Versions: 0.1.0 [MySpecs repo]
四、使用制作好的Pod
在完成这一系列步骤之后,我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下一行代码即可,
在正式项目的Podfile 里添加私有Spec Repo
#私有Spec Repo
source 'https://git.coding.net/kensla/DDSpecs.git'
pod 'MyLib', '~> 0.1.0'
然后执行pod update,更新库依赖,然后打开项目可以看到,我们自己的库文件已经出现在Pods子项目中的Pods子目录下了,而不再是Development Pods。
声明:本文取自 http://www.jianshu.com/p/107cc74847ab,http://www.cnblogs.com/baitongtong/p/6681554.html
下面是在制作过程中遇到的问题:
以把支付宝SDK做成私有库为例,.podspec关于第三方.framework(vendored_frameworks) 、系统.framework 、.bundle 文件 、系统. libraries、第三方.libraries(vendored_libraries)等 的写法
cocoapods官方文档:
https://guides.cocoapods.org/syntax/podspec.html
工程目录:
.podspec写法:
注意根据支付宝官方文档添加系统 .framework . libraries,就是这一部分: