gitLab创建自己的私有库

一.创建私有库的流程简介

• 创建一个项目,留着后面的流程3制作私有库
• 在可以创建私有库的地方创建一个code repository, code repository是代码仓库,我们把代码上传到这个仓库。
• 在可以创建私有库的地方创建一个spec repository, spec repository是配置仓库,所有的配置按照包名、版本号分门别类的存放在这个仓库。这个仓库只用来存放podspec文件,不存放代码。
• 克隆code repository到本地并添加私有库代码文件,上传所有文件到远端的库中并打tag
• 创建并编辑三个私有库配置文件:创建和编辑README.md、创建和编辑LICENSE、创建和编辑podspec文件(验证podspec文件是否正确,如果有问题要确保更改完成,否则无法继续进行 )
• 创建本地的私有仓库文件
• 将配置文件push到远端专门存储配置文件的仓库中
• 确认已经制作完成并使用

二.创建的详细流程

1.创建一个项目,留着后面的流程3制作私有库

1)在这里我们选择用Cocoa Touch Static Library创建一个新的工程,取名为JXTool

1.png
2.png

　　2)删除掉默认的.h和.m文件,加入自己已经准备好的工具类,最后主要就是用这个工具类去制作的私有库,这里简便起见就只是执行打印了

#import <Foundation/Foundation.h>

@interface logTest : NSObject
- (void)test;
@end

#import "logTest.h"

@implementation logTest
- (void)test {
    NSLog(@"test111111");
}
@end

image

2.在可以创建私有库的地方创建一个code repository(代码仓库), 一个spec repository(配置仓库)

这里我使用的是gitlab,除了gitlab之外还可以使用github(私有需要收费) 、开源中国、CODING、Bitbucket、CSDN code都可以,但这里使用gitlab来介绍所有的操作

1)点击右上角的加号按钮,创建代码仓库名为JXCodeRep

image.png

　　2)同上面方法,创建配置仓库名为JXSpecRep,所以此时除了名字不同外,其他都一样 .所以这里建议使用不同的仓库名字来区别这两个不同作用的仓库

image.png

3.克隆code repository到本地并添加步骤1中的私有库代码文件,上传所有文件到远端的库中并打tag

1)打开git管理工具SourceTree,点击新建按钮,选择从URL克隆选项,将上面的远程代码仓库地址复制进去,选择好自己的目标路径和名称后点击克隆

image

2)这时候第一次克隆下来的文件夹是没有东西的(这里不算隐藏文件)

image

因此别忘了按照gitLab官网进行下面操作,打开终端,在默认的路径下就行

image

3)拉取远程代码仓库,将我们之前步骤1中建立好的整个项目全部拖进这个文件夹替换README.md

image
image.png

4)进入SourceTree,点击文件状态,将所有的改动全选后提交,再推送到git服务器.将你需要某次修改打上一个tag 1.0,作为一个库的修改版本.注意::别忘了,勾选上"推送标签",这个非常重要

image
image.png

4.创建并编辑三个私有库配置文件

1)创建和编辑README.md、创建和编辑LICENSE（我在这里就不创建这两文件了，只是简单说下创建方法）

这个文件在github中也有,是项目的说明文件,根据自己的项目做一些说明.打开终端,cd到工具类文件所在的路径下

image

2)创建和编辑.podspec文件(这步最容易出错)

打开终端输入

cd ~/

为了后续私有库的维护,建议名字和工具类所在项目名一样,进入到根目录后创建一个名字叫JXTool.podspec的文件

pod spec create JXTool

image

准备通过vim进行编辑

vim JXTool.podspec

先别按下 i进入编辑模式,清空全部内容

:%d

内容清空后点击i 进入编辑模式,输入以下内容

Pod::Spec.new do |s|
  s.name         = "JXTool"
  s.version      = "1.0" #当前版本
  s.summary      = "JXTool a hello " #描述
  s.homepage     = "http://git.op.xywy.com/liunian/JXCodeRep.git" #库文件主页地>址
  s.license      = 'MIT'
  s.author       = { 'liunian' => 'liunian@xywy.com' }  #开发者
  s.source       = { :git => 'git@git.op.xywy.com:liunian/JXCodeRep.git', :tag => '1.0' } #文件的git地址,以及当前版本对应的tag,这个1.0就是我刚刚标注的
s.source_files = 'JXTool/JXTool/*' #文件所在的目录,后面*是一个正则表达式,目录我下面会有解释
 # s.source_files = 'JXTool/JXTool/*.{h,m}' #文件所在的目录,后面*.{h.m}是一个正则表达式,目录我下面会有解释
 # s.resources    = 'JXTool/JXTool/*.xib' #资源文件所在的目录图片,xib等,这个demo没有用到
  s.framework    = 'UIKit' #当前这个库所依赖的系统的库
  s.platform     = :ios
  s.requires_arc = true #是否支持arc
