以前搞过私有库,但太长时间过去了,脑子难免出现短路的情况。
正好最近项目要搞,记录下方便以后查看。
为什么要搞私有库?###
随着项目功能的增加,不同产品需要根据不同功能模块组合,每次重复改代码太麻烦了,工作量还大,查了些资料就有了几种方案。。
1. 在项目里面创建多个工程,每个功能模块用独立的工程管理。(当项目很大的时候,编译需要很多时间的时候,推荐用单独工程管理项目)
2. 在项目里创建多个静态库,每个功能模块开发后打成静态库。(PS:每次修改都要重新打静态库,太麻烦了)
3. 习惯把每个功能单独搞到一个文件夹的,可以直接用文件夹管理。(PS:我以前做企业级就这么搞的)
4. git submodules管理公共类模块。
5. Cocoapods的私有库管理。(PS:好东西都要留到最后啊。以前每次添加库的时候还要先看依赖哪些框架,添加framework引用,好麻烦的说,用过pod管理第三方的童鞋都知道,用着非常爽,一个Podfile文件,填下轮子地址执行下install就搞定了,创建私有库以后也可以用一个Podfile管理了)
如何创建一个私有库?###
1. 给模块项目打一个tag####
因为配置pod信息的时候可以用tag指定版本号
# 打tag
git tag -m "New tag" '0.1'
# 把tag推到远程仓库
git push --tags
2. 拉取项目(私有仓)到pods管理目录下####
先在托管仓库(github,Coding等)创建一个私有仓(一个文件夹)
这里我用的Coding托管的项目,至于为什么不用github(Coding私有库是免费的,墙内环境下访问速度超快,而且是中文的😊)
# pod repo add [私有项目名(repo库)] [clone地址]
$ pod repo add NNASpec https://git.coding.net/Leben-NNA/NNASpec.git
拉取完项目,会默认存在~/.cocoapods/repos这个目录下面,这里面有个master文件夹存的是缓存到本地的开源库的pods的.podspec.json格式配置信息,跟master同级你就会发现NNASpec(拉取的repo仓)的文件夹
#~/.cocoapods/repos 大致目录结构
├── repos
└── NNASpec
└── [VERSION]
└── [SPEC_NAME].podspec
3. 到要上传文件的项目里创建podspec配置文件####
这里要先到项目里(最好是readme,license文件同级)
# 创建podspec文件
$ pod spec create NNATree
podspec创建也可以使用一个叫CocoaPods的Xcode插件生成
创建好podspec文件以后,打开编辑会发现里面有很多参数需要配置,有很多注释信息说明参数作用
这里就举个栗子:(下面是我填写的配置信息)
注意:复制的时候删除后面的注释信息
Pod::Spec.new do |s|
s.name = "NNATree" # 这里要跟上面创建的spec文件名一致
s.version = "0.1" # 这里使用之前的tag
s.summary = "Create a tree by tableview."
s.homepage = "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git"
s.license = "MIT"
s.author = { "Leben NNA" => "leben.nna@gmail.com" }
s.platform = :ios, "7.0"
s.ios.deployment_target = "7.0"
s.source = { :git => "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git", :tag => "0.1" } # 这里使用之前的tag
s.source_files = 'MultilevelTree/*.{h,m}'
s.framework = "UIKit"
s.requires_arc = true
# s.dependency "AFNetworking", "~> 2.2.4"
end
一些参数的注释:
name: 导入pod后的目录名
version: 当前版本号
deployment_target: 配置的target
prefix_header_file: 预编译头文件路径,将该文件的内容插入到Pod的pch文件内
source: 来源的具体路径,是http链接还是本地路径
requires_arc: 是否需要arc
source_files: 指定该目录下包含哪些文件
其他可选参数还包括:
dependency: 指定依赖,如果依赖的库不存在或者依赖库的版本不符合要求将会报错
libraries: 指定导入的库,比如sqlite3
frameworks: 指定导入的framework
weak_frameworks: 弱链接,比如说一个项目同时兼容iOS6和iOS7,但某一个framework只在iOS7上有,这时候如果用强链接,那么在iOS7上运行就会crash,使用weak_frameworks可以避免这种情况。
通配符说明:
a{bb,bc}def.{h,m}表示四个文件abbdef.h abbdef.m abcdef.h abcdef.m
*.{h,m,mm}表示所有的.h .m .mm文件
Class/**/*.{h,m}表示Class目录下的所有.h .m文件
4. 测试下podspec配置文件是否有错误####
$ pod lib lint // 验证是否有合格
$ pod spec lint // 这个也可以验证
5. 提交代码####
# 提交代码
git commit -a -m "PodTest 0.1"
# 将本地的master分支推送到远程仓库
git push origin master
6. 创建一个trunk账号(用于上传到公共库Cocoapods)####
$ sudo gem install cocoapods // 先更新下Cocoapods版本
$ pod trunk register 邮箱 '昵称' --verbose // 填写账号信息,注册完要去邮箱点一个验证邮件(邮箱最好和git的邮箱保持一致)
$ pod trunk me // 验证完成后可以查看账号信息
7. 提交podspec到私有库####
# pod repo push [repo仓名] [podspec文件名]
$ pod repo push NNASpec NNATree.podspec
完成之后这个私有库就添加到我们的私有Spec Repo中,可以进入到~/.cocoapods/repos目录下查看
同时远端仓里也完成了推送
顺便把提交到cocoapods(公共库)的方法也提一句吧,前面的步骤都一样只需要用到上一步注册了的trunk提交就可以了
# 提交podspec文件到trunk
pod trunk push NNATree.podspec
8. 使用库####
Podfile中填写
source 'https://github.com/CocoaPods/Specs.git' // 公共库
source 'https://git.coding.net/Leben-NNA/NNASpec.git' // 私有库
platform :ios, '7.0'
pod 'NNATree/Tree', '0.1' // 使用某一个部分
pod 'NNATree', '0.1' // 使用整个库
然后在终端输入账号密码就可以引入私有库了
值得注意的一点:如果添加了私有库就需要加入source,默认是不需要添加的,source是用于找到仓库的
9. 删除一个私有库####
$ pod repo remove NNASpec
这样就从本地删除了
当然我们还可以通过下面的代码添加回来
$ pod repo add NNASpec git@coding.net:Leben-NNA/NNASpec.git
网友评论