之前整理过如何快速的检出指定tag的chromium源码。
这次整理成python脚本，可以在当前目录直接运行。自动完成代码检出，并有出错重试的功能。

import argparse
import os
import time
import shutil

_gcl_context = """
solutions = [
  {
    "name": "src",
    "url": "https://chromium.googlesource.com/chromium/src.git",
    "managed": False,
    "custom_deps": {},
    "custom_vars": {"checkout_pgo_profiles": True,},
  },
]
"""


def delete_error_git_dir(path):
    for dirpath, dirnames, _ in os.walk(path):
        for dirname in dirnames:
            full_dir_path = os.path.join(dirpath, dirname)
            if dirname == ".git" and len(
                    os.listdir(os.path.dirname(full_dir_path))) == 1:
                print(
                    f"Deleting error .git directory: {full_dir_path} and its contents..."
                )
                try:
                    if os.name == "nt":
                        os.system(f"rmdir /s /q {full_dir_path}")
                    else:
                        shutil.rmtree(full_dir_path)
                except OSError as e:
                    print(f"Error deleting {full_dir_path}: {str(e)}")
                    exit(1)


def _run_command_with_success(cmd):
    while 0 != os.system(cmd):
        print(f"Command:'{cmd}' failed! Start retry!")
        delete_error_git_dir("src")
    print(f"Command:'{cmd}' success!")


if __name__ == "__main__":
    parser = argparse.ArgumentParser(
        description="Checkout chromium code with tag.")
    parser.add_argument("tag", type=str, help="Tag to checkout.")
    parser.add_argument("-u",
                        "--upgrade",
                        action="store_true",
                        help="Upgrade existing code to a specified tag.")
    parser.add_argument(
        "--os",
        type=str,
        help="Specify the target platform for Chromium. For example: --os mac."
    )
    args = parser.parse_args()
    if not args.tag:
        parser.error('the "tag" argument is necessary')

    start = time.time()
    with open(".gclient", "w") as gcl:
        gcl.write(_gcl_context)
        if args.os:
            gcl.write(f'target_os = ["{args.os}"]\n')

    # checkout chromium
    if args.upgrade and os.path.exists("src"):
        print(f"Start upgrade chromium code to tag {args.tag} !")
        _run_command_with_success(
            f"git -C \"src\" fetch origin refs/tags/{args.tag}")
        os.system(f"git -C \"src\" checkout -b local_{args.tag} {args.tag}")
    elif os.path.exists("src"):
        print("Have 'src' directory, so skip checkout tag!")
    else:
        print(f"Start checkout chromium tag {args.tag} !")
        _run_command_with_success(
            f"git clone --depth 2 -b {args.tag} https://chromium.googlesource.com/chromium/src.git"
        )

    # run hook
    print("Start run hook!")
    _run_command_with_success(
        "gclient sync -D --with_branch_heads --with_tags")

    print(
        f"checkout chromium {args.tag} Ok! Use time:{time.strftime('%H:%M:%S', time.gmtime(time.time() - start))} !"
    )

之前整理过一篇《直接检出chromium某tag的完整可构建源码。》的文章。

这个方法中，在git fetch这个步骤需要花费大量的时间。
经过对git命令的研究之后，终于再总结出一个最快速的从零开始，直接check出指定的tag代码的方法。旧的方法完全可以淘汰了。

首先，还是先创建代码存放目前。不同的是，这里不需要创建src目录。

mkdir chromium
cd chromium

然后还是创建.gclient文件：

solutions = [
  {
    "name": "src",
    "url": "https://chromium.googlesource.com/chromium/src.git",
    "managed": False,
    "custom_deps": {},
    "custom_vars": {"checkout_pgo_profiles": True,},
  },
]

如果是要构建android平台的浏览器，就在这个文件最后添加一行内容：

target_os = ["android"]

到这里，还跟之前的方法相差不多。但是接下来就不一样了。以当前最新的官方正式版本112.0.5615.50为例。
直接克隆这个tag的代码：

git clone --depth 2 -b 112.0.5615.50 https://chromium.googlesource.com/chromium/src.git