end

退出编辑esc,保存

:wq

3)进入终端后验证.podspec文件是否有效

pod spec lint JXTool.podspec --allow-warnings

有passed validating则表示spec文件验证通过了

image

5.创建'本地的私有仓库'文件

1）使用下面的命令就可以在本地生成配置文件的仓库,建议这个本地的名字也和远程的一致,这样便于区分和后期的维护.
JXSpecRep 是你远端创建的配置文件仓库的名字,后面是配置文件仓库远端的地址 .
注意此时不需要cd进入任何目录,从默认位置输入这个命令,即在点击终端快捷方式打开的状态下直接输入下面的命令即可

pod repo add JXSpecRep http://git.op.xywy.com/liunian/JXSpecRep.git

2）查看是否添加成功

pod repo list

如果出现了JXSpecRep,则代表添加成功

image

或者返回桌面command+shift+G查询本地配置仓库管理文件夹

~/.cocoapods/repos

image image

6.将配置文件push到远端专门存储配置文件的仓库中

1）将配置文件push到远端专门存储配置文件的仓库中 ,本地的也会同步更新
此时需要cd进入本地的.podspec所在的路径，默认是根目录,否则会找不到podspec文件
使用下面的命令即可,有问题可以参考报错信息去修改
JXSpecRep 是你创建的spec repository的名字,后面是你本地创建的.podspec文件

pod repo push JXSpecRep JXTool.podspec --allow-warnings

2）出现下面信息,则代表成功

image

或者查询本地私有spec管理文件夹,看到了JXTool则代表成功

open ~/.cocoapods/repos

image

3）可以在远端仓库中看到这个文件，并且远端配置文件仓库中有且只有这一个文件

image

7.确认已经制作完成并使用

1)查询是否有我们需要的私有库

pod search JXTool

image

2)新建一个项目后，初始化pod

pod init

编辑Podfile文件

vim Podfile

在合适的地方pod我们的私有库

source 'http://git.op.xywy.com/liunian/JXSpecRep.git'
pod 'JXTool', '1.0'

cd到项目的路径下

pod install

image

3)导入头文件，使用工具类

image

大功告成！
三.补充

下面主要讲述在同一台笔记本操作，也就是还保留着之前所有相关本地的文件

1.更新私有库

1）参照上面步骤3将私有库克隆下来，然后进行工具类代码的修改，重新提交到远程仓库，并设置标签，例如2.0，即再执行一遍步骤3的1）和4）

修改的地方

#import "logTest.h"

@implementation logTest
- (void)test {
    NSLog(@"test222222");
}
@end

2）编辑.podspec文件，我这里是同一台笔记本还有原先的文件，所以不用再次创建了，直接编辑

vim JXTool.podspec

修改下面的信息，即所有1.0的地方都修改成最新的标签2.0

Pod::Spec.new do |s|
  s.name         = "JXTool"
  s.version      = "2.0" #当前版本
  s.summary      = "JXTool a hello " #描述
  s.homepage     = "http://git.op.xywy.com/liunian/JXCodeRep.git" #库文件主页地>址
  s.license      = 'MIT'
  s.author       = { 'liunian' => 'liunian@xywy.com' }  #开发者
  s.source       = { :git => 'git@git.op.xywy.com:liunian/JXCodeRep.git', :tag => '2.0' } #文件的git地址,以及当前版本对应的tag,这个1.0就是我刚刚标注的
s.source_files = 'JXTool/JXTool/*' #文件所在的目录,后面*是一个正则表达式,目录我下面会有解释
 # s.source_files = 'JXTool/JXTool/*.{h,m}' #文件所在的目录,后面*.{h.m}是一个正则表达式,目录我下面会有解释
 # s.resources    = 'JXTool/JXTool/*.xib' #资源文件所在的目录图片,xib等,这个demo没有用到
  s.framework    = 'UIKit' #当前这个库所依赖的系统的库
  s.platform     = :ios
  s.requires_arc = true #是否支持arc
end

后面的步骤依然和之前的一样,参照上面的步骤，参照上面的步骤4.3）

image

见到JXTool （2.0）极为成功

3）将配置文件push到远端专门存储配置文件的仓库中，参照上面的步骤6

image image

见到上面的则为成功

4）确认已经制作完成并使用

编辑原先测试demo的Podfile文件，pod update之后运行看结果

image

终于大功告成！！！！

由于我是第一次去主动在gitlab上创建私有库，查了很多资料都不是很详细，看了也是迷糊的很，所以特别抽空研究了一番，结合几篇别人的文章，自动亲手实践，最后整理成这篇笔记，可能对于熟悉创建私有库的人来说废话很多，很冗余，但是真心希望能帮助和我一样的新手，一起学习。