关于repo（2）

清单库与清单文件介绍


repo init之后，只有一个.repo
root@hghphicprd13391:/usr1/sdk/workspace/public_code_96CV300/linux_master/.repo# ll
total 36
drwxr-xr-x  7 root root 4096 Dec  9  2019 ./
drwxr-xr-x  7 root root 4096 Dec 10  2019 ../
-rw-r--r--  1 root root 2836 Dec 10  2019 .repo_fetchtimes.json
lrwxrwxrwx  1 root root   21 Dec  9  2019 manifest.xml -> manifests/default.xml*
drwxr-xr-x  4 root root 4096 Nov 25 16:21 manifests/
drwxr-xr-x 10 root root 4096 Dec  9  2019 manifests.git/
drwxr-xr-x  6 root root 4096 Dec  9  2019 project-objects/
-rw-r--r--  1 root root 1201 Dec 10  2019 project.list
drwxr-xr-x  8 root root 4096 Dec  9  2019 projects/
drwxr-xr-x  7 root root 4096 Dec  9  2019 repo/
.repo/manifest.xml就是项目多版本库的清单文件
1 <?xml version="1.0" encoding="UTF-8"?>
  2 <manifest>
  3   <remote fetch="http://szxgit10-rd.huawei.com:8080" name="szxgit10" review="http://szxgit10-rd.huawei.com:8080" />
  4   <default remote="szxgit10" revision="linux_master" sync-j="4" sync_c="true" />
  5
  6   <project name="stb/linux/sdk"             path="sdk"/>
  7   <project name="stb/linux/sample"          path="sdk/sample"/>
  8   <project name="stb/linux/build"           path="sdk/scripts"/>
  9   <project name="stb/linux/boot_app"        path="sdk/source/bootloader/app"/>
 10   <project name="stb/linux/liteos"          path="sdk/source/liteos"/>
 11   <project name="stb/linux/sysreg"          path="sdk/source/bootloader/sysreg"/>
 12   <project name="stb/linux/unf"             path="sdk/source/linux/api/include"/>
 13   <project name="stb/linux/gpu_user"        path="sdk/source/linux/api/gpu"/>
 14   <project name="stb/linux/driver"          path="sdk/source/linux/drv"/>
 15   <project name="stb/linux/bluetooth"       path="sdk/source/linux/drv/bluetooth"/>
 16   <project name="stb/linux/wifi"            path="sdk/source/linux/drv/wifi"/>
 17   <project name="stb/linux/hiplayer"        path="sdk/source/component/hiplayer"/>
 18   <project name="stb/linux/nagra"           path="sdk/source/component/nagra"/>
 19   <project name="stb/linux/irdeto"          path="sdk/source/component/irdeto"/>
 20   <project name="stb/linux/hi_pq_tool"      path="sdk/tools/windows/HiPQTool"/>
 21   <project name="stb/linux/hi_pro_info"     path="sdk/tools/windows/HiProInfo"/>
 22   <project name="stb/linux/hi_tool"         path="sdk/tools/windows/HiTool"/>
 23   <project name="stb/linux/hi_workbench"    path="sdk/tools/windows/HiWorkbench"/>
 24   <project name="stb/linux/open_source"     path="sdk/third_party/open_source"/>
 25
 26   <project name="TC_HiDolphin_GIT/Android/androidn/device/hal" path="sdk/hisilicon_hal" revision="HAL_DEV" sync_c="true" >
 27     <linkfile dest="sdk/source/component/hal/include" src="include"/>
 28   </project>
 29
 30   <project name="stb/linux/release"     path="build"/>
 31   <project name="stb/linux/ci"          path="CI"/>
 32
 33   <project name="stb/linux/test_code"              path="test"/>
 34   <project name="stb/linux/test_code/common"       path="test/common"/>
 35   <project name="stb/linux/test_code/integration"  path="test/integration"/>
 36   <project name="stb/linux/test_code/bsp"          path="test/bsp"/>
 37   <project name="stb/linux/test_code/frontend"     path="test/frontend"/>
 38   <project name="stb/linux/test_code/demux"        path="test/demux"/>
 39   <project name="stb/linux/test_code/avplay"       path="test/avplay"/>
 40   <project name="stb/linux/test_code/audio"        path="test/audio"/>
 41   <project name="stb/linux/test_code/vdec"         path="test/vdec"/>
 42   <project name="stb/linux/test_code/venc"         path="test/venc"/>
 43   <project name="stb/linux/test_code/xdp"          path="test/xdp"/>
 44   <project name="stb/linux/test_code/pvr"          path="test/pvr"/>
 45   <project name="stb/linux/test_code/gfx"          path="test/gfx"/>
 46   <project name="stb/linux/test_code/hdmi"         path="test/hdmi"/>
 47   <project name="stb/linux/test_code/security"     path="test/security"/>
 48   <project name="stb/linux/test_code/ecs"          path="test/ecs"/>
 49   <project name="stb/linux/test_code/pmoc"         path="test/pmoc"/>
 50   <project name="stb/linux/test_code/caption"      path="test/caption"/>
 51   <project name="stb/linux/test_code/rm"           path="test/rm"/>
 52   <project name="stb/linux/test_code/panel"        path="test/panel"/>
 53
 54   <include name="platform_sdk.xml" />
 55
 56 </manifest>
 xml的顶级元素是manifest第二行和第181行
  3   <remote fetch="http://szxgit10-rd.huawei.com:8080" name="szxgit10" review="http://szxgit10-rd.huawei.com:8080" />
  4   <default remote="szxgit10" revision="linux_master" sync-j="4" sync_c="true" />
  remote元素定义的szxgit10的远程版本库，其中git库基址为http://szxgit10-rd.huawei.com:8080
  gerrit代码审核服务器的地址http://szxgit10-rd.huawei.com:8080，可以定义多个remote,一般情况只定义一个如果不定义分支默认为master,这里我们定义了分支revision="linux_master"
  <project name="stb/linux/test_code/panel"        path="test/panel"/>
  各个项目(project元素)可以定义自己的remote和revision覆盖该默认配置，版本库相对路径stb/linux/test_code/panel；绝对路径http://szxgit10-rd.huawei.com:8080/stb/linux/test_code/panel，本地版本库工作区位置：test/panel
  project也可以有子元素copyfile，可能后的一个附加动作：从core/root.mk拷贝文件至Makefile
  <project name="stb/linux/test_code/panel"        path="test/panel">
     <copyfile src="core/root.mk" dest="Makefile" />
   </project>
   5.还可能出现manifest-server元素，其url属性定义了通过XMLRPC提供实时更新清单的服务器URL,只有当执行repo sync --smart-sync的时候才会检查该值，并用动态获取的manifest覆盖掉默认的清单。

