Scripting: Modules #1452

shrinktofit · 2021-01-15T11:39:06Z

No description provided.

JoneLau · 2021-01-21T07:16:50Z

zh/scripting/language-support.md

- [全局对象 globalThis](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/globalThis)
+- [可选链操作符 `?.`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining)
+- [空值合并操作符 `??`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing_operator)
+- [逻辑空赋值操作符 `??=`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Logical_nullish_assignment)、[逻辑与赋值操作符 `&&=`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Logical_AND_assignment)、[逻辑或赋值操作符 `||=`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Logical_OR_assignment)


建议这里列一个标题

逻辑赋值操作符

逻辑空...

逻辑与...

逻辑或...

JoneLau · 2021-01-21T07:40:00Z

zh/scripting/modules/spec.md

+
+项目资源目录下，以 `.ts` 作为后缀的文件。例如 `assets/scripts/foo.ts`、`assets/scripts/bar.mjs`，都视为 ESM 格式。
+
+对于任何其它模块，Cocos Creator 选择与 Node.js 类似的规则来[鉴别格式](https://nodejs.org/api/packages.html#packages_determining_module_system)。具体地，以下文件将被视为 ESM 格式：


文字和链接之间需要有空格

选择与 Node.js 类似的规则来鉴别格式

JoneLau · 2021-01-21T07:50:17Z

zh/scripting/modules/spec.md

+
+### 后缀与目录导入
+
+Cocos Creator 对模块说明符中模块的后缀要求更偏向于 Web：必须指定后缀并且不支持 Node.js 式的目录导入。然而，基于历史原因和现行的一些限制，TypeScript 模块不允许给出后缀并支持 Node.js 式的目录导入。具体来说：


这里为啥用 “：”

JoneLau · 2021-01-21T07:54:51Z

zh/scripting/modules/spec.md

+
+在 ESM 模块中，通过标准的导入导出语句与目标模块进行交互，例如：
+
+```js


“```ts” 吧

JoneLau · 2021-01-21T07:56:17Z

zh/scripting/modules/spec.md

+//   [Module] { default: <module.exports> }
+```
+
+<!-- TODO：guess named exports -->


这里是漏了？通常内容间一个换行就够

这里专门注释的

xunyi0 · 2021-01-21T10:26:16Z

zh/scripting/external-scripts.md

@@ -1,6 +1,8 @@



开头不需要留一个空行

xunyi0 · 2021-01-21T10:27:00Z

zh/scripting/external-scripts.md

@@ -1,6 +1,8 @@

 # 外部代码支持

+⚠️ 注意，从 3.0 开始，推荐使用模块代替插件脚本的使用！


> **注意**：从 Cocos Creator 3.0 开始，推荐使用模块代替插件脚本！

xunyi0 · 2021-01-21T10:31:01Z

zh/scripting/external-scripts.md

@@ -1,6 +1,8 @@

 # 外部代码支持

+⚠️ 注意，从 3.0 开始，推荐使用模块代替插件脚本的使用！
+
 ## 插件脚本

 当脚本资源在导入时设置了 **导入为插件**，此脚本资源便称为 **插件脚本**。插件脚本通常用于引入第三方库。目前仅支持 JavaScript 插件脚本。


3.0 并没有 “导入为插件” 这个功能吧？

xunyi0 · 2021-01-21T10:35:47Z

zh/scripting/language-support.md

+Cocos Creator 支持 TypeScript 4.1.0。在此基础上，做了以下限制：
+
+- `tsconfig.json` 不会被读取。每个项目都隐含着如下选项：
+  ```json5


代码跟正文保留一个空行

xunyi0 · 2021-01-21T10:45:20Z

zh/scripting/language-support.md

+        "forceConsistentCasingInFileNames": true,
+    }，
+  }
+  ```

 - 隐含着 `isolatedModules` 选项，这意味着：


这里是对代码的补充吧？那不需要另起一行了，前面保留两个空格的缩进就好了：

其中的 isolatedModules 表示：

xunyi0 · 2021-01-21T12:59:41Z

zh/scripting/modules/spec.md

+
+CommonJS 模块的 [**ECMAScript 模块命名空间**](https://tc39.es/ecma262/#sec-module-namespace-objects) 表示，是含有一个 `default` 导出的命名空间，其中的 `default` 导出就指向 CommonJS 模块的 `module.exports` 的值。
+
+该 [**模块命名空间外来对象**](https://tc39.es/ecma262/#module-namespace-exotic-object) 可以通过 `import * as m from 'cjs'` 来观测：


Suggested change

该 [**模块命名空间外来对象**](https://tc39.es/ecma262/#module-namespace-exotic-object) 可以通过 `import * as m from 'cjs'` 来观测：

该 [模块命名空间外来对象](https://tc39.es/ecma262/#module-namespace-exotic-object) 可以通过 `import * as m from 'cjs'` 来观测（观察？）：

xunyi0 · 2021-01-21T13:00:32Z

zh/scripting/modules/spec.md

+
+<!-- TODO：guess named exports -->
+
+


一个空行就够了，留这么多空行显示的也只是一个空行

xunyi0 · 2021-01-21T13:01:28Z

zh/scripting/modules/spec.md

+
+### 解析算法规范
+
+`CREATOR_ESM_RESOLVE(specifier, parentURL)`


这部分都是英文的吗

xunyi0 · 2021-01-21T13:09:10Z

zh/scripting/modules/example-protobufjs.md

+> npm install -g nrm
+```
+
+> `-g` 代表全局：直接安装到当前计算机中。因此，只要执行一次后续就无需再次执行。


