当前位置:   article > 正文

repo 使用

repo 使用

repo是android为了方便管理个git库而开发的python脚本。

repo是通过manifests库来管理项目的清单文件,通过repo库来维护。

当用户使用repo初始化项目时,就会从远程将manifests和repo两个git库拷
贝到本地,repo将自动化管理信息都隐藏到根目录的.repo子目录中。

项目清单库(.repo/manifests)
    
    <remote>:描述的是远程仓库的基本信息。
    name:描述的是远程仓库的名称,通常看到的命名是origin;
    fetch:用作项目名称的前缘,在构造项目仓库远程地址时使用到;
    review:描述的是用作code review的server地址
    
    <default>:default标签的定义的属性,将作为<project>标签的默认属性,在
    <project>标签中,也可以重写这些属性。
    revision:表示当前版本,也就是俗称的分支;
    remote:描述的是默认使用的远程仓库名称,即<remote>标签中的name
    sync -j:表述在同步代码是,并发的任务数量,配置高的机器这个值可以调大

    <project>:每一个repo管理的git库,就是对应到一个<project>标签
    path描述的是项目相对于远程仓库URL的路径,同时将作为对应的git库在本地代码的路径

    name用于定义项目名称,命名方式采用的是整个项目URL的相对地址。譬如,AOSP项目的URL
    为https://android.googlesource.com/,命名为platform/build的git库,访问的
    URL就是https://android.googlesource.com/platform/build

repo脚本库
    repo对git命令进行了封装,提供了一套repo的命令集,所有repo管理的自动化实现也都包含在
    这个git库中。在第一次初始化的时候,repo会从远程把这个git库下载到本地。

仓库目录和工作目录
    仓库目录保存的是历史信息和修改记录,工作目录保存的是当前版本的信息。一般来说,一个项目
    的git仓库目录(默认为.git)是位于工作目录下面的,但是git支持将一个项目的git仓库目录和工作
    目录分开存放。对于repo管理而言,既有分开存放,也有位于工作目录存放的:
    
    manifests:仓库目录有两份拷贝,一份位于工作目录(.repo/manifests)的.git目录下,另一份独立
    存放于.repo/manifeste.git
    
    repo:仓库目录位于工作目录(.repo/repo)的.git目录下

    project:所有被管理git库的仓库目录都是分开存放的,位于.repo/projects目录下。同时,也会保留
    工作目录的.git,但里边所有的文件都是到.repo的链接。这样,即做到了分开存放,也兼容了在工作
    目录下的所有git命令。

    因为.repo目录下保存了项目的所有信息,所以要拷贝一个项目时,只需要拷贝这个目录就可以了,repo
    支持从本地已有的.repo中恢复原有的项目。

初始化:
    repo init -u ssh://xxxx@xxx:29428/xxx -b xxx --repo-url=ssh://xxxx@xxxx:29428/git-repo --no-repo-verify

    -u:指定manifests这个远程git库的URL,manifests库是整个项目的清单。
    -m,-manifest-name:指定所需要的manifests库中的清单文件。
    -b,-manifest-branch:指定manifest.xml文件中的版本,也就是分支

    执行该命令后,会在当前目录新建一个.repo的子目录,然后clone了两个git库,其中一个是-u指定的
    manifests,本地git库的名称是manifest.git;另一个是默认的repo,这个URL也可以通过参数指定;
    接着,创建了manifest/.git目录,里面的所有文件都是到manifests.git这个目录的链接,这个是方便
    对manifests目录执行git命令,紧接着,就会将manifest切换到-b参数指定的分支;
    最后在.repo目录下,创建了一个软连接,链接到-m参数指定的清单文件,这样就完成了一个多git库
    的初始化。

    扩展:
    -repo-url:指定远程repo库的URL;默认情况下是https://android.googlesource.com/tools/repo,
    但国内访问Google受限,会导致这个库无法下载,从而导致repo init失败,所以可以通过该参数指定
    一个访问不受限的repo地址
    
    -repo-branch:同manifest这个git库一样,repo这个git库也是有版本差异的,可以通过该参数来指定
    下载repo这个远程git库的特定分支
    
    -no-repo-verify:在下载repo库时。会对repo的源码进行检查。通过-repo-url指定第三方repo库时,
    可能会导致检查不通过,所以可以配套使用该参数,强制不进行检查
    
同步:
    repo sync [PROJECT_LIST]
    下载远程代码,并将本地代码跟新到最新,这个过程叫做同步。如果不使用任何参数,那么会对所有repo
    管理的进行同步操作;也可以PROJECT_LIST参数,指定若干要同步的PROJECT。根据本地git库代码不同,
    同步操作会有不同的行为:
    
    当本地git库第一次触发同步操作时,那么该命令等价于git clone,会将远程git库直接拷贝到本地。

    当本地已经触发过同步操作时,那么该命令等价于git remote updata&&git rebase origin/<BRANCH>,
    <BRANCH>就是于当前本地分支所关联的远程分支 代码合并可能会产生冲突,当冲突出现时,只需要解决
    完冲突,然后执行git rebase --continue即可。

    当sync命令正确执行完毕后,本地代码就同远程代码保持一致了。在一些场景下,我们会用到sync命令的一些参数:
    
    -j:开启多线程同步操作,这会加快sync命令的执行速度。默认情况下,使用4个线程并发进行sync
    
    -c,-current-branch:只同步指定的远程分支。默认情况下,sync会同步所有的远程分支,当远程分支比较多的
    时候,下载的代码量就大。使用该参数,可以缩减下载时间,节省本地磁盘空间

    -d,detach:脱离当前本地分支,切换到manifest.xml中设定的分支。在实际操作中,这个参数很有用。当我们第
    一次sync完代码后,往往会切换到dev分支进行开发。
    
    -r,指定repoid进行查询
    
    -e xxx,-cachedir=xxx 存储元数据的目录
    
    -p,将包下载到路劲,默认是当前目录
    
    -l,启用yum插件支持
    yum是Fedora和RedHat以及SUSE中的Shell前端软件包,能够从指定的服务器自动下载RPM包并安装,可以自动处理依赖关系,并且一次安装所有依赖的软体包
        
repo forall命令:
    repo forall的作用是可以遍历每个仓库并在每个仓库下执行同样的命令
    且repo forall有以下几种自带的环境变量:
    REPO_PROJECT        //指定项目的名称(即仓库名)
    REPO_PATH            //指定项目在工作区的相对路径
    REPO_REMOTE            //指定项目远程仓库的名称
    REPO_LREV            //指定项目最后一次服务器仓库对应的哈希值
    REPO_RREV            //指定项目在克隆时的指定分支(即manifest中的revision属性)
    需注意的是,使用环境变量需要将指令用单引号包裹,如:
    repo forall -c 'echo REPO_PROJECT'            //打印仓库名称
    
    
    参数如下:
    -c                    //后面所带是参数是shell指令
    -p                    //在shell指令输出之前列出项目名称
    -v                    //列出执行shell指令输出的错误信息
    
    
    
    
    
    


 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/很楠不爱3/article/detail/636649
推荐阅读
相关标签
  

闽ICP备14008679号