aosp: refining contents

source/aosp.rst

@@ -2,40 +2,48 @@
 AOSP 镜像使用帮助
 =================
 
-初始同步方法 1（推荐）
-========================
+地址
+====
 
-第一次同步数据量特别大，如果网络不稳定，中间失败就要从头再来了。所以我们提供了打包的
-AOSP 镜像，为一个 tar 包，大约 200G（单文件
-200G，注意你的磁盘格式要支持）。这样你 就可以通过 HTTP(S)
-的方式下载，该方法支持断点续传。
+https://mirrors.ustc.edu.cn/aosp/
 
-下载地址 https://mirrors.ustc.edu.cn/aosp-monthly/
+说明
+====
 
-请注意对比 checksum。
+Android 开源项目源代码镜像。支持 git 与 http(s) 协议。
+关于协议选择，请参考 :ref:`http_sync`\ 。
 
-然后根据下文 已有仓库如何改用科大源 的方法更改同步地址。
+初始同步
+==========
 
-解压后用命令 repo sync 就可以把代码都 checkout 出来。
+初始同步方法 1（推荐）
+----------------------------
 
-Note: tar 包为定时从 https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/
-下载。
+第一次同步数据量特别大，如果网络不稳定，中间失败就要从头再来了。所以我们提供了打包的
+AOSP 镜像，为一个 tar 包，截至 2024 年 3 月约 80G（注意磁盘格式需要能够支持大文件）。
+这样就可以通过 HTTP(S) 的方式下载，支持断点续传。
+
+下载地址：https://mirrors.ustc.edu.cn/aosp-monthly/\ 。**请注意对比 checksum。**
+
+然后解压后根据下文 :ref:`change_to_ustc` 的方法更改同步地址，
+然后用命令 ``repo sync`` 就可以把代码都 checkout 出来。
+
+该 tar 包为定时从 https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/ 下载。
 
 初始同步方法 2（不推荐）
-=========================
+----------------------------
 
 .. warning::
 
    由于 AOSP 镜像造成的 IO 负载很高，不建议使用以下方式初次同步。
 
-按照 Google 官方教程 https://source.android.com/source/downloading.html
-
+按照 `Google 官方教程 <https://source.android.com/source/downloading.html>`_
+(`CN <https://source.android.google.cn/source/downloading>`__)，
 将 ``https://android.googlesource.com/platform/manifest`` 替换为
-``git://mirrors.ustc.edu.cn/aosp/platform/manifest`` 。
+``git://mirrors.ustc.edu.cn/aosp/platform/manifest`` 或
+``http://mirrors.ustc.edu.cn/aosp/platform/manifest``\ 。
 
-具体做法摘录如下：
-
-首先下载 repo 工具。
+具体做法摘录如下：首先下载 repo 工具。
 
 ::
 
@@ -46,7 +54,7 @@ Note: tar 包为定时从 https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/
    ## curl -sSL  'https://gerrit-googlesource.proxy.ustclug.org/git-repo/+/master/repo?format=TEXT' |base64 -d > ~/bin/repo
    chmod a+x ~/bin/repo
 
-然后建立一个工作目录（名字任意）
+然后建立一个工作目录（名字任意）：
 
 ::
 
@@ -61,7 +69,8 @@ Note: tar 包为定时从 https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/
    ## 如果提示无法连接到 gerrit.googlesource.com，可以编辑 ~/bin/repo，把 REPO_URL 一行替换成下面的：
    ## REPO_URL = 'https://gerrit-googlesource.proxy.ustclug.org/git-repo'
 
-如果需要某个特定的 Android 版本（`Android 版本列表`_ (`CN`_)，`镜像站 tags 列表`_）：
+如果需要某个特定的 Android 版本
+（`Android 版本列表`_ (`CN <https://source.android.google.cn/source/build-numbers?hl=zh-cn#source-code-tags-and-builds>`__)，`镜像站 tags 列表`_）：
 
 ::
 
@@ -73,45 +82,53 @@ Note: tar 包为定时从 https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/
 
    repo sync
 
+.. _change_to_ustc:
+
 已有仓库如何改用科大源
 ======================
 
 如果您已经从官方同步了 AOSP 仓库，现在希望使用科大的 AOSP 仓库，请修改
-``.repo/manifests.git/config`` ，将
+``.repo/manifests.git/config``\ ，将：
 
 ::
 
    url = https://android.googlesource.com/platform/manifest
 
-修改成
+修改成：
 
 ::
 
    url = git://mirrors.ustc.edu.cn/aosp/platform/manifest
 
 即可。
 
-通过 HTTP 协议同步
+.. _http_sync:
+
+通过 HTTP(S) 协议同步
 ============================
 
+以上说明中，默认使用了 git 协议的地址：``git://mirrors.ustc.edu.cn/aosp/platform/manifest``\ 。
+
 如果由于某种原因不能通过 git 协议同步，请修改
 ``.repo/manifests.git/config`` ，将
 
 ::
 
    url = git://mirrors.ustc.edu.cn/aosp/platform/manifest
 
-修改成
+修改成 (HTTP)：
 
 ::
 
    url = http://mirrors.ustc.edu.cn/aosp/platform/manifest
 
-不推荐使用 HTTP 协议同步，因为 HTTP 服务器不支持 ``repo sync`` 的
-``--depth`` 选项，可能导致部分仓库同步失败。
+或 (HTTPS)：
 
-通过 HTTP 同步过程中可能提示 clone.bundle 404
-错误，这是正常现象，可以忽略。
+::
+
+   url = https://mirrors.ustc.edu.cn/aosp/platform/manifest
+
+通过 HTTP(S) 同步过程中可能提示 clone.bundle 404 错误，这是正常现象，可以忽略。
 
 说明
 ====
@@ -132,12 +149,18 @@ Brillo 项目的代码托管在 AOSP 项目中，Mirrors 镜像的是整个 AOSP
 
 参考 Brillo 官方文档
 https://developers.google.com/brillo/docs/reference/downloads
-进行下载，将其中源码 manifest 地址 改为
-``git://mirrors.ustc.edu.cn/aosp/brillo/manifest`` 。 即：
+进行下载，将其中源码 manifest 地址改为
+``git://mirrors.ustc.edu.cn/aosp/brillo/manifest`` 。即：
 
 ``repo init`` 时，使用
 ``repo init -u git://mirrors.ustc.edu.cn/aosp/brillo/manifest -b master``
 
+相关链接
+========
+
+:Android 开源项目官网: https://source.android.com/
+:Android 开源项目官网 (CN): https://source.android.google.cn/
+:Android Code Search: https://cs.android.com/
+
 .. _Android 版本列表: https://source.android.com/source/build-numbers.html#source-code-tags-and-builds
-.. _CN: https://source.android.google.cn/source/build-numbers?hl=zh-cn#source-code-tags-and-builds
 .. _镜像站 tags 列表: http://mirrors.ustc.edu.cn/aosp/platform/manifest.git/refs/tags/