Suggested change

> `-g` 代表全局：直接安装到当前计算机中。因此，只要执行一次后续就无需再次执行。

> `-g` 表示全局，会将 NPM 包直接安装到当前计算机中，只要执行一次后续就不需要再次执行。

xunyi0 · 2021-01-21T13:12:34Z

zh/scripting/modules/example-protobufjs.md

+
+## 安装 NPM 包
+
+在项目根目录下，执行


Suggested change

在项目根目录下，执行

在项目根目录中执行以下命令：

xunyi0 · 2021-01-21T13:14:21Z

另外，这几篇文档都没有加到 SUMMARY.md 中

shrinktofit · 2021-01-23T05:37:41Z

另外，这几篇文档都没有加到 SUMMARY.md 中

index.md加了就行了吧

jareguo · 2021-01-27T06:01:04Z

zh/scripting/modules/example-mgobe.md

@@ -0,0 +1,36 @@
+# 示例：导入游戏联机对战引擎 MGOBE


不要用我们官方提供的 Service 做为示例。如果用这个做为示例的话，那大家自己接入就好了，就不会用 Cocos Service 了。

已移除这个示例

jareguo · 2021-01-27T06:01:36Z

zh/scripting/modules/example-mgobe.md

+
+```
+📂 assets
+📂 Libs


大小写不一致啊，为什么不统一小写开头

已移除这个示例

jareguo · 2021-01-27T06:05:34Z

zh/scripting/modules/example-protobufjs.md

+```ini
+# .gitignore 文件
+
+node_modules/ # 忽略 node_modules 目录


我们新建项目默认的 .gitignore 里面已经有忽略 node_modules 了

已移除这段

jareguo · 2021-01-27T06:06:29Z

zh/scripting/modules/example-protobufjs.md

@@ -0,0 +1,126 @@
+# 示例：通过 NPM 使用 protobuf.js


全文档所有 NPM 都应该用小写，类似 vivo 而不是 Vivo

shrinktofit marked this pull request as ready for review January 15, 2021 11:39

shrinktofit marked this pull request as draft January 15, 2021 11:39

shrinktofit force-pushed the NPM branch 6 times, most recently from 100648c to d0af519 Compare January 19, 2021 06:55

shrinktofit marked this pull request as ready for review January 19, 2021 06:56

shrinktofit force-pushed the NPM branch 8 times, most recently from d4c6e9c to 0aeba07 Compare January 20, 2021 10:10

JoneLau suggested changes Jan 21, 2021

View reviewed changes

JoneLau approved these changes Jan 21, 2021

View reviewed changes

xunyi0 reviewed Jan 21, 2021

View reviewed changes

jareguo reviewed Jan 27, 2021

View reviewed changes

shrinktofit force-pushed the NPM branch from 3549e79 to 3f68394 Compare January 27, 2021 06:56

