From 8924986cd3f836215a994655f848d50389c57f9e Mon Sep 17 00:00:00 2001 From: cwolf9 <2717232422@qq.com> Date: Thu, 4 Aug 2022 21:23:35 +0800 Subject: [PATCH 01/10] =?UTF-8?q?=E7=BF=BB=E8=AF=91=20get-started/=5Fcommo?= =?UTF-8?q?n/components/=5Ftests=5Fintro.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- get-started/_common/components/_tests_intro.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/get-started/_common/components/_tests_intro.md b/get-started/_common/components/_tests_intro.md index 9b994c64..eac6dac3 100644 --- a/get-started/_common/components/_tests_intro.md +++ b/get-started/_common/components/_tests_intro.md @@ -1,19 +1,31 @@ + +Fuchsia **测试运行器框架**（Test Runner Framework）使开发者能够使用各种语言和运行时为组件构建测试，并在目标设备上执行它们。该框架提供了实现 `fuchsia.test.Suite` 协议的**测试运行器**组件，并与通用的特定语言的测试框架（如 GoogleTest (C++)）集成。 + +`test_manager` 组件负责在 Fuchsia 设备上运行测试。它检查实现测试套件协议的组件,并将它们作为子组件启动。这意味着 `test_manager` 也负责为每个测试套件提供能力，即创建通常称为**测试领域**的东西。 + +![图中显示了测试运行器框架如何为开发者提供接口来公开测试套件，以及开发者工具如何在 Fuchsia 设备上执行测试。](/get-started/images/components/test-realm.png){: width="714"} + +`ffx test` 等开发者工具与设备上的 `test_manager` 进行通信，以执行测试套件并检索结果。 From ba1347427fe1ce1dd7e60eb533aeb44e7b99908d Mon Sep 17 00:00:00 2001 From: cwolf9 <2717232422@qq.com> Date: Thu, 4 Aug 2022 21:24:52 +0800 Subject: [PATCH 02/10] =?UTF-8?q?=E7=BF=BB=E8=AF=91=20get-started/=5Fcommo?= =?UTF-8?q?n/fidl/=5Ftesting=5Fintro.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- get-started/_common/fidl/_testing_intro.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/get-started/_common/fidl/_testing_intro.md b/get-started/_common/fidl/_testing_intro.md index b1611972..159e3aa8 100644 --- a/get-started/_common/fidl/_testing_intro.md +++ b/get-started/_common/fidl/_testing_intro.md @@ -1,3 +1,4 @@ + +[集成测试](https://en.wikipedia.org/wiki/Integration_testing){:.external} 侧重于验证组件的行为，因为它会与系统上其他组件进行交互。正因为如此，集成测试通常与主组件分开构建，并且可以将被测组件和其他依赖组件声明为子组件。根据测试的性质，依赖组件可以作为模拟或存根提供，以促进测试用例保持封闭性。 From a50c8f9a0c1de013e360b4abb40b6b7debb172e3 Mon Sep 17 00:00:00 2001 From: tabidachinokaze Date: Sat, 6 Aug 2022 22:04:24 +0800 Subject: [PATCH 03/10] =?UTF-8?q?=E7=BF=BB=E8=AF=91=20get-started/=5Fcommo?= =?UTF-8?q?n/components/=5Forganizing=5Flifecycle.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../components/_organizing_lifecycle.md | 30 ++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/get-started/_common/components/_organizing_lifecycle.md b/get-started/_common/components/_organizing_lifecycle.md index 7ae52f80..a797afff 100644 --- a/get-started/_common/components/_organizing_lifecycle.md +++ b/get-started/_common/components/_organizing_lifecycle.md @@ -1,37 +1,65 @@ -## Component lifecycle + +## 组件生命周期 + +在组件拓扑中添加和移除组件实例时，会创建和销毁组件实例。这可以通过以下两种方式之一发生： + +* **静态地**：该实例在组件清单中被声明为树中另一个组件的子组件。静态组件仅当一个更新更改组件拓扑时才会创建和销毁。 + +* **动态地**：实例在运行时使用 `fuchsia.component.Realm` 协议在组件 `collection` 中添加或移除。动态组件在系统关闭时销毁。 + +一旦组件被销毁，框架就会移除它的持久状态（比如本地存储）。 + +框架会启动一个组件实例当另一个组件尝试打开一个通道到该组件实例时——这称为**绑定**。当连接到一个由组件公开的能力时，绑定会**隐式**发生。绑定到已经启动的组件会连接到当前运行的实例。 + + + +组件可能会通过退出程序（由组件的 `runner` 定义）自行停止，或者框架可能会在系统关闭时停止组件。在被销毁之前，框架将组件移动到**关闭**状态以指示它不能再次启动。 + +![该图显示了组件如何具有两种不同的状态：实例和执行。这些状态描述了“组件生命周期”。](/get-started/images/components/component-lifecycle.png){: width="662"} + +注意：要获取关于组件状态和执行的更多详细信息，请参阅[组件生命周期](/concepts/components/v2/lifecycle.md)。 From 8fb3e471682da3742b9474e1fdd42ae31a6f4e3c Mon Sep 17 00:00:00 2001 From: tabidachinokaze Date: Tue, 9 Aug 2022 01:22:01 +0800 Subject: [PATCH 04/10] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E5=BB=BA=E8=AE=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- get-started/_common/components/_organizing_lifecycle.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/get-started/_common/components/_organizing_lifecycle.md b/get-started/_common/components/_organizing_lifecycle.md index a797afff..6e5a9e85 100644 --- a/get-started/_common/components/_organizing_lifecycle.md +++ b/get-started/_common/components/_organizing_lifecycle.md @@ -12,7 +12,7 @@ in the component topology. This can happen in one of two ways: of another component in the tree. Static components are only created and destroyed when an update changes the component topology. --> -* **静态地**：该实例在组件清单中被声明为树中另一个组件的子组件。静态组件仅当一个更新更改组件拓扑时才会创建和销毁。 +* **静态地**：该实例在组件清单中被声明为树中另一个组件的子组件。静态组件仅当一个更新改变了组件拓扑时才会创建和销毁。 -框架会启动一个组件实例当另一个组件尝试打开一个通道到该组件实例时——这称为**绑定**。当连接到一个由组件公开的能力时，绑定会**隐式**发生。绑定到已经启动的组件会连接到当前运行的实例。 +当一个组件尝试打开到另一组件的通道时（这称为**绑定**（binding）），框架会启动后者的一个组件实例。当连接到由组件所暴露的能力时，绑定会**隐式**发生。对已经启动的组件进行绑定，会连接到其当前运行的实例。 -组件可能会通过退出程序（由组件的 `runner` 定义）自行停止，或者框架可能会在系统关闭时停止组件。在被销毁之前，框架将组件移动到**关闭**状态以指示它不能再次启动。 +组件可能会通过退出程序（由组件的 `runner` 定义）自行停止，或者可能由框架在系统关闭时停止。在被销毁之前，框架将组件移动到**关闭**状态以表示它不能再次启动。 -`test_manager` 组件负责在 Fuchsia 设备上运行测试。它检查实现测试套件协议的组件,并将它们作为子组件启动。这意味着 `test_manager` 也负责为每个测试套件提供能力，即创建通常称为**测试领域**的东西。 +`test_manager` 组件负责在 Fuchsia 设备上运行测试。它检查实现测试套件协议的组件，并将它们作为子组件启动。这意味着 `test_manager` 也负责为每个测试套件提供能力，即创建通常所谓的**测试领域**。 -`ffx test` 等开发者工具与设备上的 `test_manager` 进行通信，以执行测试套件并检索结果。 +`ffx test` 等开发者工具与设备上的 `test_manager` 进行通信，以执行测试套件并取回结果。 From b2e6dc6fc135d1aee34749b8bec5528ae00d2723 Mon Sep 17 00:00:00 2001 From: cwolf9 <2717232422@qq.com> Date: Tue, 9 Aug 2022 09:18:14 +0800 Subject: [PATCH 06/10] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=B8=8D=E5=B8=B8?= =?UTF-8?q?=E8=A7=81=E5=8D=95=E8=AF=8D=E7=9A=84=E7=BF=BB=E8=AF=91=E6=A0=87?= =?UTF-8?q?=E6=B3=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- get-started/_common/fidl/_testing_intro.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/_common/fidl/_testing_intro.md b/get-started/_common/fidl/_testing_intro.md index 159e3aa8..20be291d 100644 --- a/get-started/_common/fidl/_testing_intro.md +++ b/get-started/_common/fidl/_testing_intro.md @@ -7,4 +7,4 @@ and other dependencies as children. Depending on the nature of the test, dependency components may be provided as mocks or stubs to promote that the test cases remain hermetic. --> -[集成测试](https://en.wikipedia.org/wiki/Integration_testing){:.external} 侧重于验证组件的行为，因为它会与系统上其他组件进行交互。正因为如此，集成测试通常与主组件分开构建，并且可以将被测组件和其他依赖组件声明为子组件。根据测试的性质，依赖组件可以作为模拟或存根提供，以促进测试用例保持封闭性。 +[集成测试](https://en.wikipedia.org/wiki/Integration_testing){:.external} 侧重于验证组件的行为，因为它会与系统上其他组件进行交互。正因为如此，集成测试通常与主组件分开构建，并且可能将被测组件和其他依赖组件声明为子组件。根据测试的性质，依赖组件可以作为模拟（mock）或存根（stub）提供，以促进测试用例保持封闭性。 From d6d26aa755b5eec72208c70acedb3505c4e9a40a Mon Sep 17 00:00:00 2001 From: y2-Whyto Date: Tue, 9 Aug 2022 20:21:50 +0800 Subject: [PATCH 07/10] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20job?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit https://developer.android.com/kotlin/coroutines/coroutines-adv --- glossary-translation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/glossary-translation.md b/glossary-translation.md index 4a774ebf..4d0bf7a0 100644 --- a/glossary-translation.md +++ b/glossary-translation.md @@ -52,6 +52,7 @@ | in-tree | 树内 | G
此处指源码树 | | infrastructure | 基础架构 | G | | inspect | 审视 | Fuchsia 专有名词
i | +| job | 作业 | G | | just-in-time (JIT) compilation | 即时（JIT）编译 | G | | moniker | 代称 | i | | mount | 装载 | G | From efb6573aaa588b2a2179570a755bf7a59d3503ec Mon Sep 17 00:00:00 2001 From: y2-Whyto Date: Tue, 9 Aug 2022 20:38:04 +0800 Subject: [PATCH 08/10] parse, parser --- glossary-translation.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/glossary-translation.md b/glossary-translation.md index 4d0bf7a0..cd8b978c 100644 --- a/glossary-translation.md +++ b/glossary-translation.md @@ -58,6 +58,8 @@ | mount | 装载 | G | | namespace | 命名空间 | G | | out-of-tree | 树外 | G
此处指源码树 | +| parse | 解析 | G | +| parser | 解析器 | G | | path | 路径 | G | | pave | 铺设 | i | | policy | 政策 | G | From a2574ef4db918e04f84e51257fc84393f1314864 Mon Sep 17 00:00:00 2001 From: y2-Whyto Date: Tue, 9 Aug 2022 21:13:37 +0800 Subject: [PATCH 09/10] realm --- glossary-translation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/glossary-translation.md b/glossary-translation.md index cd8b978c..89755e05 100644 --- a/glossary-translation.md +++ b/glossary-translation.md @@ -66,6 +66,7 @@ | prerequisites | 前提条件 | G | | product | 产品 | i & G | | proxy | 代理 | | +| realm | 领域 | i | | remote | 远程 | | | robust | 可靠的 | G | | sandbox | 沙盒 | G | From 6c4d45e0adeed37d66a305b2f3481437f462ea79 Mon Sep 17 00:00:00 2001 From: y2-Whyto Date: Tue, 9 Aug 2022 21:45:58 +0800 Subject: [PATCH 10/10] expose https://support.google.com/cloudidentity/answer/9167101?hl=zh-Hans https://support.google.com/tagmanager/answer/7683362?hl=zh-Hans --- glossary-translation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/glossary-translation.md b/glossary-translation.md index 89755e05..ced0929b 100644 --- a/glossary-translation.md +++ b/glossary-translation.md @@ -40,6 +40,7 @@ | ergonomics | 工效学 | i & G | | escalate | 上报 | G | | execute-only memory | 只执行内存 | G | +| expose | 公开
显示 | G
具体选择取决于语境，亦有“公开显示”译法 | | fault injection | 故障注入 | G | | fully qualified URL | 完全限定的网址 | G | | get stared | 使用入门
入门 | G
前者更常用 |