同步项目


xxxxxxxxxx
   repo sync 同步命令
   如果只克隆想克隆的项目 在repo sync 后面跟上项目的名称。项目的名称来自.repo/manifest.xml这个XML文件中project元素的name属性值
   repo sync stb/linux/test_code/panel
   repo也支持本地清单对默认清单文件进行补充及覆盖，即可以在.repo目录下创建local_manifest.xml文件，其内容会和.repo/manifest.xml文件的内容合并（了解）
   在工作目录下运行下面的命令可以创建一个本地清单文件。这个本地定制的清单文件来自默认文件，但是删除了remote元素和defualt元素，并将所有的project元素都重命名为remove-project元素,这实际相当于对原有清单文件"取反"
   curl -L -k http://www.ossxp.com/doc/gotgit/download/ch25/manifest-revert.xslt >manifest-revert.xslt
   xsltproc manifest-revert.xslt .repo/manifest.xml>.repo/local_manifest.xml两个文件的汇总
   用下面的这条命令可以看到repo运用时实际获取到的清单 来源local_manifest.xml和.repo/manifest.xml的汇总
   repo manifest -o -
   local_manifest.xml需要注意的:
   不能出现重复定义的remoter元素
   不能出现default元素，全局只能有一个
   不能出现重复的project定义（name属性不能相同）,但是可以通过remove-project元素将默认清单中定义的project删除后再重新定义

建立android代码库本地镜像


x
repo init -u url --mirror
执行后再.repo/manifests的config中记录
[repo]
    mirror = true
当一次执行repo init -u url后，再执行repo init -u -mirror取更新版本库的时候会报错：fatal:--mirror not supported on existing client(了解)
可以用脚本work2mirror.py
#!/usr/bin/python
# -*- coding: utf-8 -*-
import os, sys, shutil
cwd = os.path.abspath( os.path.dirname( __file__ ) )
repodir = os.path.join( cwd, '.repo' )
S_repo = 'repo'
TRASHDIR = 'old_work_tree'
if not os.path.exists( os.path.join(repodir, S_repo) ):
    print >> sys.stderr, "Must run under repo work_dir root."
    sys.exit(1)
