iOS-创建私有仓库步骤
一、创建本地pod私有库
cd到你想创建pod库工程的路径,并执行pod库的创建。命令如下:
mizhifadeMacBook-Pro:~ mizhifa$ cd /Users/mizhifa/Desktop/组件库
mizhifadeMacBook-Pro:组件库 mizhifa$ pod lib create MZFTestModule
回车,回答以下问题:
# 选择使用平台
What platform do you want to use?? [ iOS / macOS ]
> iOS
# 选择编程语言
What language do you want to use?? [ Swift / ObjC ]
> ObjC
# 是否创建一个demo工程,为了方便测试,选择Yes
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
# 选择测试框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> None
#是否需要视图测试
Would you like to do view based testing? [ Yes / No ]
> Yes
#demo工程的class前缀
What is your class prefix?
> MZF
回车,本地pod私有库创建工程成功。
二、安装CocoaPods项目
1.找到刚才创建的MZFTestModule文件夹,点击入去,里面的目录如下:
MZFTestModule
├── Example #demo DemoAPP
│ ├── MZFTestModule
│ ├── MZFTestModule.xcodeproj
│ ├── MZFTestModule.xcworkspace
│ ├── Podfile #demo APP 的依赖描述文件
│ ├── Podfile.lock
│ ├── Pods #demo APP 的依赖文件
│ └── Tests
├── LICENSE #开源协议 默认MIT
├── MZFTestModule #组件的目录
│ ├── Assets #资源文件
│ └── Classes #类文件
├── MZFTestModule.podspec #第三步要创建的podspec文件
└── README.md #markdown格式的README
2.cd到Example文件夹下,安装CocoaPods项目:
mizhifadeMacBook-Pro:组件库 mizhifa$ cd /Users/mizhifa/Desktop/组件库/MZFTestModule/Example
mizhifadeMacBook-Pro:Example mizhifa$ pod install --no-repo-update
进去Example文件夹点击.xcworkspace的文件打开项目,运行下是否成功。
三、编辑私有库
1.添加代码文件和资源文件(复制粘贴)
把需要添加的文件放到Classes文件夹下,
把资源文件(图片,字体文件等)放到Assets文件夹下
2.编辑 .podspec配置文件
打开.podspec文件填写相关配置选项
Pod::Spec.new do |s|
# 名称
s.name = 'MZFTestModule'
#版本号
s.version = '0.1.0'
#简短介绍
s.summary = '简介'
#详细介绍
s.description = <<-DESC
MZFTestModule description
DESC
#主页,这里要填写可以访问到的地址,不然验证不通过
s.homepage = 'https://www.baidu.com'
#截图
# s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
#开源协议
s.license = 'MIT'
#作者信息
s.author = { 'dingyuping' => 'dingyuping@51nbapi.com' }
#项目地址,不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS,这里用的码云(免费的)
s.source = { :git => 'https://gitee.com/xingxingstyle/MZFTestModule.git', :tag => s.version.to_s }
#多媒体介绍地址
# s.social_media_url = 'https://twitter.com/<twitter_username>'
#支持的平台及版本
s.ios.deployment_target = '8.0'
#是否使用ARC,如果指定具体文件,则具体的文件使用ARC
#s.requires_arc = true
#代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
s.source_files = 'podTestLibrary/Classes/**/*'
#资源文件地址
s.resource_bundles = {
'MZFTestModule' => ['MZFTestModule/Assets/*.png']
}
#公开头文件地
#s.public_header_files = 'MZFTestModule/Classes/**/*.h'
# buildsetting相关设置, 这里讲bitcode设置为NO, C++ Standard Library设置为libstdc++
#s.xcconfig = {
# 'ENABLE_BITCODE' => 'NO',
# 'CLANG_CXX_LIBRARY' => 'libstdc++'
# }
#该pod依赖的系统framework,多个用逗号隔开
#s.frameworks = 'UIKit','CoreGraphics'
#该pod依赖的系统library,多个用逗号隔开
#s.libraries = 'iconv','sqlite3','stdc++','z'
#第三方.a文件
#s.vendored_libraries = 'MZFTestModule/Classes/ThirdParty/*.a'
#第三方frameworks文件
#s.vendored_frameworks = 'MZFTestModule/Classes/ThirdParty/*.framework'
#依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
#s.dependency 'AFNetworking', '~> 2.3'
end
3.配置完成后,再次cd到Example文件夹下,更新pod:
mizhifadeMacBook-Pro:Example mizhifa$ pod update --no-repo-update
更新完成后打开项目看能能否正常运行,并验证导入的文件是否能调用
四、提交到私有仓库
1.验证pod配置文件
为了保证项目正确性,pod文件配置没问题,在提交之前,我们需要验证一下:
# cd到项目目录
mizhifadeMacBook-Pro:Example mizhifa$ cd /Users/mizhifa/Desktop/组件库/MZFTestModule
# pod lib lint 为验证本地仓库
# pod spec lint 为验证远程仓库
# 如过有警告存在,会验证不通过,需要加 --allow-warnings 忽略警告
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ pod lib lint --allow-warnings
2.提交代码到私有仓库
cd到该项目文件下执行git的相关命令:
# 添加远程地址,即上面创建码云项目的地址
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git remote add origin https://gitee.com/xingxingstyle/MZFTestModule.git
# 添加文件
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git add .
# 提交本地,并写描述
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git commit -a -m '提交代码'
# git pull origin maste会失败 ,提示:fatal: refusing to merge unrelated histories
# 原因是远程仓库origin上的分支master和本地分支master被Git认为是不同的仓库,所以不能直接合并,需要添加 --allow-unrelated-histories
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git pull origin master --allow-unrelated-histories
# 推送到远程仓库的master分支上
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git push origin master
完成后,去私有库查看,就可以看到项目已经在私有仓库里了。
五、添加tag
终端执行以下命令:
# 新增tag
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git tag -a '版本号' -m '描述'
# push到远程tag分支
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git push --tags
完成后就可以看到私有仓库已经有一个tag存在了。
六、创建Spec索引库
索引库地址创建和私有库创建一样,这里也是用的码云。
在终端执行命令:
# 添加本地索引库
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ pod repo add MZFTestModule https://gitee.com/xingxingstyle/MZFSpecs.git
# MZFTestModule是刚才上面添加的管理库名字
# MZFTestModule.podspec是MZFTestModule项目里面后缀为podspec的文件名
# push的时候会先验证,同样要忽略警告,添加--allow-warnings
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ pod repo push MZFTestModule MZFTestModule.podspec --allow-warnings
发布成功后,我们就可以在索引库中看到MZFTestModule的索引文件了。
到这里我们的私有库已经发布完成了。
七、在项目中使用私有库
新建项目一个项目,创建Podfile文件并安装
Podfile文件代码如下:
# pod 默认是从公有源查找的,需要添加私有库源和共有库源
# 只添加私有库源默认会只从私有库查找,所以需要同时添加公有库源
source 'https://gitee.com/xingxingstyle/MZFSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
inhibit_all_warnings!
use_frameworks!
target 'podDemo' do
pod 'MZFTestModule'
end
终端执行以下命令:
mizhifadeMacBook-Pro:~ mizhifa$ cd /Users/mizhifa/Desktop/podDemo
mizhifadeMacBook-Pro:podDemo mizhifa$ pod install --no-repo-update
成功如下图:
在项目中导入私有库头文件,验证能否调用。
到这里私有库的使用已经完成了!!!