这里要注意，其中--depth必须为2，原因后面会说到。
这个步骤，代替了原来的git fetch。并且深度只有2，所以原本需要同步的30+G的数据，变成只有区区1+G。这样就节省下了大量的时间和流量。

接下来，还是同步第三方工程和工具链。

gclient sync -D --with_branch_heads --with_tags

这里就要提一下为什么上面--depth必须为2。因为gclient在runhook的时候，是会根据git的提交日志来创建当前的版本信息。而深度为1的时候，就失去了需要的日志内容。会导致下面两个文件内的信息为空。当然，这样也会不导致编译失败，但是在浏览器内就无法看到构建的版本信息了。

src/build/util/LASTCHANGE
src/gpu/config/gpu_lists_version.h

这时，这份源码就已经可以编译出一份完整的chromium浏览器了。
同时，在这份源码的基础上，同样可以继续更新后续的代码。比如需要更新到112.0.5615.67这个tag。

cd src
git fetch origin tag 112.0.5615.67
git checkout -b local_112.0.5615.67 112.0.5615.67
cd ..
gclient sync -D --with_branch_heads --with_tags

而这个更新过程，同步的数据也非常小，非常快捷。因此这个方法应该是最终的chromium代码同步方法了。

chrome是目前地球上最成功的浏览器，而它的开源项目chromium也是最重要的开源项目之一。
研究chromium的源码，就成为很多人（比如我）重要的工作与学习手段。但是在国内想要check一份可构建的chromium源码其实并不太容易。除了众所周知的原因外，也因为chromium经过长期高速的开发和迭代之后，积累下来了庞大的源码。

如果按官方文档中的方法check源码，默认会check出当前最新的开发版代码。
或者拉回完整的git仓库，再check到指定的稳定版tag。这样很可能会拉回很多我们根本不需要的分支和tag。

实际上，是可以从零开始，直接check出指定的tag代码的。

那么让我们开始之前，假设已经满足了以下条件。

1. 克服了众所周知的问题。这个只能自己想办法……
2. 安装了所有需要的开发环境，比如depot_tools等。这个可以参考官方文档。

此方法适用于所有平台。以目前最新官方正式版本102.0.5005.63为例。

首先创建存放代码的目录：

mkdir chromium
cd chromium
mkdir src

创建纯文本文件.gclient并写入以下内容：

solutions = [
  {
    "name": "src",
    "url": "https://chromium.googlesource.com/chromium/src.git",
    "managed": False,
    "custom_deps": {},
    "custom_vars": {"checkout_pgo_profiles": True,},
  },
]

如果是要构建android平台的浏览器，就在这个文件最后添加一行内容：

target_os = ["android"]

接下来创建一个空的git仓库，来同步指定的tag。

cd src
git init
git remote add origin https://chromium.googlesource.com/chromium/src.git
git fetch origin tag 102.0.5005.63

最后一步就是在从官方的git中同步指定的tag。这个步骤是整个过程中最耗时的一步。具体的时间取决于网络情况与tag的新旧程度。越新的tag，需要同步的数据也就越大。
耐心等待tag同步完成。完成后src目录下还是空空如也，并没有代码文件。这时候就需要创建一个本地分支，从tag中check出代码。

git checkout -b local_102.0.5005.63 102.0.5005.63

这个步骤很快，完成后目录下就有chromium的代码了。但是目录中的代码还是不能构建出chromium浏览器，还缺少依赖的一些第三方工程，和构建需要的工具链。
接下来继续同步这些内容：

cd ..
gclient sync -D --with_branch_heads --with_tags

这个步骤也会花费一些时间，并且网络不佳的情况下还有可能会失败。不断重试直到最后全部成功就好。

当这个步骤完成后，完整的一份可构建的chromium源码就完成了。你可以构建出自己的chromium浏览器了，具体方法还是参考官方文档。

在这份代码上，还可以继续同步别的tag代码。只要把上面步骤中出现的版本号换成需要的tag版本号就可以了。这样可以节省不少的时间。