美文网首页
私有库的使用

私有库的使用

作者: hard_coder | 来源:发表于2017-04-21 16:12 被阅读0次

    Cocoapods是iOS的一个依赖管理工具,支持swift和OC语言。支持超过10000个第三方开源库。使用它可以方便的管理和更新项目中使用到的第三方库。也可以将自己的项目中的公共组件交由它去管理。当我们的项目想要抽出来作为一个第三方库交由cocoapods去管理,并且只是给内部人员使用,那么就需要使用私有库。每种语言发展到一个阶段,就会出现响应的依赖管理工具,例如 Java 语言的 Maven,nodejs 的 npm。随着 iOS 开发者的增多,CocoaPods的出现是必然的。
    安装cocoapods:
    gem服务器在国外,提供了非常丰富的终端应用程序!gem服务器需要一个ruby的运行环境,mac电脑上本身有ruby的运行环境。但是gem服务器具有防火墙,不易访问,淘宝制作了一个镜像文件,每隔15分钟就去与gem服务器进行一次数据同步,所以国内人使用只需要访问淘宝的镜像文件就可以。
    第一步:查看gem原 gem source –l

    第二步:添加源(淘宝源)sudo gem sources -a https://ruby.taobao.org/

    第三步:查看源 gem source –l

    第四步:删除ruby源 sudo gem sources -r https://rubygems.org/

    第五步:再次查看源,此时只有淘宝源 gem source –l

    第六步:安装Cocopods(gem服务器会自动帮助我们安装) sudo gem install cocoapods

    第七步:设置源 pod setup 将会在终端看到Setup completed代表成功(还有一点需要注意,pod setup 在执行时,会输出 Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods 目录下的master下面,如果你等太久,可以试着 cd 到那个目录,用 du -sh * 来查看下载进度。你也可以使用 CocoaPods 的镜像索引来提高下载速度。所有的项目的 Podspec 文件都托管在 https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods 目录下,这个索引文件比较大,有 80M 左右。所以第一次更新时非常慢,笔者就更新了将近一个小时才完成。)
    也可以删除podrepo中的东西。可以使用下面的命令:
    pod repo remove master //删除本地的repo
    //删除完了也可以再加上
    pod repo add master https://github.com/CocoaPods/Specs

    创建私有库:
    1:创建私有的 spec Repo
    先来说第一步,什么是Spec Repo?他是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,他实际是一个Git仓库remote端
    在GitHub上,但是当你使用了Cocoapods后他会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。这个master目录的结构是这个样子的
    .
    ├── Specs
    └── [SPEC_NAME]
    └── [VERSION]
    └── [SPEC_NAME].podspec
    创建私有的spec repo
    进入到~/.cocoapods/repos目录下,然后在终端输入:
    pod repo add LFDBusSpec http://****.****.cn/****/LeFinancePods.git
    LFDBusSpec:本地私有的Spec Repo的名字。
    http://****.cn/****/LeFinancePods.git:申请一个git远程仓库用来管理每次podSpec文件的变化。
    此时如果成功的话进入到~/.cocoapods/repos目录下就可以看到LFDBusSpec这个目录了。至此第一步创建私有Spec Repo完成。当然此时这个文件夹是个空的。
    创建pod项目工程文件:
    使用命令创建一个pod项目:
    pod lib create LFDBusPrivateProject,之后他会问你四个问题,1.是否需要一个例子工程;2.选择一个测试框架;3.是否基于View测试;4.类的前缀;4个问题的具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。创建完成之后就可以打开你创建的pod项目啦。项目的结构是:
    PodTestLibrary
    ├── Example #demo APP
    │ ├── PodTestLibrary
    │ ├── PodTestLibrary.xcodeproj
    │ ├── PodTestLibrary.xcworkspace
    │ ├── Podfile #demo APP 的依赖描述文件
    │ ├── Podfile.lock
    │ ├── Pods #demo APP 的依赖文件
    │ └── Tests
    ├── LICENSE #开源协议 默认MIT
    ├── Pod #组件的目录
    │ ├── Assets #资源文件
    │ └── Classes #类文件
    ├── PodTestLibrary.podspec #第三步要创建的podspec文件
    └── README.md #markdown格式的README
    在Class项目中有一个Replaceme的文件,将自己写好的framework放到classs文件夹即可。
    编辑podSpec文件:

    Pod::Spec.new do |s|
    s.name = 'LeNetworkFrame' //私有库的名字
    s.version = '0.1.1' //每次提交的tag值
    s.summary = 'this is a summary' //总结

    s.description = <<-DESC //描述
    LeFinance Cashier SDK for iOS. Including Pay functions.
    DESC

    s.homepage = 'http://****/****/NetworkPrivatePod' //私有库的地址,主页,这里要填写可以访问到的地址,不然验证不通过

    s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2' //截图

    s.license = { :type => 'MIT', :file => 'LICENSE' } //开源协议
    s.author = { '1203646961@qq.com' => 'xuli5@le.com' } //作者信息
    s.source = { :git => 'http://legitlab.letv.cn/finance_mobile/NetworkPrivatePod.git', :tag => s.version.to_s }
    //项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS

    s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>' //多媒体介绍地址

    s.ios.deployment_target = '8.0'    //支持的平台及版本
    

    s.source_files = 'LeNetworkFrame/Classes//.{h,m}' //代码源文件地址,/
    表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置

    s.resource_bundles = {

    'LeNetworkFrame' => ['LeNetworkFrame/Assets/*.png']

    } //资源文件地址

    s.public_header_files = 'Pod/Classes/*/.h' //公开头文件地址

    s.frameworks = 'UIKit', 'MapKit' //所需的framework,多个用逗号隔开
    s.dependency 'AFNetworking' //依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
    s.dependency 'Mantle'
    end
    验证podspec文件,进入到podspec文件的上级目录中,在终端输入:
    pod lib lint 验证通过后就可以将私有库的项目打上tag值推送到远端啦。
    向spec repo提交podspec
    向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令
    进入到podspec所在的文件的上层目录后,在终端输入:
    pod repo push LFDBusSpec LFDBusFrameWork.podspec
    LFDBusSpec:本地私有spec repo的名字,
    LFDBusFrameWork.podspec:podspec文件的名字
    完成之后这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/WTSpecs目录下查看
    ├── LICENSE
    ├── LFDBusSpec
    │ └── 0.1.0
    │ └──LFDBusFrameWork
    └── README.md
    再去看我们的Spec Repo远端仓库,也有了一次提交,这个podspec也已经被Push上去了。至此,我们的这个组件库就已经制作添加完成了,使用pod search命令就可以查到我们自己的库了
    在完成这一系列步骤之后,我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下一行代码即可
    pod 'LFDBusFrameWork'
    然后执行pod update,更新库依赖,然后打卡项目可以看到,我们自己的库文件已经出现在Pods子项目中的Pods子目录下了,而不再是Development Pods。
    pod update首先回去repo spec中查找到podspec文件,通过source.name验证是否与podfile中的名字是否一致,验证成功后,就会根据 Podspec 中的 s.source_files 找到需要导入代码文件,并通过其他的数据找到对应的配置文件或资源文件等。最后,将其下载到本地项目中。

    比较好的文章:
    http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/
    http://www.jianshu.com/p/fb202af858fd

    相关文章

      网友评论

          本文标题:私有库的使用

          本文链接:https://www.haomeiwen.com/subject/smedzttx.html