1.创建项目
点击create project 输入项目名称 点击创建
2.添加ssh key
为了减少频繁的输入GitLab的账号和密码,这里使用ssh key拉取或者提交代码(不需要输入密码)
2.1创建ssh key
新建ssh-key&重新命名
//切换到ssh目录
cd ~/.ssh
//新建ssh-key 注your_email@example.com为gitlab的邮箱 这里替换为15801635316@163.com
ssh-keygen -t rsa -C"your_email@example.com"
//为新建的ssh-key重新命名id_ras_rename可自行修改
Enter file in which to save the key (/Users/zhujie/.ssh/id_rsa):id_ras_rename
新ssh-key添加到ssh agent中
因为默认只读取id_rsa,为了让SSH识别新的私钥,需将其添加到SSH agent中
ssh-add ~/.ssh/id_ras_rename
配置 将不同账号的工程图服务器与ssh-key关联,账户以及git服务器与对应的密钥关联。
在~/.ssh目录下找到config文件,如果没有就创建:
touch config
config配置如下:
# 该文件用于配置私钥对应的服务器
# Default github user(first@mail.com)
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa
# second user(second@mail.com)
# 建一个github别名,新建的帐号使用这个别名做克隆和更新
Host github2
HostName github.com
User git
IdentityFile ~\.ssh\id_ras_rename
其规则就是:从上至下读取config的内容,在每个Host下寻找对应的私钥。这里将GitHub SSH仓库地址中的git@github.com替换成新建的Host别名如:github2,那么原地址是:git@github.com:funpeng/Mywork.git,替换后应该是:github2:funpeng/Mywork.git.
查看公钥
vim~/.ssh/id_ras_rename.public
然后将内容复制添加到服务器账号里面
2.2GitLab输入 ssh key
2.3验证是否正确
对项目的地址进行复制选择 git@的地址,这里为git@10.211.55.3:zhujie/networkmodule.git
使用sourcetree拉取代码 新建->从URL克隆->输入地址git@10.211.55.3:zhujie/networkmodule.git-> 回车->等待如图所示下方红框位置加载->出现 这是一个Git仓库 代表ssh-key成功。
3.远程私有库的基本使用
3.1创建远程索引私有库
这里以GitLab为例,创建一个ZJSpecs的私有索引库,这玩意的作用如其名,就是用来索引的
3.2本地添加私有索引库
查看本地索引库
pod repo list
添加私有索引库
将我们刚刚新建的私有索引库ZJSpecs添加到本地
// pod repo add 索引库名称 索引库地址
pod repo add ZJSpecs http://10.211.55.3/zhujie/ZJSpecs.git
3.3创建组件库
3.3.1在gitlab上创建项目
在1.创建项目中,已经创建项目,这里不再创建,未创建项目的按照1.创建项目步骤进行创建
3.3.2快速创建模版库
// pod lib create 组件名
pod lib create NetworkModule
3.3.3安装与测试本地库
创建完成后会自动帮我们打开相应的Example项目, NetworkModule目录中会出现如图这些文件,我们把基础组件相关的东西丢到Classes文件夹中,并且把ReplaceMe.m文件删除
执行pod install,同步到本地库。并在Example中运行程序,确保组件的可用。
3.3.4修改Spec
主要修改内容
s.name='NetworkModule'
s.version='0.1.0'
s.summary='网络请求组件库'
s.description=<<-DESC
s.homepage='http://10.211.55.3/zhujie/NetworkModule'
s.source={:git=>'http://10.211.55.3/zhujie/NetworkModule.git',:tag=>s.version.to_s}
s.swift_version = ['5.0']
s.source_files='NetworkModule/Classes/**/*'
3.4上传组件代码
3.4.1将代码提交到组件仓库
cd existing_folder
git init
git remote add origin git@10.211.55.3:zhujie/networkmodule.git
git add .
git commit -m "Initial commit"
git push -u origin master
3.4.2打标签
标签0.1.0与spec中的s.version保持一致
git tag '0.1.0'
git push --tags
3.5提交podspec到私有索引库
在上传spec文件前我们可以做一个验证来节省时间,不然每次都推送很久结果还是验证失败
3.5.1本地验证Spec的必填字段
pod lib lint
如果验证的是私有库,则在后面加上--private,否则会有警告,你可以选择--allow-warnings来忽略该警告
pod lib lint --private --allow-warnings
3.5.2远程校验
pod spec lint
如果验证的是私有库,则在后面加上--private,否则会有警告,你可以选择--allow-warnings来忽略该警告
pod spec lint --private --allow-warnings
3.5.3提交podspec
pod repo push ZJSpecs NetworkModule.podspec
如果提交不成功,出现错误,查看是否提交版本和本地版本是否一致,然后重新执行以下命令行。
cd existing_folder
git init
git remote remove origin
git remote add origin git@10.211.55.3:zhujie/networkmodule.git
git add .
git commit -m "commit"
git push -u origin master
git tag -d '0.1.0'
git tag '0.1.0'
git push --tags
pod lib lint --private --allow-warnings
pod spec lint --private --allow-warnings
pod repo push ZJSpecs NetworkModule.podspec
提交成功,再来看看GitLab上的私有索引库ZJSpecs。
测试下搜索我们的组件
pod search 'NetworkModule'
如果搜索和匹配不对可能是由于其他repo进行搜索的内容,在前面我们可以看到repo有5组,可以进入文件夹目录地址~/.cocoapods/repos 尝试移动cocoapods和trunk。再次搜索,结束后记得移动回cocoapods和trunk,防止无法使用cocoapods和trunk。这里移动仅为了测试是否正确发布版本代码。
3.6组件的使用
创建主工程Tiens
使用ssh拉取空文件并在该文件下编写代码并上传
修改podfile文件
如图主工程使用了指定组件NetworkModule版本为0.1.0,由于开源项目中有NetworkModule所以这里除了指定版本外,需要指定source。
如果主工程需要集成的组件工程中使用指定的branch使用pod 'NetworkModule',:git => 'http://10.211.55.3/zhujie/NetworkModule.git',:branch => 'master',这个就不需要指定source
安装组件
pod install
4.更新组件库
上传代码并打好标签
修改.podspec文件
提交.podspec
cd existing_folder
pod repo push ZJSpecs NetworkModule.podspec --use-libraries
如果失败可以尝试删除再次添加
pod repo remove ZJSpecs
pod repo add ZJSpecs http://10.211.55.3/zhujie/ZJSpecs.git