1304: Update AccessControl.md ⭐️⭐️⭐️⭐️⭐️ #1379
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
AccessControl.md 翻译第一稿
把代码注释中的“输出”换成“打印”
yongfrank
changed the title
pujiaxin33
reviewed
Sep 26, 2024
|
|
||
| **访问控制**可以限制其它源文件或模块对你的代码的访问。这个特性让你能够隐藏代码的实现细节，并指定一个接口来让别人访问和使用你的代码。 | ||
|
|
||
| 你可以给单个类型（类、结构体和枚举）设置特定的访问级别，也可以给这些类型的属性、方法、初始化器、下标等设置访问级别。协议可以被限制在特定的上下文中，全局常量、变量和函数也可以如此。 |
|
|
||
| Swift 的访问控制模型是基于模块、源文件和包（packages）这三个概念的。 | ||
|
|
||
| **模块**是代码分发的独立单元——一个框架或应用程序作为一个整体构建和发布，并且可以通过 Swift 的 `import` 关键字被其他模块导入。 |
|
|
||
| **模块**是代码分发的独立单元——一个框架或应用程序作为一个整体构建和发布，并且可以通过 Swift 的 `import` 关键字被其他模块导入。 | ||
|
|
||
| 在 Swift 中，Xcode 的每个构建目标（例如应用程序或框架）都被视为一个独立的模块。如果你将应用程序中的部分代码打包成一个独立的框架——以便封装这些代码并在多个应用程序中重用，那么当这个框架被导入到某个应用程序或其他框架中使用时，你在框架中定义的所有内容都将属于这个独立的模块。 |
There was a problem hiding this comment.
独立的框架后面的“——”符号建议更改为逗号,
| using APIs from the [PackageDescription][] module, | ||
| and if you use Xcode, you specify the package name | ||
| in the Package Access Identifier build setting. | ||
| **包**是一组模块的集合，这些模块作为一个整体进行开发。选择哪些模块来构成一个包，是在我们所使用的构建系统中配置的，而不是在 Swift 源代码中。例如，如果使用 Swift Package Manager 构建代码，你会在 `Package.swift` 文件中使用 [PackageDescription][] 模块的 API 来定义包；如果使用 Xcode，你会在“Package Access Identifier”构建设置中指定包名。 |
There was a problem hiding this comment.
“Package Access Identifier” 两边加上空格
|
|
||
| Swift 为代码中的实体提供了六种不同的**访问级别**。这些访问级别取决于实体所在的源文件、源文件所属的模块，以及模块所属的包。 | ||
|
|
||
| - *open* 和 *public* 允许实体在同一模块的任意源文件内使用，也可以在导入该模块的其他模块的源文件内使用。通常使用 open 或 public 访问级别来指定框架的公共接口。open 和 public 访问级别的区别将在下文中说明。 |
There was a problem hiding this comment.
建议将
open 和 public 允许实体在同一模块的任意源文件内使用
翻译为：
open 和 public 允许实体被同一模块内的任意源文件使用
| the original implementation of `someMethod()`: | ||
| ## 子类 | ||
|
|
||
| 你可以继承同一模块中的所有有访问权限的类，也可以继承不同模块中被 `open` 修饰的类。子类的访问级别不得高于父类的访问级别——例如，你不能写一个 `public` 的子类来继承 `internal` 的父类。 |
There was a problem hiding this comment.
不得高于父类的访问级别——
建议后面的——符号修改为句号。
| @@ -899,16 +680,15 @@ when it's used outside the structure's definition. | |||
| <rdar://problem/54089342> REPL fails to enforce private(set) on struct property | |||
| --> | |||
|
|
||
| 当你编写或扩展一个类型让它遵循一个协议时，你必须确保该类型对协议每一个要求的实现至少与协议的访问级别一致。例如，如果一个 `public` 类型遵循一个 `internal` 协议，那么该类型对协议每一个要求的实现必须至少是 `internal`。 | ||
|
|
||
| > 注意: Swift 和 Objective-C 一样，协议遵循是全局的——在同一程序中，一个类型不可能用两种不同的方式遵循同一个协议。 |
There was a problem hiding this comment.
协议遵循是全局的——
这里的——符号建议更改为句号。
| @@ -1409,6 +1103,14 @@ to organize your code, | |||
| whether or not your types have private entities. | |||
| For example, given the following simple protocol: | |||
| The access level for a generic type or generic function is | ||
| the minimum of the access level of the generic type or function itself | ||
| and the access level of any type constraints on its type parameters. | ||
| 泛型类型或泛型函数的访问级别是本身的访问级别与其类型参数上的任何类型约束的访问级别中最低的那个。 |
There was a problem hiding this comment.
建议更改为：
泛型类型或泛型函数的访问级别取决于泛型类型或泛型函数本身的访问级别，还需结合类型参数的类型约束的访问级别，根据这些访问级别中的最低访问级别来确定。
使用多个子句来代替复杂的长句
|
@bh3236 方便的话可以根据 Review comment 做修改 Thx |
根据 review 意见进行修改
|
@pujiaxin33 没问题可以 approve merge |
浏览了一遍，没有问题了。 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
AccessControl.md 翻译第一稿