From b28d63b34928dcd375bbeae1aec23a0467292c7b Mon Sep 17 00:00:00 2001 From: wy Date: Sun, 24 Jul 2022 21:18:46 +0800 Subject: [PATCH 1/6] translate get_fuchsia_source.md file --- get-started/get_fuchsia_source.md | 224 ++++++++++++++++++++++++------ 1 file changed, 181 insertions(+), 43 deletions(-) diff --git a/get-started/get_fuchsia_source.md b/get-started/get_fuchsia_source.md index 7bb6eafa..9c11df63 100644 --- a/get-started/get_fuchsia_source.md +++ b/get-started/get_fuchsia_source.md @@ -1,30 +1,51 @@ + +# 下载 Fuchsia 源码 + +这篇文章将指导您下载 Fuchsia 源码以及在您的机器上部署开发环境。 + +步骤如下： + +1. [前期检查](#perform-a-preflight-check). +2. [安装用到的软件包](#install-prerequisite-packages). +3. [下载 Fuchsia 源码](#download-the-fuchsia-source-code). +4. [设置环境变量](#set-up-environment-variables). +5. [配置防火墙（可选项）](#configure-firewall-rules). + + +## 1. 前期检查 {#perform-a-preflight-check} + +Fuchsia 提供了一个自动检测工具（[`ffx platform preflight`][ffx-platform-preflight]），这个工具可以测试您的机器，并会在发现任何影响您编译 Fuchsia 源码的问题时通知您。 + +注意：这个检测工具只支持 x64 架构。Fuchsia 目前对其他架构的机器上的编译不做成功担保，比如 Windows 和 ARM64。 + +运行下面的命令： * {Linux} @@ -37,72 +58,109 @@ Run the following command: ```posix-terminal curl -sO https://storage.googleapis.com/fuchsia-ffx/ffx-macos-x64 && chmod +x ffx-macos-x64 && ./ffx-macos-x64 platform preflight ``` - + +## 2. 安装用到的软件包 {#install-prerequisite-packages} + +Fuchsia 要求 `curl`、 `file`、 `unzip` 以及 `git` 等工具是最新版。 `git` 版本要求 2.28 或以上。 * {Linux} - + + 安装（或更新）下面的软件： ```posix-terminal sudo apt install curl file git unzip ``` * {macOS} - + + 安装 Xcode 命令行工具： + + 注意：如果 `ffx platform preflight` 工具检测到 Xcode 已经安装，就省去这一步操作。 ```posix-terminal xcode-select --install ``` - + +## 3. 下载 Fuchsia 源码 {#download-the-fuchsia-source-code} + +Fuchsia 提供了一个[引导脚本](/scripts/bootstrap)，这个脚本会创建一个 `fuchsia` 的文件夹并把 Fuchsia 源码下载到这里。 + +下载 Fuchsia 源码要求你机器上有 2 GB 的存储空间。之后在编译 Fuchsia 过程中需要另外 80 到 90 GB 的存储空间，这取决于你的编译选项配置。另外，下载过程中也会使用一部分的内存空间。建议您在此过程中关闭其他非必要的程序进程。 + +下载 Fuchsia 源码，请按如下步骤： + +1. 选择一个 Fuchsia 源码存储目录，例如： + + 注意：你可以把 Fuchsia 下载到任何路径。本篇教程选择 `$HOME` 作为示例。 ```posix-terminal cd $HOME ``` - + +1. 运行引导脚本： + + 注意：下载 Fuchsia 源码可能需要 60 分钟。 ```posix-terminal curl -s "https://fuchsia.googlesource.com/fuchsia/+/HEAD/scripts/bootstrap?format=TEXT" | base64 --decode | bash ``` + + 这个脚本会先创建 `fuchsia` 路径，然后下载源码到该路径下。 -## 4. Set up environment variables {#set-up-environment-variables} + 如果你在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，参考[认证失败](#authentication-error)章节寻求帮助。 + + +## 4. 设置环境变量 {#set-up-environment-variables} + +Fuchsia 建议您在 shell 的配置文件中添加如下几个配置： + +* 添加 `.jiri_root/bin` 路径到你的 `PATH` 环境变量 + + `.jiri_root/bin` 路径在 Fuchsia 源码中包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些工具对 Fuchsia 的后续操作起着至关重要的作用。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，使用 `fx` 工具帮助配置、编译、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在你 `PATH` 环境变量中找得到 `jiri` 工具。 + +* 导入 `scripts/fx-env.sh` 文件 + + 虽然这并不是必须的，导入 [`fx-env.sh`](/scripts/fx-env.sh) 文件可以在你的终端中建立一系列的非常有用的 shell 函数。比如，它会创建给 `fd` 工具用来切换路径时提供自动补全的 `FUCHSIA_DIR` 环境变量（如果想获取更多信息，请参考 `fx-env.sh` 文件）。 + +注意：如果你不想更新你的 shell 配置，在附录中参考[不更新 PATH 变量编译 Fuchsia](#work-on-fuchsia-without-updating-your-path)。 + +为了更新你的 shell 配置文件来设置 Fuchsia 的环境变量，请按如下步骤： + +1. 请用文本编辑器打开你的 `~/.bash_profile` 文件（参考如下示例，我们使用 [Nano][nano]{:.external} ） + + 注意：这篇文章使用 `bash` 终端作为示例，如果你使用 `zsh` 的话，在如下步骤中请替换文件 `~/.bash_profile` 为 `~/.zprofile`： ```posix-terminal nano ~/.bash_profile ``` - + +1. 在你的 `~/.bash_profile` 文件中添加如下配置： + + 注意：如果你的 Fuchsia 源码不在 `~/fuchsia` 路径下，替换 `~/fuchsia` 路径为你的 Fuchsia 路径。 ```sh export PATH=~/fuchsia/.jiri_root/bin:$PATH source ~/fuchsia/scripts/fx-env.sh ``` - + +1. 保存文件并退出。 + +1. 更新环境变量，请运行如下命令： ```posix-terminal source ~/.bash_profile ``` - + +1. 验证你是否可以运行如下命令且没有报错： ```posix-terminal jiri help @@ -168,86 +253,139 @@ do the following: ```posix-terminal fx help ``` - + +## 5. 配置防火墙（可选项） {#configure-firewall-rules} + +注意：这一步在你的编译或者运行 Fuchsia 步骤中并不是必须的。但是是被建议的，因为可以用来确保你能在 Linux 中流畅的运行 Fuchsia 虚拟机。 + +(**Linux**) 如果你计划在 Linux 中运行 Fuchsia，建议您运行如下命令来允许 Fuchsia 使用一些特殊的特性： ```posix-terminal fx setup-ufw ``` - + +这个脚本需要 `sudo` （会提示你输入密码）权限来设置防火墙规则。（更多关于脚本的的信息，参考 [`setup-ufw`][setup-ufw] 文件）。 + +## 下一步 + +编译你第一个 Fuchsia 系统镜像，参考[配置和编译 Fuchsia](/get-started/build_fuchsia.md) 文件。 + +## 附录 + +### 验证失败 {#authentication-error} + +如果你在脚本运行期间看到了 `Invalid authentication credentials` 报错信息，你的 `~/.gitcookies` 文件中可能包含了一些引导脚本想要自动检测的来自 `googlesource.com` 的 cookie 信息。 + +为了解决这个问题，使用以下任何一个方式： + -### Work on Fuchsia without updating your PATH {#work-on-fuchsia-without-updating-your-path} +* 按照屏幕路径的提示为仓库输入密码 +* 删除 `.gitcookies` 文件中不需要的 cookie。 + +### 不更新 PATH 变量编译 Fuchsia {#work-on-fuchsia-without-updating-your-path} + +下面的章节为[设置环境变量](#set-up-environment-variables)章节提供了替代选项： + +* [把工具复制到可执行文件目录](#copy-the-tool-to-your-binary-directory) +* [为工具添加链接文件到可执行文件目录](#add-a-symlink-to-your-binary-directory) + +#### 把工具复制到可执行文件目录 {#copy-the-tool-to-your-binary-directory} + +如果你不想更新你的环境变量，但是你想在任何目录中使用 `jiri` 工具，把 `jiri` 工具复制到 `~/bin` 目录中，比如： + +注意：如果你的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为你的 Fuchsia 目录。 ```posix-terminal cp ~/fuchsia/.jiri_root/bin/jiri ~/bin ``` + +无论如何，你首先需要有不用 `sudo` 命令就可以访问 `~/bin` 路径的权限。如果没有，`jiri` 就不能使它自己保持在最新版本。 + +#### 为工具添加链接文件到可执行文件目录 {#add-a-symlink-to-your-binary-directory} + +同样的，如果你想不更新环境变量使用 `fx` 工具，在 `~/bin` 路径中提供你的 `fx` 工具的链接文件，比如： + +注意：如果你的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为你的 Fuchsia 目录。 ```posix-terminal ln -s ~/fuchsia/scripts/fx ~/bin ``` - + +相应地，你也可以使用 `fx` 工具的完整路径，比如： ```posix-terminal ./scripts/fx help ``` - + +另一方面，您需要在 `PATH` 环境变零中设置你的 `jiri` 工具。 [ffx-platform-preflight]: https://fuchsia.dev/reference/tools/sdk/ffx#preflight From 671eb91c8aa383c30b5162602d91a0932c364400 Mon Sep 17 00:00:00 2001 From: wy Date: Sun, 24 Jul 2022 21:21:27 +0800 Subject: [PATCH 2/6] =?UTF-8?q?substitute=20=E4=BD=A0=20with=20=E6=82=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- get-started/get_fuchsia_source.md | 50 +++++++++++++++---------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/get-started/get_fuchsia_source.md b/get-started/get_fuchsia_source.md index 9c11df63..b3a6e206 100644 --- a/get-started/get_fuchsia_source.md +++ b/get-started/get_fuchsia_source.md @@ -109,7 +109,7 @@ another 80 to 90 GB of space later when you build Fuchsia. Additionally, the download process uses a substantial amount of memory. It is advisible to close non-crucial processes during this time. --> -下载 Fuchsia 源码要求你机器上有 2 GB 的存储空间。之后在编译 Fuchsia 过程中需要另外 80 到 90 GB 的存储空间，这取决于你的编译选项配置。另外，下载过程中也会使用一部分的内存空间。建议您在此过程中关闭其他非必要的程序进程。 +下载 Fuchsia 源码要求您机器上有 2 GB 的存储空间。之后在编译 Fuchsia 过程中需要另外 80 到 90 GB 的存储空间，这取决于您的编译选项配置。另外，下载过程中也会使用一部分的内存空间。建议您在此过程中关闭其他非必要的程序进程。 @@ -122,7 +122,7 @@ To download the Fuchsia source, do the following: --> 1. 选择一个 Fuchsia 源码存储目录，例如： - 注意：你可以把 Fuchsia 下载到任何路径。本篇教程选择 `$HOME` 作为示例。 + 注意：您可以把 Fuchsia 下载到任何路径。本篇教程选择 `$HOME` 作为示例。 ```posix-terminal cd $HOME @@ -148,7 +148,7 @@ To download the Fuchsia source, do the following: --> 这个脚本会先创建 `fuchsia` 路径，然后下载源码到该路径下。 - 如果你在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，参考[认证失败](#authentication-error)章节寻求帮助。 + 如果您在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，参考[认证失败](#authentication-error)章节寻求帮助。 -* 添加 `.jiri_root/bin` 路径到你的 `PATH` 环境变量 +* 添加 `.jiri_root/bin` 路径到您的 `PATH` 环境变量 - `.jiri_root/bin` 路径在 Fuchsia 源码中包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些工具对 Fuchsia 的后续操作起着至关重要的作用。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，使用 `fx` 工具帮助配置、编译、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在你 `PATH` 环境变量中找得到 `jiri` 工具。 + `.jiri_root/bin` 路径在 Fuchsia 源码中包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些工具对 Fuchsia 的后续操作起着至关重要的作用。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，使用 `fx` 工具帮助配置、编译、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在您 `PATH` 环境变量中找得到 `jiri` 工具。 * 导入 `scripts/fx-env.sh` 文件 - 虽然这并不是必须的，导入 [`fx-env.sh`](/scripts/fx-env.sh) 文件可以在你的终端中建立一系列的非常有用的 shell 函数。比如，它会创建给 `fd` 工具用来切换路径时提供自动补全的 `FUCHSIA_DIR` 环境变量（如果想获取更多信息，请参考 `fx-env.sh` 文件）。 + 虽然这并不是必须的，导入 [`fx-env.sh`](/scripts/fx-env.sh) 文件可以在您的终端中建立一系列的非常有用的 shell 函数。比如，它会创建给 `fd` 工具用来切换路径时提供自动补全的 `FUCHSIA_DIR` 环境变量（如果想获取更多信息，请参考 `fx-env.sh` 文件）。 -注意：如果你不想更新你的 shell 配置，在附录中参考[不更新 PATH 变量编译 Fuchsia](#work-on-fuchsia-without-updating-your-path)。 +注意：如果您不想更新您的 shell 配置，在附录中参考[不更新 PATH 变量编译 Fuchsia](#work-on-fuchsia-without-updating-your-path)。 -为了更新你的 shell 配置文件来设置 Fuchsia 的环境变量，请按如下步骤： +为了更新您的 shell 配置文件来设置 Fuchsia 的环境变量，请按如下步骤： -1. 请用文本编辑器打开你的 `~/.bash_profile` 文件（参考如下示例，我们使用 [Nano][nano]{:.external} ） +1. 请用文本编辑器打开您的 `~/.bash_profile` 文件（参考如下示例，我们使用 [Nano][nano]{:.external} ） - 注意：这篇文章使用 `bash` 终端作为示例，如果你使用 `zsh` 的话，在如下步骤中请替换文件 `~/.bash_profile` 为 `~/.zprofile`： + 注意：这篇文章使用 `bash` 终端作为示例，如果您使用 `zsh` 的话，在如下步骤中请替换文件 `~/.bash_profile` 为 `~/.zprofile`： ```posix-terminal nano ~/.bash_profile @@ -220,9 +220,9 @@ do the following: Note: If your Fuchsia source code is not located in the `~/fuchsia` directory, replace `~/fuchsia` with your Fuchsia directory. --> -1. 在你的 `~/.bash_profile` 文件中添加如下配置： +1. 在您的 `~/.bash_profile` 文件中添加如下配置： - 注意：如果你的 Fuchsia 源码不在 `~/fuchsia` 路径下，替换 `~/fuchsia` 路径为你的 Fuchsia 路径。 + 注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 路径下，替换 `~/fuchsia` 路径为您的 Fuchsia 路径。 ```sh export PATH=~/fuchsia/.jiri_root/bin:$PATH @@ -244,7 +244,7 @@ do the following: 1. Verify that you can run the following commands inside your `fuchsia` directory without error: --> -1. 验证你是否可以运行如下命令且没有报错： +1. 验证您是否可以运行如下命令且没有报错： ```posix-terminal jiri help @@ -264,9 +264,9 @@ recommended to ensure that Fuchsia's emulator instances run smoothly on Linux. (**Linux only**) If you're planning on running Fuchsia on Linux, it is advised to run the following command to allow Fuchsia-specific traffic on the host machine: --> -注意：这一步在你的编译或者运行 Fuchsia 步骤中并不是必须的。但是是被建议的，因为可以用来确保你能在 Linux 中流畅的运行 Fuchsia 虚拟机。 +注意：这一步在您的编译或者运行 Fuchsia 步骤中并不是必须的。但是是被建议的，因为可以用来确保您能在 Linux 中流畅的运行 Fuchsia 虚拟机。 -(**Linux**) 如果你计划在 Linux 中运行 Fuchsia，建议您运行如下命令来允许 Fuchsia 使用一些特殊的特性： +(**Linux**) 如果您计划在 Linux 中运行 Fuchsia，建议您运行如下命令来允许 Fuchsia 使用一些特殊的特性： ```posix-terminal fx setup-ufw @@ -275,7 +275,7 @@ fx setup-ufw This script requires `sudo` (which asks for your password) to set the appropriate firewall rules. (For more information on this script, see [`setup-ufw`][setup-ufw].) --> -这个脚本需要 `sudo` （会提示你输入密码）权限来设置防火墙规则。（更多关于脚本的的信息，参考 [`setup-ufw`][setup-ufw] 文件）。 +这个脚本需要 `sudo` （会提示您输入密码）权限来设置防火墙规则。（更多关于脚本的的信息，参考 [`setup-ufw`][setup-ufw] 文件）。 @@ -285,7 +285,7 @@ firewall rules. (For more information on this script, see [`setup-ufw`][setup-uf To build your first Fuchsia system image, see [Configure and build Fuchsia](/get-started/build_fuchsia.md). --> -编译你第一个 Fuchsia 系统镜像，参考[配置和编译 Fuchsia](/get-started/build_fuchsia.md) 文件。 +编译您第一个 Fuchsia 系统镜像，参考[配置和编译 Fuchsia](/get-started/build_fuchsia.md) 文件。 @@ -299,7 +299,7 @@ If you see the `Invalid authentication credentials` error during the bootstrap process, your `~/.gitcookies` file may contain cookies from some repositories in `googlesource.com` that the bootstrap script wants to check out anonymously. --> -如果你在脚本运行期间看到了 `Invalid authentication credentials` 报错信息，你的 `~/.gitcookies` 文件中可能包含了一些引导脚本想要自动检测的来自 `googlesource.com` 的 cookie 信息。 +如果您在脚本运行期间看到了 `Invalid authentication credentials` 报错信息，您的 `~/.gitcookies` 文件中可能包含了一些引导脚本想要自动检测的来自 `googlesource.com` 的 cookie 信息。 @@ -342,9 +342,9 @@ example: Note: If your Fuchsia source code is not located in the `~/fuchsia` directory, replace `~/fuchsia` with your Fuchsia directory. --> -如果你不想更新你的环境变量，但是你想在任何目录中使用 `jiri` 工具，把 `jiri` 工具复制到 `~/bin` 目录中，比如： +如果您不想更新您的环境变量，但是您想在任何目录中使用 `jiri` 工具，把 `jiri` 工具复制到 `~/bin` 目录中，比如： -注意：如果你的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为你的 Fuchsia 目录。 +注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为您的 Fuchsia 目录。 ```posix-terminal cp ~/fuchsia/.jiri_root/bin/jiri ~/bin @@ -354,7 +354,7 @@ cp ~/fuchsia/.jiri_root/bin/jiri ~/bin However, you must have write access to the `~/bin` directory without `sudo`. If you don't, `jiri` cannot keep itself up-to-date. --> -无论如何，你首先需要有不用 `sudo` 命令就可以访问 `~/bin` 路径的权限。如果没有，`jiri` 就不能使它自己保持在最新版本。 +无论如何，您首先需要有不用 `sudo` 命令就可以访问 `~/bin` 路径的权限。如果没有，`jiri` 就不能使它自己保持在最新版本。 @@ -367,9 +367,9 @@ example: Note: If your Fuchsia source code is not located in the `~/fuchsia` directory, replace `~/fuchsia` with your Fuchsia directory. --> -同样的，如果你想不更新环境变量使用 `fx` 工具，在 `~/bin` 路径中提供你的 `fx` 工具的链接文件，比如： +同样的，如果您想不更新环境变量使用 `fx` 工具，在 `~/bin` 路径中提供您的 `fx` 工具的链接文件，比如： -注意：如果你的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为你的 Fuchsia 目录。 +注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为您的 Fuchsia 目录。 ```posix-terminal ln -s ~/fuchsia/scripts/fx ~/bin @@ -377,7 +377,7 @@ ln -s ~/fuchsia/scripts/fx ~/bin -相应地，你也可以使用 `fx` 工具的完整路径，比如： +相应地，您也可以使用 `fx` 工具的完整路径，比如： ```posix-terminal ./scripts/fx help @@ -385,7 +385,7 @@ Alternatively, run the `fx` tool directly using its path, for example: -另一方面，您需要在 `PATH` 环境变零中设置你的 `jiri` 工具。 +另一方面，您需要在 `PATH` 环境变零中设置您的 `jiri` 工具。 [ffx-platform-preflight]: https://fuchsia.dev/reference/tools/sdk/ffx#preflight From aa3119054f19a36794433fae73c3b0fe34d82d9e Mon Sep 17 00:00:00 2001 From: wy Date: Tue, 26 Jul 2022 20:22:57 +0800 Subject: [PATCH 3/6] get_fuchsia_source.md review --- get-started/get_fuchsia_source.md | 75 ++++++++++++++++--------------- 1 file changed, 38 insertions(+), 37 deletions(-) diff --git a/get-started/get_fuchsia_source.md b/get-started/get_fuchsia_source.md index b3a6e206..085aed85 100644 --- a/get-started/get_fuchsia_source.md +++ b/get-started/get_fuchsia_source.md @@ -7,7 +7,7 @@ This guide provides instructions on how to download the Fuchsia source code and set up the Fuchsia development environment on your machine. --> -这篇文章将指导您下载 Fuchsia 源码以及在您的机器上部署开发环境。 +本指南说明了如何下载 Fuchsia 源码以及在您的机器上部署开发环境。 @@ -19,33 +19,34 @@ The steps are: 4. [Set up environment variables](#set-up-environment-variables). 5. [Configure firewall rules (Optional)](#configure-firewall-rules). --> -1. [前期检查](#perform-a-preflight-check). -2. [安装用到的软件包](#install-prerequisite-packages). +1. [执行预检查](#perform-a-preflight-check). +2. [安装必备软件包](#install-prerequisite-packages). 3. [下载 Fuchsia 源码](#download-the-fuchsia-source-code). 4. [设置环境变量](#set-up-environment-variables). -5. [配置防火墙（可选项）](#configure-firewall-rules). +5. [配置防火墙规则（可选）](#configure-firewall-rules). -## 1. 前期检查 {#perform-a-preflight-check} +## 1. 执行预检查 {#perform-a-preflight-check} -Fuchsia 提供了一个自动检测工具（[`ffx platform preflight`][ffx-platform-preflight]），这个工具可以测试您的机器，并会在发现任何影响您编译 Fuchsia 源码的问题时通知您。 +Fuchsia 提供了一个预检工具（[`ffx platform preflight`][ffx-platform-preflight]），这个工具可以测试您的机器，并会通知您任何在该机器上构建 Fuchsia 源码时会受影响的问题。 -注意：这个检测工具只支持 x64 架构。Fuchsia 目前对其他架构的机器上的编译不做成功担保，比如 Windows 和 ARM64。 +注意：这个预检测工具只支持 x64 架构。目前 Fuchsia 不保证在其他宿主架构上能构建成功，比如 Windows 和 ARM64。 + -运行下面的命令： +运行如下命令： * {Linux} @@ -61,7 +62,7 @@ Run the following command: -## 2. 安装用到的软件包 {#install-prerequisite-packages} +## 2. 安装必备软件包 {#install-prerequisite-packages} - 安装（或更新）下面的软件： + 安装（或更新）下面的软件包： ```posix-terminal sudo apt install curl file git unzip @@ -87,7 +88,7 @@ Fuchsia 要求 `curl`、 `file`、 `unzip` 以及 `git` 等工具是最新版。 --> 安装 Xcode 命令行工具： - 注意：如果 `ffx platform preflight` 工具检测到 Xcode 已经安装，就省去这一步操作。 + 注意：如果 `ffx platform preflight` 检测到 Xcode 工具已经安装，就可以跳过这一步。 ```posix-terminal xcode-select --install @@ -109,7 +110,7 @@ another 80 to 90 GB of space later when you build Fuchsia. Additionally, the download process uses a substantial amount of memory. It is advisible to close non-crucial processes during this time. --> -下载 Fuchsia 源码要求您机器上有 2 GB 的存储空间。之后在编译 Fuchsia 过程中需要另外 80 到 90 GB 的存储空间，这取决于您的编译选项配置。另外，下载过程中也会使用一部分的内存空间。建议您在此过程中关闭其他非必要的程序进程。 +下载 Fuchsia 源码要求您机器上有 2 GB 的存储空间。取决于您的构建配置，之后的构建 Fuchsia 过程则需要额外 80 到 90 GB 的存储空间。另外，下载过程中也会使用大量的内存。建议您在此过程中关闭其他非必要的程序进程。 @@ -120,7 +121,7 @@ To download the Fuchsia source, do the following: Note: You can set up Fuchsia in any directory. This guide selects the `$HOME` directory as an example. --> -1. 选择一个 Fuchsia 源码存储目录，例如： +1. 选择一个 Fuchsia 源码下载目录，例如： 注意：您可以把 Fuchsia 下载到任何路径。本篇教程选择 `$HOME` 作为示例。 @@ -146,10 +147,9 @@ To download the Fuchsia source, do the following: bootstrapping process, see [Authentication error](#authentication-error) for help. --> - 这个脚本会先创建 `fuchsia` 路径，然后下载源码到该路径下。 - - 如果您在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，参考[认证失败](#authentication-error)章节寻求帮助。 + 这个脚本会创建 `fuchsia` 目录，并且下载源码。 + 如果您在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，参考[认证错误](#authentication-error)章节寻求帮助。 -* 添加 `.jiri_root/bin` 路径到您的 `PATH` 环境变量 +* 添加 `.jiri_root/bin` 目录到您的 `PATH` 环境变量 - `.jiri_root/bin` 路径在 Fuchsia 源码中包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些工具对 Fuchsia 的后续操作起着至关重要的作用。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，使用 `fx` 工具帮助配置、编译、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在您 `PATH` 环境变量中找得到 `jiri` 工具。 + Fuchsia 源码中的 `.jiri_root/bin` 目录包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些是 Fuchsia 工作流中的必备工具。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，使用 `fx` 工具帮助配置、构建、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在您的 `PATH` 环境变量中找到 `jiri` 工具。 * 导入 `scripts/fx-env.sh` 文件 - 虽然这并不是必须的，导入 [`fx-env.sh`](/scripts/fx-env.sh) 文件可以在您的终端中建立一系列的非常有用的 shell 函数。比如，它会创建给 `fd` 工具用来切换路径时提供自动补全的 `FUCHSIA_DIR` 环境变量（如果想获取更多信息，请参考 `fx-env.sh` 文件）。 + 虽然这并不是必须的，导入 [`fx-env.sh`](/scripts/fx-env.sh) 文件可以在您的终端中启用一系列有用的 shell 函数。比如，它会创建 `FUCHSIA_DIR` 环境变量，以及提供 `fd` 命令用来在目录中导航时提供自动补全 （如果想获取更多信息，请参考 `fx-env.sh` 文件）。 -注意：如果您不想更新您的 shell 配置，在附录中参考[不更新 PATH 变量编译 Fuchsia](#work-on-fuchsia-without-updating-your-path)。 +注意：如果您不想更新您的 shell 配置，参考附录[不更新 PATH 变量的情况下在 Fuchsia 上工作](#work-on-fuchsia-without-updating-your-path)。 -1. 请用文本编辑器打开您的 `~/.bash_profile` 文件（参考如下示例，我们使用 [Nano][nano]{:.external} ） +1. 请用文本编辑器打开您的 `~/.bash_profile` 文件（参考如下示例，我们使用 [Nano][nano]{:.external} 文本编辑器） - 注意：这篇文章使用 `bash` 终端作为示例，如果您使用 `zsh` 的话，在如下步骤中请替换文件 `~/.bash_profile` 为 `~/.zprofile`： + 注意：本指南使用 `bash` 终端作为示例，如果您使用 `zsh` 的话，在如下步骤中请替换 `~/.bash_profile` 为 `~/.zprofile`： ```posix-terminal nano ~/.bash_profile @@ -222,7 +222,7 @@ do the following: --> 1. 在您的 `~/.bash_profile` 文件中添加如下配置： - 注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 路径下，替换 `~/fuchsia` 路径为您的 Fuchsia 路径。 + 注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录下，替换 `~/fuchsia` 为您的 Fuchsia 目录。 ```sh export PATH=~/fuchsia/.jiri_root/bin:$PATH @@ -256,7 +256,7 @@ do the following: -## 5. 配置防火墙（可选项） {#configure-firewall-rules} +## 5. 配置防火墙规则（可选） {#configure-firewall-rules} -注意：这一步在您的编译或者运行 Fuchsia 步骤中并不是必须的。但是是被建议的，因为可以用来确保您能在 Linux 中流畅的运行 Fuchsia 虚拟机。 +注意：这一步对构建或者运行 Fuchsia 并不是必须的。但是为了确保 Fuchsia 模拟器实例能在 Linux 上顺利运行是推荐的。 -(**Linux**) 如果您计划在 Linux 中运行 Fuchsia，建议您运行如下命令来允许 Fuchsia 使用一些特殊的特性： +(**仅Linux**) 如果您计划在 Linux 中运行 Fuchsia，建议您运行如下命令在宿主机上允许 Fuchsia 相关的流量： ```posix-terminal fx setup-ufw @@ -285,7 +285,7 @@ firewall rules. (For more information on this script, see [`setup-ufw`][setup-uf To build your first Fuchsia system image, see [Configure and build Fuchsia](/get-started/build_fuchsia.md). --> -编译您第一个 Fuchsia 系统镜像，参考[配置和编译 Fuchsia](/get-started/build_fuchsia.md) 文件。 +构建您第一个 Fuchsia 系统镜像，参考[配置和构建 Fuchsia](/get-started/build_fuchsia.md)。 @@ -293,7 +293,7 @@ To build your first Fuchsia system image, see -### 验证失败 {#authentication-error} +### 认证错误 {#authentication-error} -* 按照屏幕路径的提示为仓库输入密码 -* 删除 `.gitcookies` 文件中不需要的 cookie。 +* 按照屏幕上的指示为特定的仓库获取密码 +* 删除 `.gitcookies` 文件中有问题的 cookie。 -* [把工具复制到可执行文件目录](#copy-the-tool-to-your-binary-directory) -* [为工具添加链接文件到可执行文件目录](#add-a-symlink-to-your-binary-directory) +* [把工具复制到二进制目录](#copy-the-tool-to-your-binary-directory) +* [添加符号链接到二进制目录](#add-a-symlink-to-your-binary-directory) -#### 把工具复制到可执行文件目录 {#copy-the-tool-to-your-binary-directory} +#### 把工具复制到二进制目录 {#copy-the-tool-to-your-binary-directory} -无论如何，您首先需要有不用 `sudo` 命令就可以访问 `~/bin` 路径的权限。如果没有，`jiri` 就不能使它自己保持在最新版本。 +但是，您需要在没有 `sudo` 的情况下对 `~/bin` 有写访问权限。如果没有，`jiri` 就不能保持在最新版本。 -#### 为工具添加链接文件到可执行文件目录 {#add-a-symlink-to-your-binary-directory} +#### 添加符号链接到二进制目录 {#add-a-symlink-to-your-binary-directory} 同样的，如果您想不更新环境变量使用 `fx` 工具，在 `~/bin` 路径中提供您的 `fx` 工具的链接文件，比如： +同样的，如果您想不更新环境变量而使用 `fx` 工具，在 `~/bin` 目录中提供 `fx` 工具的符号链接，比如： 注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为您的 Fuchsia 目录。 @@ -377,7 +378,7 @@ ln -s ~/fuchsia/scripts/fx ~/bin -相应地，您也可以使用 `fx` 工具的完整路径，比如： +或者，直接用其路径运行 `fx` 工具，比如： ```posix-terminal ./scripts/fx help @@ -385,7 +386,7 @@ Alternatively, run the `fx` tool directly using its path, for example: -另一方面，您需要在 `PATH` 环境变零中设置您的 `jiri` 工具。 +无论哪种情况，您都需要`jiri` 工具在您的 `PATH` 环境变量中。 [ffx-platform-preflight]: https://fuchsia.dev/reference/tools/sdk/ffx#preflight From 68f09aa0689e0ad58897799087732af6e9285ae9 Mon Sep 17 00:00:00 2001 From: wy Date: Thu, 28 Jul 2022 19:31:23 +0800 Subject: [PATCH 4/6] get_fuchsia_source.md file review --- get-started/get_fuchsia_source.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/get-started/get_fuchsia_source.md b/get-started/get_fuchsia_source.md index 085aed85..6de3c255 100644 --- a/get-started/get_fuchsia_source.md +++ b/get-started/get_fuchsia_source.md @@ -299,7 +299,7 @@ If you see the `Invalid authentication credentials` error during the bootstrap process, your `~/.gitcookies` file may contain cookies from some repositories in `googlesource.com` that the bootstrap script wants to check out anonymously. --> -如果您在脚本运行期间看到了 `Invalid authentication credentials` 报错信息，您的 `~/.gitcookies` 文件中可能包含了一些引导脚本想要自动检测的来自 `googlesource.com` 的 cookie 信息。 +如果您在引导脚本运行过程中看到了 `Invalid authentication credentials` 报错信息，您的 `~/.gitcookies` 文件中可能包含了来自 `googlesource.com` 中的一些仓库的 cookie，引导脚本想要匿名检出。 @@ -386,7 +386,7 @@ Alternatively, run the `fx` tool directly using its path, for example: -无论哪种情况，您都需要`jiri` 工具在您的 `PATH` 环境变量中。 +无论哪种情况，您都需要 `jiri` 工具在您的 `PATH` 环境变量中。 [ffx-platform-preflight]: https://fuchsia.dev/reference/tools/sdk/ffx#preflight From 455dfb058bcb123a53269f020058d759df35b598 Mon Sep 17 00:00:00 2001 From: wy Date: Sun, 31 Jul 2022 22:34:41 +0800 Subject: [PATCH 5/6] get_fuchsia_source.md file review --- get-started/get_fuchsia_source.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/get-started/get_fuchsia_source.md b/get-started/get_fuchsia_source.md index 6de3c255..4ad24397 100644 --- a/get-started/get_fuchsia_source.md +++ b/get-started/get_fuchsia_source.md @@ -264,9 +264,9 @@ recommended to ensure that Fuchsia's emulator instances run smoothly on Linux. (**Linux only**) If you're planning on running Fuchsia on Linux, it is advised to run the following command to allow Fuchsia-specific traffic on the host machine: --> -注意：这一步对构建或者运行 Fuchsia 并不是必须的。但是为了确保 Fuchsia 模拟器实例能在 Linux 上顺利运行是推荐的。 +注意：这一步对构建或者运行 Fuchsia 并不是必需的。但是为了确保 Fuchsia 模拟器实例能在 Linux 上顺利运行是推荐的。 -(**仅Linux**) 如果您计划在 Linux 中运行 Fuchsia，建议您运行如下命令在宿主机上允许 Fuchsia 相关的流量： +(**仅限 Linux**) 如果您计划在 Linux 中运行 Fuchsia，建议您运行如下命令在宿主机上允许 Fuchsia 相关的流量： ```posix-terminal fx setup-ufw @@ -279,13 +279,13 @@ firewall rules. (For more information on this script, see [`setup-ufw`][setup-uf -## 下一步 +## 后续步骤 -构建您第一个 Fuchsia 系统镜像，参考[配置和构建 Fuchsia](/get-started/build_fuchsia.md)。 +要构建您第一个 Fuchsia 系统镜像，请参考[配置和构建 Fuchsia](/get-started/build_fuchsia.md)。 @@ -299,11 +299,11 @@ If you see the `Invalid authentication credentials` error during the bootstrap process, your `~/.gitcookies` file may contain cookies from some repositories in `googlesource.com` that the bootstrap script wants to check out anonymously. --> -如果您在引导脚本运行过程中看到了 `Invalid authentication credentials` 报错信息，您的 `~/.gitcookies` 文件中可能包含了来自 `googlesource.com` 中的一些仓库的 cookie，引导脚本想要匿名检出。 +如果您在引导脚本运行过程中看到了 `Invalid authentication credentials` 报错信息，那么您的 `~/.gitcookies` 文件中可能包含了来自 `googlesource.com` 中一些仓库的 cookie，引导脚本想要匿名检出。 -为了解决这个问题，使用以下任何一个方式： +要解决该错误，请使用以下方式之一： -* 按照屏幕上的指示为特定的仓库获取密码 +* 按照屏幕上的指示为特定的仓库获取密码。 * 删除 `.gitcookies` 文件中有问题的 cookie。 -# 下载 Fuchsia 源码 +# 下载 Fuchsia 源代码 -本指南说明了如何下载 Fuchsia 源码以及在您的机器上部署开发环境。 +本指南说明了如何下载 Fuchsia 源代码以及在您的机器上部署开发环境。 @@ -21,7 +21,7 @@ The steps are: --> 1. [执行预检查](#perform-a-preflight-check). 2. [安装必备软件包](#install-prerequisite-packages). -3. [下载 Fuchsia 源码](#download-the-fuchsia-source-code). +3. [下载 Fuchsia 源代码](#download-the-fuchsia-source-code). 4. [设置环境变量](#set-up-environment-variables). 5. [配置防火墙规则（可选）](#configure-firewall-rules). @@ -35,13 +35,13 @@ Fuchsia provides a preflight check tool that examines your machine and informs you of any issues that may affect building Fuchsia from source on the machine. --> -Fuchsia 提供了一个预检工具（[`ffx platform preflight`][ffx-platform-preflight]），这个工具可以测试您的机器，并会通知您任何在该机器上构建 Fuchsia 源码时会受影响的问题。 +Fuchsia 提供了一个预检查工具（[`ffx platform preflight`][ffx-platform-preflight]），这个工具可以测试您的机器，并会通知您在该机器上可能会影响从源代码构建 Fuchsia 的任何问题。 -注意：这个预检测工具只支持 x64 架构。目前 Fuchsia 不保证在其他宿主架构上能构建成功，比如 Windows 和 ARM64。 +注意：这个预检查工具只支持 x64 架构。目前 Fuchsia 不保证在其他宿主架构上能构建成功，比如 Windows 和 ARM64。 @@ -67,19 +68,21 @@ Run the following command: Fuchsia requires `curl`, `file`, `unzip`, and `git` to be up to date. The version of `git` needs to be 2.28 or higher. --> -Fuchsia 要求 `curl`、 `file`、 `unzip` 以及 `git` 等工具是最新版。 `git` 版本要求 2.28 或以上。 +Fuchsia 要求 `curl`、 `file`、 `unzip` 以及 `git` 等工具是最新版。 `git` 版本需为 2.28 或以上。 * {Linux} + - 安装（或更新）下面的软件包： + 安装（或更新）以下软件包： ```posix-terminal sudo apt install curl file git unzip ``` * {macOS} + 安装 Xcode 命令行工具： - 注意：如果 `ffx platform preflight` 检测到 Xcode 工具已经安装，就可以跳过这一步。 + 注意：如果 `ffx platform preflight` 显示 Xcode 工具已经安装，则请跳过这一步。 ```posix-terminal xcode-select --install ``` + -## 3. 下载 Fuchsia 源码 {#download-the-fuchsia-source-code} +## 3. 下载 Fuchsia 源代码 {#download-the-fuchsia-source-code} -Fuchsia 提供了一个[引导脚本](/scripts/bootstrap)，这个脚本会创建一个 `fuchsia` 的文件夹并把 Fuchsia 源码下载到这里。 +Fuchsia 提供了一个[引导脚本](/scripts/bootstrap)，这个脚本会创建一个名为 `fuchsia` 的文件夹，并把 Fuchsia 源码下载到这里。 -下载 Fuchsia 源码要求您机器上有 2 GB 的存储空间。取决于您的构建配置，之后的构建 Fuchsia 过程则需要额外 80 到 90 GB 的存储空间。另外，下载过程中也会使用大量的内存。建议您在此过程中关闭其他非必要的程序进程。 +下载 Fuchsia 源码要求您机器上有大约 2 GB 的存储空间。根据您的构建配置，之后在构建 Fuchsia 时，您还额外需要 80 到 90 GB 的存储空间。另外，下载过程中也会使用大量的内存。建议您在此过程中关闭其他非必要的进程。 -下载 Fuchsia 源码，请按如下步骤： +要下载 Fuchsia 源代码，请执行如下步骤： -1. 选择一个 Fuchsia 源码下载目录，例如： +1. 选择一个 Fuchsia 源代码下载目录，例如： - 注意：您可以把 Fuchsia 下载到任何路径。本篇教程选择 `$HOME` 作为示例。 + 注意：您可以在任何目录下设置 Fuchsia。本指南选择 `$HOME` 作为示例。 ```posix-terminal cd $HOME ``` + 1. 运行引导脚本： - 注意：下载 Fuchsia 源码可能需要 60 分钟。 + 注意：下载 Fuchsia 源代码可能需要 60 分钟。 ```posix-terminal curl -s "https://fuchsia.googlesource.com/fuchsia/+/HEAD/scripts/bootstrap?format=TEXT" | base64 --decode | bash @@ -147,9 +152,9 @@ To download the Fuchsia source, do the following: bootstrapping process, see [Authentication error](#authentication-error) for help. --> - 这个脚本会创建 `fuchsia` 目录，并且下载源码。 + 这个脚本会创建 `fuchsia` 目录，并且下载源代码。 - 如果您在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，参考[认证错误](#authentication-error)章节寻求帮助。 + 如果您在脚本运行期间看到了 `Invalid authentication credentials` 错误信息，请参考[认证错误](#authentication-error)章节寻求帮助。 -Fuchsia 建议您在 shell 的配置文件中添加如下几个配置： +Fuchsia 建议您按照如下操作更新 shell 配置文件： * 添加 `.jiri_root/bin` 目录到您的 `PATH` 环境变量 - Fuchsia 源码中的 `.jiri_root/bin` 目录包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些是 Fuchsia 工作流中的必备工具。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，使用 `fx` 工具帮助配置、构建、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在您的 `PATH` 环境变量中找到 `jiri` 工具。 + Fuchsia 源码中的 `.jiri_root/bin` 目录包含了 [`jiri`](https://fuchsia.googlesource.com/jiri) 和 [`fx`](/development/build/fx.md) 工具，这些是 Fuchsia 工作流中的必备工具。Fuchsia 使用 `jiri` 工具在 Fuchsia 的项目中管理仓库，而 `fx` 工具能够帮助配置、构建、运行以及调试 Fuchsia。Fuchsia 的工具链需要可以在您的 `PATH` 环境变量中找到 `jiri` 工具。 -注意：如果您不想更新您的 shell 配置，参考附录[不更新 PATH 变量的情况下在 Fuchsia 上工作](#work-on-fuchsia-without-updating-your-path)。 +注意：如果您不想更新您的 shell 配置，则请参阅[在不更新 PATH 变量的情况下处理 Fuchsia](#work-on-fuchsia-without-updating-your-path)。 -为了更新您的 shell 配置文件来设置 Fuchsia 的环境变量，请按如下步骤： +要更新您的 shell 配置文件来设置 Fuchsia 的环境变量，请执行如下步骤： -1. 请用文本编辑器打开您的 `~/.bash_profile` 文件（参考如下示例，我们使用 [Nano][nano]{:.external} 文本编辑器） +1. 使用文本编辑器打开您的 `~/.bash_profile` 文件（在以下示例中，我们使用 [Nano][nano]{:.external} 文本编辑器）： - 注意：本指南使用 `bash` 终端作为示例，如果您使用 `zsh` 的话，在如下步骤中请替换 `~/.bash_profile` 为 `~/.zprofile`： + 注意：本指南使用 `bash` 终端作为示例，如果您使用 `zsh`，请在后续步骤中请替换 `~/.bash_profile` 为 `~/.zprofile`： ```posix-terminal nano ~/.bash_profile ``` + 1. 在您的 `~/.bash_profile` 文件中添加如下配置： - 注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录下，替换 `~/fuchsia` 为您的 Fuchsia 目录。 + 注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录下，则请替换 `~/fuchsia` 为您的 Fuchsia 目录。 + ```sh export PATH=~/fuchsia/.jiri_root/bin:$PATH source ~/fuchsia/scripts/fx-env.sh ``` + @@ -235,16 +243,17 @@ do the following: -1. 更新环境变量，请运行如下命令： +1. 要更新环境变量，请运行如下命令： ```posix-terminal source ~/.bash_profile ``` + -1. 验证您是否可以运行如下命令且没有报错： +1. 验证您可以在您的 `fuchsia` 目录内运行如下命令且没有报错： ```posix-terminal jiri help @@ -264,9 +273,9 @@ recommended to ensure that Fuchsia's emulator instances run smoothly on Linux. (**Linux only**) If you're planning on running Fuchsia on Linux, it is advised to run the following command to allow Fuchsia-specific traffic on the host machine: --> -注意：这一步对构建或者运行 Fuchsia 并不是必需的。但是为了确保 Fuchsia 模拟器实例能在 Linux 上顺利运行是推荐的。 +注意：这一步对构建或者运行 Fuchsia 并不是必需的。但是推荐您进行该步骤，以确保 Fuchsia 模拟器实例能在 Linux 上流畅运行。 -(**仅限 Linux**) 如果您计划在 Linux 中运行 Fuchsia，建议您运行如下命令在宿主机上允许 Fuchsia 相关的流量： +(**仅限 Linux**) 如果您计划在 Linux 中运行 Fuchsia，那么建议您运行如下命令，在宿主机上允许 Fuchsia 特定流量： ```posix-terminal fx setup-ufw @@ -275,7 +284,7 @@ fx setup-ufw This script requires `sudo` (which asks for your password) to set the appropriate firewall rules. (For more information on this script, see [`setup-ufw`][setup-ufw].) --> -这个脚本需要 `sudo` （会提示您输入密码）权限来设置防火墙规则。（更多关于脚本的的信息，参考 [`setup-ufw`][setup-ufw] 文件）。 +该脚本需要 `sudo` 权限（会要求您输入密码）来设置适当的防火墙规则。（要获取关于该脚本的更多信息，请参考 [`setup-ufw`][setup-ufw]）。 @@ -285,7 +294,7 @@ firewall rules. (For more information on this script, see [`setup-ufw`][setup-uf To build your first Fuchsia system image, see [Configure and build Fuchsia](/get-started/build_fuchsia.md). --> -要构建您第一个 Fuchsia 系统镜像，请参考[配置和构建 Fuchsia](/get-started/build_fuchsia.md)。 +要构建您第一个 Fuchsia 系统镜像，请参阅[配置和构建 Fuchsia](/get-started/build_fuchsia.md)。 @@ -299,7 +308,7 @@ If you see the `Invalid authentication credentials` error during the bootstrap process, your `~/.gitcookies` file may contain cookies from some repositories in `googlesource.com` that the bootstrap script wants to check out anonymously. --> -如果您在引导脚本运行过程中看到了 `Invalid authentication credentials` 报错信息，那么您的 `~/.gitcookies` 文件中可能包含了来自 `googlesource.com` 中一些仓库的 cookie，引导脚本想要匿名检出。 +如果您在引导脚本运行过程中看到了 `Invalid authentication credentials`（无效的认证凭据）错误信息，那么您的 `~/.gitcookies` 文件中可能含有来自 `googlesource.com` 中一些仓库的 cookie，引导脚本想要匿名检查。 @@ -311,7 +320,7 @@ To resolve this error, do one of the following: * Delete the offending cookies from the `.gitcookies` file. --> -* 按照屏幕上的指示为特定的仓库获取密码。 +* 按照屏幕上的指示为指定仓库获取密码。 * 删除 `.gitcookies` 文件中有问题的 cookie。 -下面的章节为[设置环境变量](#set-up-environment-variables)章节提供了替代选项： +下面的章节为[设置环境变量](#set-up-environment-variables)章节提供了替代方法： -如果您不想更新您的环境变量，但是您想在任何目录中使用 `jiri` 工具，把 `jiri` 工具复制到 `~/bin` 目录中，比如： +如果您不想更新您的环境变量，但是想在任何目录中使用 `jiri` 工具，那么请把 `jiri` 工具复制到 `~/bin` 目录中，比如： -注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为您的 Fuchsia 目录。 +注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，则请把 `~/fuchsia` 替换为您的 Fuchsia 目录。 ```posix-terminal cp ~/fuchsia/.jiri_root/bin/jiri ~/bin @@ -354,7 +363,7 @@ cp ~/fuchsia/.jiri_root/bin/jiri ~/bin However, you must have write access to the `~/bin` directory without `sudo`. If you don't, `jiri` cannot keep itself up-to-date. --> -但是，您需要在没有 `sudo` 的情况下对 `~/bin` 有写访问权限。如果没有，`jiri` 就不能保持在最新版本。 +但是，您必须在没有 `sudo` 的情况下对 `~/bin` 有写访问权限。否则，`jiri` 无法自动保持最新版本。 @@ -367,10 +376,9 @@ example: Note: If your Fuchsia source code is not located in the `~/fuchsia` directory, replace `~/fuchsia` with your Fuchsia directory. --> -同样的，如果您想不更新环境变量使用 `fx` 工具，在 `~/bin` 路径中提供您的 `fx` 工具的链接文件，比如： -同样的，如果您想不更新环境变量而使用 `fx` 工具，在 `~/bin` 目录中提供 `fx` 工具的符号链接，比如： +同样地，如果您想在不更新环境变量的情况下使用 `fx` 工具，则请在 `~/bin` 路径中添加您 `fx` 工具的链接文件，比如： -注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，把 `~/fuchsia` 替换为您的 Fuchsia 目录。 +注意：如果您的 Fuchsia 源码不在 `~/fuchsia` 目录中，则请把 `~/fuchsia` 替换为您的 Fuchsia 目录。 ```posix-terminal ln -s ~/fuchsia/scripts/fx ~/bin @@ -378,7 +386,7 @@ ln -s ~/fuchsia/scripts/fx ~/bin -或者，直接用其路径运行 `fx` 工具，比如： +或者，请直接使用 `fx` 工具的路径来运行，比如： ```posix-terminal ./scripts/fx help