1# ArkWeb进程
2
3ArkWeb是多进程模型，分为应用进程、Web渲染进程、Web GPU进程、Web孵化进程和Foundation进程。
4
5> **说明：**
6>
7> Web内核没有明确的内存大小申请约束，理论上可以无限大，直到被资源管理释放。
8
9**图1** ArkWeb进程模型图
10
11![web-component-process](figures/arkweb_component_process.png)
12
13- 应用进程中Web相关线程（应用唯一）
14
15  - 应用进程为主进程。包含网络线程、Video线程、Audio线程和IO线程等。
16
17  - 负责Web组件的北向接口与回调处理，网络请求、媒体服务等需要与其他系统服务交互的功能。
18
19- Foundation进程（系统唯一）
20
21  负责接收应用进程进行孵化进程的请求，管理应用进程和Web渲染进程的绑定关系。
22
23- Web孵化进程（系统唯一）
24
25  - 负责接收Foundation进程的请求，执行孵化Web渲染进行与Web GPU进程。
26
27  - 执行孵化后处理安全沙箱降权、预加载动态库，以提升性能。
28
29- Web渲染进程（应用可指定多Web实例间共享或独立进程）
30
31  - 负责运行Web渲染进程引擎（HTML解析、排版、绘制、渲染）。
32
33  - 负责运行ArkWeb执行引擎（JavaScript、Web Assembly）。
34
35  - 提供接口供应用选择多Web实例间是否共享渲染进程，满足不同场景对安全性、稳定性、内存占用的诉求。
36
37  - 默认策略：移动设备上共享渲染进程以节省内存，2in1设备上独立渲染进程提升安全与稳定性。
38
39- Web GPU进程（应用唯一）
40
41  负责光栅化、合成送显等与GPU、RenderService交互功能。提升应用进程稳定性、安全性。
42
431. 可通过[setRenderProcessMode](../reference/apis-arkweb/js-apis-webview.md#setrenderprocessmode12)设置渲染子进程的模式，从而控制渲染过程的单进程或多进程状态。
44
45   移动设备默认为单进程渲染，而2in1设备则默认采用多进程渲染。通过调用[getRenderProcessMode](../reference/apis-arkweb/js-apis-webview.md#getrenderprocessmode12)可查询当前的渲染子进程模式，其中枚举值0表示单进程模式，枚举值1对应多进程模式。若获取的值超出[RenderProcessMode](../reference/apis-arkweb/js-apis-webview.md#renderprocessmode12)枚举范围，系统将自动采用多进程渲染模式作为默认设置。
46
47   ```ts
48   // xxx.ets
49   import { webview } from '@kit.ArkWeb';
50   import { BusinessError } from '@kit.BasicServicesKit';
51
52   @Entry
53   @Component
54   struct WebComponent {
55     controller: webview.WebviewController = new webview.WebviewController();
56
57     build() {
58       Column() {
59         Button('getRenderProcessMode')
60           .onClick(() => {
61             let mode = webview.WebviewController.getRenderProcessMode();
62             console.log("getRenderProcessMode: " + mode);
63           })
64         Button('setRenderProcessMode')
65           .onClick(() => {
66             try {
67               webview.WebviewController.setRenderProcessMode(webview.RenderProcessMode.MULTIPLE);
68             } catch (error) {
69               console.error(`ErrorCode: ${(error as BusinessError).code},  Message: ${(error as     BusinessError).message}`);
70             }
71           })
72         Web({ src: 'www.example.com', controller: this.controller })
73       }
74     }
75   }
76   ```
77
782. 可通过[terminateRenderProcess](../reference/apis-arkweb/js-apis-webview.md#terminaterenderprocess12)来主动关闭渲染进程。若渲染进程尚未启动或已销毁，此操作将不会产生任何影响。此外，销毁渲染进程将同时影响所有与之关联的其他实例。
79
80   ```ts
81   // xxx.ets
82   import { webview } from '@kit.ArkWeb';
83   import { BusinessError } from '@kit.BasicServicesKit';
84
85   @Entry
86   @Component
87   struct WebComponent {
88     controller: webview.WebviewController = new webview.WebviewController();
89
90     build() {
91       Column() {
92         Button('terminateRenderProcess')
93         .onClick(() => {
94           let result = this.controller.terminateRenderProcess();
95           console.log("terminateRenderProcess result: " + result);
96         })
97         Web({ src: 'www.example.com', controller: this.controller })
98       }
99     }
100   }
101   ```
102
1033. 可通过[onRenderExited](../reference/apis-arkweb/ts-basic-components-web.md#onrenderexited9)来监听渲染进程的退出事件，从而获知退出的具体原因（如内存OOM、crash或正常退出等）。由于多个Web组件可能共用同一个渲染进程，因此，每当渲染进程退出时，每个受此影响的Web组件均会触发相应的回调。
104
105   ```ts
106   // xxx.ets
107   import { webview } from '@kit.ArkWeb';
108
109   @Entry
110   @Component
111   struct WebComponent {
112     controller: webview.WebviewController = new webview.WebviewController();
113
114     build() {
115       Column() {
116         Web({ src: 'chrome://crash/', controller: this.controller })
117           .onRenderExited((event) => {
118             if (event) {
119               console.log('reason:' + event.renderExitReason);
120             }
121           })
122       }
123     }
124   }
125   ```
126
1274. 可通过[onRenderProcessNotResponding](../reference/apis-arkweb/ts-basic-components-web.md#onrenderprocessnotresponding12)、[onRenderProcessResponding](../reference/apis-arkweb/ts-basic-components-web.md#onrenderprocessresponding12)来监听渲染进程的无响应状态。
128
129   当Web组件无法处理输入事件，或未能在预期时间内导航至新URL时，系统会判定网页进程为无响应状态，并触发onRenderProcessNotResponding回调。在网页进程持续无响应期间，该回调可能反复触发，直至进程恢复至正常运行状态，此时将触发onRenderProcessResponding回调。
130
131   ```ts
132   // xxx.ets
133   import { webview } from '@kit.ArkWeb';
134
135   @Entry
136   @Component
137   struct WebComponent {
138     controller: webview.WebviewController = new webview.WebviewController();
139
140     build() {
141       Column() {
142         Web({ src: 'www.example.com', controller: this.controller })
143           .onRenderProcessNotResponding((data) => {
144             console.log("onRenderProcessNotResponding: [jsStack]= " + data.jsStack +
145               ", [process]=" + data.pid + ", [reason]=" + data.reason);
146           })
147       }
148     }
149   }
150   ```
151
152   ```ts
153   // xxx.ets
154   import { webview } from '@kit.ArkWeb';
155
156   @Entry
157   @Component
158   struct WebComponent {
159     controller: webview.WebviewController = new webview.WebviewController();
160
161     build() {
162       Column() {
163         Web({ src: 'www.example.com', controller: this.controller })
164           .onRenderProcessResponding(() => {
165             console.log("onRenderProcessResponding again");
166           })
167       }
168     }
169   }
170   ```
171
1725. [Web组件](../reference/apis-arkweb/ts-basic-components-web.md#web)创建参数涵盖了多进程模型的运用。其中，sharedRenderProcessToken标识了当前Web组件所指定的共享渲染进程的token。在多渲染进程模式下，拥有相同token的Web组件将优先尝试重用与该token绑定的渲染进程。token与渲染进程的绑定关系，在渲染进程的初始化阶段形成。一旦渲染进程不再关联任何Web组件，它与token的绑定关系将被解除。
173
174   ```ts
175   // xxx.ets
176   import { webview } from '@kit.ArkWeb';
177
178   @Entry
179   @Component
180   struct WebComponent {
181     controller: webview.WebviewController = new webview.WebviewController();
182
183     build() {
184       Column() {
185         Web({ src: 'www.example.com', controller: this.controller, sharedRenderProcessToken: "111" })
186         Web({ src: 'www.w3.org', controller: this.controller, sharedRenderProcessToken: "111" })
187       }
188     }
189   }
190   ```