sys.path.insert( 0, os.path.join(repodir, S_repo) )
from manifest_xml import XmlManifest
manifest = XmlManifest( repodir )
if manifest.IsMirror:
    print >> sys.stderr, "Already mirror, exit."
    sys.exit(1)
trash = os.path.join( cwd, TRASHDIR )
for project in manifest.projects.itervalues():
    # 移动旧的版本库路径到镜像模式下新的版本库路径
    newgitdir = os.path.join( cwd, '%s.git' % project.name )
    if os.path.exists( project.gitdir ) and project.gitdir != newgitdir:
        if not os.path.exists( os.path.dirname(newgitdir) ):
            os.makedirs( os.path.dirname(newgitdir) )
        print "Rename %s to %s." % (project.gitdir, newgitdir)
        os.rename( project.gitdir, newgitdir )
    # 移动工作区到待删除目录
    if project.worktree and os.path.exists( project.worktree ):
        newworktree = os.path.join( trash, project.relpath )
        if not os.path.exists( os.path.dirname(newworktree) ):
            os.makedirs( os.path.dirname(newworktree) )
        print "Move old worktree %s to %s." % (project.worktree, newworktree )
        os.rename( project.worktree, newworktree )
    if os.path.exists ( os.path.join( newgitdir, 'config' ) ):
        # 修改版本库的配置
        os.chdir( newgitdir )
        os.system( "git config core.bare true" )
        os.system( "git config remote.korg.fetch '+refs/heads/*:refs/heads/*'" )
        # 删除 remotes 分支，因为作为版本库镜像不需要 remote 分支
        if os.path.exists ( os.path.join( newgitdir, 'refs', 'remotes' ) ):
            print "Delete " + os.path.join( newgitdir, 'refs', 'remotes' )
            shutil.rmtree( os.path.join( newgitdir, 'refs', 'remotes' ) )
# 设置 menifest 为镜像
mp = manifest.manifestProject
mp.config.SetString('repo.mirror', 'true')

repo的命令集（一般采用git命令）


xxxxxxxxxx
repo的命令集
repo子命令实际上是Git命令的或简单或复杂的封装。每一个repo子命令都对应于repo源码树中subcmds目录下的一个同名的Python文件。每一个repo子命令都可以通过下面的命令获得帮助。
$ repo help <command>
通过阅读代码，可以加深了解repo子命令的封装
1)repo init
完成检出清单版本库（manifest.git），以及配置Git用户的用户名和邮件地址的工作。
2)repo sync
参照清单文件克隆或同步版本库。
git sync命令
git remote update 相当于对每隔一个remote源执行fetch操作
git rebase origin/branch
针对当前分支的跟踪分支执行rebase操作。不采用merge而是采用rebase，目的是减少提交数量,方便评审（gerrit）
3)repo start
实际上是对git checkout -b命令的封装。为指定的项目或所有项目（使用--all参数），以清单文件中为项目设定的分支或里程碑为基础，创建特性分支。特性分支的名称由命令的第一个参数指定。相当于执行checkout -b 
用法如下:
repo start <newbranchname> [--all|<project>…]
4)repo status
实际上是对git diff-index、gitdiff-files命令的封装，同时显示暂存区的状态和本地文件修改的状态。
repo status [<project>…]
5)repo checkout
实际上是对git checkout命令的封装。检出之前由repostart创建的分支。
repo checkout <branchname> [<project>…]
6)repo branches
repo branches读取各个项目的分支列表并汇总显示。该命令实际上通过直接读取.git/refs目录下的引用来获取分支列表，以及分支的发布状态等。
repo branches [<project>…]
7)        repo diff
实际上是对git diff命令的封装，用于分别显示各个项目工作区下的文件差异。
repo diff [<project>…]
8)repo stage
实际上是读git add--interactive命令的封装，用于挑选各个项目工作区中的改动（修改、添加等）以加入暂存区。
repo stage -I [<project>…]
9)repo upload
相当于git push
10)repo download
用于代码审核者下载和评估贡献者提交的修订。
repo download {project change [/patchset]}…
11)repo rebase
12)repo prune
该命令用于扫描项目的各个分支，并删除已经合并的分支。
repo prune [<project>…]
13)     其他命令
repo grep 用于项目文件中进行内容查找
repo smartsync
repo forall
repo manifest
repo version
repo selfupdate

清单库与清单文件介绍

同步项目

建立android代码库本地镜像

repo的命令集（一般采用git命令）

repo命令的工作流