xunyi0 changed the base branch from v3.0 to v3.0-release January 27, 2021 07:01

shrinktofit added 2 commits January 27, 2021 15:04

Scripting: Modules

309f6eb

Update

cc5ef75

shrinktofit added 5 commits January 27, 2021 15:04

Update

53c13a4

Update

aa8c479

Update

a9fc44e

Update

a3b811f

Update

1098d9e

shrinktofit force-pushed the NPM branch from e6a9e21 to 1098d9e Compare January 27, 2021 07:05

xunyi0 merged commit c2cc306 into cocos:v3.0-release Jan 27, 2021

shrinktofit deleted the NPM branch January 27, 2021 07:09

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Scripting: Modules #1452

Scripting: Modules #1452

shrinktofit commented Jan 15, 2021

JoneLau Jan 21, 2021

JoneLau Jan 21, 2021

JoneLau Jan 21, 2021

JoneLau Jan 21, 2021

JoneLau Jan 21, 2021

shrinktofit Jan 21, 2021

xunyi0 Jan 21, 2021 •

edited

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

shrinktofit Jan 22, 2021

xunyi0 Jan 21, 2021

xunyi0 Jan 21, 2021

xunyi0 commented Jan 21, 2021

shrinktofit commented Jan 23, 2021

jareguo Jan 27, 2021

shrinktofit Jan 27, 2021

jareguo Jan 27, 2021

shrinktofit Jan 27, 2021

jareguo Jan 27, 2021

shrinktofit Jan 27, 2021

jareguo Jan 27, 2021

shrinktofit Jan 27, 2021


		项目资源目录下，以 `.ts` 作为后缀的文件。例如 `assets/scripts/foo.ts`、`assets/scripts/bar.mjs`，都视为 ESM 格式。

		对于任何其它模块，Cocos Creator 选择与 Node.js 类似的规则来[鉴别格式](https://nodejs.org/api/packages.html#packages_determining_module_system)。具体地，以下文件将被视为 ESM 格式：


		### 后缀与目录导入

		Cocos Creator 对模块说明符中模块的后缀要求更偏向于 Web：必须指定后缀并且不支持 Node.js 式的目录导入。然而，基于历史原因和现行的一些限制，TypeScript 模块不允许给出后缀并支持 Node.js 式的目录导入。具体来说：


		在 ESM 模块中，通过标准的导入导出语句与目标模块进行交互，例如：

		```js

		@@ -1,6 +1,8 @@

		# 外部代码支持

		⚠️ 注意，从 3.0 开始，推荐使用模块代替插件脚本的使用！


		CommonJS 模块的 [ECMAScript 模块命名空间](https://tc39.es/ecma262/#sec-module-namespace-objects) 表示，是含有一个 `default` 导出的命名空间，其中的 `default` 导出就指向 CommonJS 模块的 `module.exports` 的值。

		该 [模块命名空间外来对象](https://tc39.es/ecma262/#module-namespace-exotic-object) 可以通过 `import * as m from 'cjs'` 来观测：

	该 [模块命名空间外来对象](https://tc39.es/ecma262/#module-namespace-exotic-object) 可以通过 `import * as m from 'cjs'` 来观测：
	该 [模块命名空间外来对象](https://tc39.es/ecma262/#module-namespace-exotic-object) 可以通过 `import * as m from 'cjs'` 来观测（观察？）：


		### 解析算法规范

		`CREATOR_ESM_RESOLVE(specifier, parentURL)`

	> `-g` 代表全局：直接安装到当前计算机中。因此，只要执行一次后续就无需再次执行。
	> `-g` 表示全局，会将 NPM 包直接安装到当前计算机中，只要执行一次后续就不需要再次执行。

	在项目根目录下，执行
	在项目根目录中执行以下命令：

		@@ -0,0 +1,36 @@
		# 示例：导入游戏联机对战引擎 MGOBE

Scripting: Modules #1452

Scripting: Modules #1452

Conversation

shrinktofit commented Jan 15, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

xunyi0 Jan 21, 2021 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

xunyi0 commented Jan 21, 2021

shrinktofit commented Jan 23, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

xunyi0 Jan 21, 2021 •

edited