• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 资源管理
2
3资源管理模块,根据当前configuration(语言,区域,横竖屏,mccmnc)和device capability(设备类型,分辨率)提供获取应用资源信息读取接口。
4
5> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
6> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
7
8
9## 导入模块
10
11```
12import resourceManager from '@ohos.resourceManager';
13```
14
15## resourceManager.getResourceManager
16
17getResourceManager(callback: AsyncCallback<ResourceManager>): void
18
19获取当前应用的资源管理对象,使用callback形式返回ResourceManager对象。
20
21此接口仅可在FA模型下使用。
22
23**系统能力**:SystemCapability.Global.ResourceManager
24
25**参数:**
26| 参数名      | 类型                                       | 必填   | 说明                            |
27| -------- | ---------------------------------------- | ---- | ----------------------------- |
28| callback | AsyncCallback<[ResourceManager](#resourcemanager)> | 是    | callback方式返回ResourceManager对象 |
29
30**示例:**
31  ```
32  resourceManager.getResourceManager((error, mgr) => {
33      if (error != null) {
34          console.log("error is " + error);
35          return;
36      }
37      mgr.getString(0x1000000, (error, value) => {
38          if (error != null) {
39              console.log("error is " + error);
40          } else {
41              let str = value;
42          }
43      });
44  });
45  ```
46
47
48## resourceManager.getResourceManager
49
50getResourceManager(bundleName: string, callback: AsyncCallback<ResourceManager>): void
51
52获取指定应用的资源管理对象,使用callback形式返回ResourceManager对象。
53
54此接口仅可在FA模型下使用。
55
56**系统能力**:SystemCapability.Global.ResourceManager
57
58**参数:**
59| 参数名        | 类型                                       | 必填   | 说明                            |
60| ---------- | ---------------------------------------- | ---- | ----------------------------- |
61| bundleName | string                                   | 是    | 指定应用的Bundle名称                 |
62| callback   | AsyncCallback<[ResourceManager](#resourcemanager)> | 是    | callback方式返回ResourceManager对象 |
63
64**示例:**
65  ```
66  resourceManager.getResourceManager("com.example.myapplication", (error, mgr) => {
67  });
68  ```
69
70
71## resourceManager.getResourceManager
72
73getResourceManager(): Promise<ResourceManager>
74
75获取当前应用的资源管理对象,使用Promise形式返回ResourceManager对象。
76
77此接口仅可在FA模型下使用。
78
79**系统能力**:SystemCapability.Global.ResourceManager
80
81**返回值:**
82| 类型                                       | 说明                |
83| ---------------------------------------- | ----------------- |
84| Promise<[ResourceManager](#resourcemanager)> | Promise方式返回资源管理对象 |
85
86**示例:**
87  ```
88  resourceManager.getResourceManager().then(mgr => {
89      mgr.getString(0x1000000, (error, value) => {
90          if (error != null) {
91              console.log("error is " + error);
92          } else {
93              let str = value;
94          }
95      });
96  }).catch(error => {
97      console.log("error is " + error);
98  });
99  ```
100
101
102## resourceManager.getResourceManager
103
104getResourceManager(bundleName: string): Promise<ResourceManager>
105
106获取指定应用的资源管理对象,使用Promise形式返回ResourceManager对象。
107
108此接口仅可在FA模型下使用。
109
110**系统能力**:SystemCapability.Global.ResourceManager
111
112**参数:**
113| 参数名        | 类型     | 必填   | 说明            |
114| ---------- | ------ | ---- | ------------- |
115| bundleName | string | 是    | 指定应用的Bundle名称 |
116
117**返回值:**
118| 类型                                       | 说明                 |
119| ---------------------------------------- | ------------------ |
120| Promise<[ResourceManager](#resourcemanager)> | Promise方式返回的资源管理对象 |
121
122**示例:**
123  ```
124  resourceManager.getResourceManager("com.example.myapplication").then(mgr => {
125
126  }).catch(error => {
127
128  });
129  ```
130
131
132## Direction
133
134用于表示设备屏幕方向。
135
136**系统能力**:以下各项对应的系统能力均为SystemCapability.Global.ResourceManager
137
138| 名称                   | 默认值  | 说明   |
139| -------------------- | ---- | ---- |
140| DIRECTION_VERTICAL   | 0    | 竖屏   |
141| DIRECTION_HORIZONTAL | 1    | 横屏   |
142
143
144## DeviceType
145
146用于表示当前设备类型。
147
148**系统能力**:以下各项对应的系统能力均为SystemCapability.Global.ResourceManager
149
150| 名称                   | 默认值  | 说明   |
151| -------------------- | ---- | ---- |
152| DEVICE_TYPE_PHONE    | 0x00 | 手机   |
153| DEVICE_TYPE_TABLET   | 0x01 | 平板   |
154| DEVICE_TYPE_CAR      | 0x02 | 汽车   |
155| DEVICE_TYPE_PC       | 0x03 | 电脑   |
156| DEVICE_TYPE_TV       | 0x04 | 电视   |
157| DEVICE_TYPE_WEARABLE | 0x06 | 穿戴   |
158
159
160## ScreenDensity
161
162用于表示当前设备屏幕密度。
163
164**系统能力**:以下各项对应的系统能力均为SystemCapability.Global.ResourceManager
165
166| 名称             | 默认值  | 说明         |
167| -------------- | ---- | ---------- |
168| SCREEN_SDPI    | 120  | 小规模的屏幕密度   |
169| SCREEN_MDPI    | 160  | 中规模的屏幕密度   |
170| SCREEN_LDPI    | 240  | 大规模的屏幕密度   |
171| SCREEN_XLDPI   | 320  | 特大规模的屏幕密度  |
172| SCREEN_XXLDPI  | 480  | 超大规模的屏幕密度  |
173| SCREEN_XXXLDPI | 640  | 超特大规模的屏幕密度 |
174
175
176## Configuration
177
178表示当前设备的状态。
179
180**系统能力**:以下各项对应的系统能力均为SystemCapability.Global.ResourceManager
181
182
183| 名称        | 参数类型                    | 可读   | 可写   | 说明       |
184| --------- | ----------------------- | ---- | ---- | -------- |
185| direction | [Direction](#direction) | 是    | 否    | 当前设备屏幕方向 |
186| locale    | string                  | 是    | 否    | 当前系统语言   |
187
188**示例:**
189
190  ```
191resourceManager.getResourceManager((error, mgr) => {
192      mgr.getConfiguration((error, value) => {
193          let direction = value.direction;
194          let locale = value.locale;
195      });
196  });
197  ```
198
199## DeviceCapability
200
201表示设备支持的能力。
202
203**系统能力**:以下各项对应的系统能力均为SystemCapability.Global.ResourceManager
204
205
206| 名称            | 参数类型                            | 可读   | 可写   | 说明       |
207| ------------- | ------------------------------- | ---- | ---- | -------- |
208| screenDensity | [ScreenDensity](#screendensity) | 是    | 否    | 当前设备屏幕密度 |
209| deviceType    | [DeviceType](#devicetype)       | 是    | 否    | 当前设备类型   |
210
211**示例:**
212
213  ```
214resourceManager.getResourceManager((error, mgr) => {
215      mgr.getDeviceCapability((error, value) => {
216          let screenDensity = value.screenDensity;
217          let deviceType = value.deviceType;
218      });
219  });
220  ```
221
222## RawFileDescriptor<sup>8+</sup>
223
224表示rawfile的descriptor信息。<br>
225**系统能力:** 以下各项对应的系统能力均为SystemCapability.Global.ResourceManager
226
227| 名称     | 类型     | 说明                 |
228| ------ | ------ | ------------------ |
229| fd     | number | rawfile的descriptor |
230| offset | number | rawfile的起始偏移量      |
231| length | number | rawfile的文件长度       |
232
233
234## ResourceManager
235
236提供访问应用资源的能力。
237
238> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
239> - ResourceManager涉及到的方法,仅限基于TS扩展的声明式开发范式使用。
240>
241> - 资源文件在工程的resources目录中定义,id可通过$r(资源地址).id的方式获取,例如$r('app.string.test').id。
242
243
244### getString
245
246getString(resId: number, callback: AsyncCallback&lt;string&gt;): void
247
248用户获取指定资源ID对应的字符串,使用callback形式返回字符串。
249
250**系统能力**:SystemCapability.Global.ResourceManager
251
252**参数:**
253| 参数名      | 类型                          | 必填   | 说明              |
254| -------- | --------------------------- | ---- | --------------- |
255| resId    | number                      | 是    | 资源ID值           |
256| callback | AsyncCallback&lt;string&gt; | 是    | 异步回调,用于返回获取的字符串 |
257
258**示例:**
259  ```
260  resourceManager.getResourceManager((error, mgr) => {
261      mgr.getString($r('app.string.test').id, (error, value) => {
262          if (error != null) {
263              console.log("error is " + error);
264          } else {
265              let str = value;
266          }
267      });
268  });
269  ```
270
271
272### getString
273
274getString(resId: number): Promise&lt;string&gt;
275
276用户获取指定资源ID对应的字符串,使用Promise形式返回字符串。
277
278**系统能力**:SystemCapability.Global.ResourceManager
279
280**参数:**
281| 参数名   | 类型     | 必填   | 说明    |
282| ----- | ------ | ---- | ----- |
283| resId | number | 是    | 资源ID值 |
284
285**返回值:**
286| 类型                    | 说明          |
287| --------------------- | ----------- |
288| Promise&lt;string&gt; | 资源ID值对应的字符串 |
289
290**示例:**
291  ```
292  resourceManager.getResourceManager((error, mgr) => {
293      mgr.getString($r('app.string.test').id).then(value => {
294          let str = value;
295      }).catch(error => {
296          console.log("getstring promise error is " + error);
297      });
298  });
299  ```
300
301
302### getStringArray
303
304getStringArray(resId: number, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;): void
305
306用户获取指定资源ID对应的字符串数组,使用callback形式返回字符串数组。
307
308**系统能力**:SystemCapability.Global.ResourceManager
309
310**参数:**
311| 参数名      | 类型                                       | 必填   | 说明                |
312| -------- | ---------------------------------------- | ---- | ----------------- |
313| resId    | number                                   | 是    | 资源ID值             |
314| callback | AsyncCallback&lt;Array&lt;string&gt;&gt; | 是    | 异步回调,用于返回获取的字符串数组 |
315
316**示例:**
317  ```
318  resourceManager.getResourceManager((error, mgr) => {
319      mgr.getStringArray($r('app.strarray.test').id, (error, value) => {
320          if (error != null) {
321              console.log("error is " + error);
322          } else {
323              let strArray = value;
324          }
325      });
326  });
327  ```
328
329
330### getStringArray
331
332getStringArray(resId: number): Promise&lt;Array&lt;string&gt;&gt;
333
334用户获取指定资源ID对应的字符串数组,使用Promise形式返回字符串数组。
335
336**系统能力**:SystemCapability.Global.ResourceManager
337
338**参数:**
339| 参数名   | 类型     | 必填   | 说明    |
340| ----- | ------ | ---- | ----- |
341| resId | number | 是    | 资源ID值 |
342
343**返回值:**
344| 类型                                 | 说明            |
345| ---------------------------------- | ------------- |
346| Promise&lt;Array&lt;string&gt;&gt; | 资源ID值对应的字符串数组 |
347
348**示例:**
349  ```
350  resourceManager.getResourceManager((error, mgr) => {
351       mgr.getStringArray($r('app.strarray.test').id).then(value => {
352          let strArray = value;
353      }).catch(error => {
354          console.log("getStringArray promise error is " + error);
355      });
356  });
357  ```
358
359
360### getMedia
361
362getMedia(resId: number, callback: AsyncCallback&lt;Uint8Array&gt;): void
363
364用户获取指定资源ID对应的媒体文件内容,使用callback形式返回字节数组。
365
366**系统能力**:SystemCapability.Global.ResourceManager
367
368**参数:**
369| 参数名      | 类型                              | 必填   | 说明                 |
370| -------- | ------------------------------- | ---- | ------------------ |
371| resId    | number                          | 是    | 资源ID值              |
372| callback | AsyncCallback&lt;Uint8Array&gt; | 是    | 异步回调,用于返回获取的媒体文件内容 |
373
374**示例:**
375  ```
376  resourceManager.getResourceManager((error, mgr) => {
377      mgr.getMedia($r('app.media.test').id, (error, value) => {
378          if (error != null) {
379              console.log("error is " + error);
380          } else {
381              let media = value;
382          }
383      });
384  });
385  ```
386
387
388### getMedia
389
390getMedia(resId: number): Promise&lt;Uint8Array&gt;
391
392用户获取指定资源ID对应的媒体文件内容,使用Promise形式返回字节数组。
393
394**系统能力**:SystemCapability.Global.ResourceManager
395
396**参数:**
397| 参数名   | 类型     | 必填   | 说明    |
398| ----- | ------ | ---- | ----- |
399| resId | number | 是    | 资源ID值 |
400
401**返回值:**
402| 类型                        | 说明             |
403| ------------------------- | -------------- |
404| Promise&lt;Uint8Array&gt; | 资源ID值对应的媒体文件内容 |
405
406**示例:**
407  ```
408  resourceManager.getResourceManager((error, mgr) => {
409      mgr.getMedia($r('app.media.test').id).then(value => {
410          let media = value;
411      }).catch(error => {
412          console.log("getMedia promise error is " + error);
413      });
414  });
415  ```
416
417
418### getMediaBase64
419
420getMediaBase64(resId: number, callback: AsyncCallback&lt;string&gt;): void
421
422用户获取指定资源ID对应的图片资源Base64编码,使用callback形式返回字符串。
423
424**系统能力**:SystemCapability.Global.ResourceManager
425
426**参数:**
427| 参数名      | 类型                          | 必填   | 说明                       |
428| -------- | --------------------------- | ---- | ------------------------ |
429| resId    | number                      | 是    | 资源ID值                    |
430| callback | AsyncCallback&lt;string&gt; | 是    | 异步回调,用于返回获取的图片资源Base64编码 |
431
432**示例:**
433  ```
434  resourceManager.getResourceManager((error, mgr) => {
435      mgr.getMediaBase64($r('app.media.test').id, (error, value) => {
436          if (error != null) {
437              console.log("error is " + error);
438          } else {
439              let media = value;
440          }
441      });
442  });
443  ```
444
445
446### getMediaBase64
447
448getMediaBase64(resId: number): Promise&lt;string&gt;
449
450用户获取指定资源ID对应的图片资源Base64编码,使用Promise形式返回字符串。
451
452**系统能力**:SystemCapability.Global.ResourceManager
453
454**参数:**
455| 参数名   | 类型     | 必填   | 说明    |
456| ----- | ------ | ---- | ----- |
457| resId | number | 是    | 资源ID值 |
458
459**返回值:**
460| 类型                    | 说明                   |
461| --------------------- | -------------------- |
462| Promise&lt;string&gt; | 资源ID值对应的图片资源Base64编码 |
463
464**示例:**
465  ```
466  resourceManager.getResourceManager((error, mgr) => {
467      mgr.getMediaBase64($r('app.media.test').id).then(value => {
468          let media = value;
469      }).catch(error => {
470          console.log("getMediaBase64 promise error is " + error);
471      });
472  });
473  ```
474
475
476### getConfiguration
477
478getConfiguration(callback: AsyncCallback&lt;Configuration&gt;): void
479
480用户获取设备的Configuration,使用callback形式返回Configuration对象。
481
482**系统能力**:SystemCapability.Global.ResourceManager
483
484**参数:**
485| 参数名      | 类型                                       | 必填   | 说明                        |
486| -------- | ---------------------------------------- | ---- | ------------------------- |
487| callback | AsyncCallback&lt;[Configuration](#configuration)&gt; | 是    | 异步回调,用于返回设备的Configuration |
488
489**示例:**
490  ```
491  resourceManager.getResourceManager((error, mgr) => {
492      mgr.getConfiguration((error, value) => {
493          if (error != null) {
494              console.log("error is " + error);
495          } else {
496              let direction = value.direction;
497              let locale = value.locale;
498          }
499      });
500  });
501  ```
502
503
504### getConfiguration
505
506getConfiguration(): Promise&lt;Configuration&gt;
507
508用户获取设备的Configuration,使用Promise形式返回Configuration对象。
509
510**系统能力**:SystemCapability.Global.ResourceManager
511
512**返回值:**
513| 类型                                       | 说明               |
514| ---------------------------------------- | ---------------- |
515| Promise&lt;[Configuration](#configuration)&gt; | 设备的Configuration |
516
517**示例:**
518  ```
519  resourceManager.getResourceManager((error, mgr) => {
520      mgr.getConfiguration().then(value => {
521          let direction = value.direction;
522          let locale = value.locale;
523      }).catch(error => {
524          console.log("getConfiguration promise error is " + error);
525      });
526  });
527  ```
528
529
530### getDeviceCapability
531
532getDeviceCapability(callback: AsyncCallback&lt;DeviceCapability&gt;): void
533
534用户获取设备的DeviceCapability,使用callback形式返回DeviceCapability对象。
535
536**系统能力**:SystemCapability.Global.ResourceManager
537
538**参数:**
539| 参数名      | 类型                                       | 必填   | 说明                           |
540| -------- | ---------------------------------------- | ---- | ---------------------------- |
541| callback | AsyncCallback&lt;[DeviceCapability](#devicecapability)&gt; | 是    | 异步回调,用于返回设备的DeviceCapability |
542
543**示例:**
544  ```
545  resourceManager.getResourceManager((error, mgr) => {
546      mgr.getDeviceCapability((error, value) => {
547          if (error != null) {
548              console.log("error is " + error);
549          } else {
550              let screenDensity = value.screenDensity;
551              let deviceType = value.deviceType;
552          }
553      });
554  });
555  ```
556
557
558### getDeviceCapability
559
560getDeviceCapability(): Promise&lt;DeviceCapability&gt;
561
562用户获取设备的DeviceCapability,使用Promise形式返回DeviceCapability对象。
563
564**系统能力**:SystemCapability.Global.ResourceManager
565
566**返回值:**
567| 类型                                       | 说明                  |
568| ---------------------------------------- | ------------------- |
569| Promise&lt;[DeviceCapability](#devicecapability)&gt; | 设备的DeviceCapability |
570
571**示例:**
572  ```
573  resourceManager.getResourceManager((error, mgr) => {
574      mgr.getDeviceCapability().then(value => {
575          let screenDensity = value.screenDensity;
576          let deviceType = value.deviceType;
577      }).catch(error => {
578          console.log("getDeviceCapability promise error is " + error);
579      });
580  });
581  ```
582
583
584### getPluralString
585
586getPluralString(resId: number, num: number, callback: AsyncCallback&lt;string&gt;): void
587
588根据指定数量获取指定ID字符串表示的单复数字符串,使用callback形式返回字符串。
589
590**系统能力**:SystemCapability.Global.ResourceManager
591
592**参数:**
593| 参数名      | 类型                          | 必填   | 说明                              |
594| -------- | --------------------------- | ---- | ------------------------------- |
595| resId    | number                      | 是    | 资源ID值                           |
596| num      | number                      | 是    | 数量值                             |
597| callback | AsyncCallback&lt;string&gt; | 是    | 异步回调,返回根据指定数量获取指定ID字符串表示的单复数字符串 |
598
599**示例:**
600  ```
601  resourceManager.getResourceManager((error, mgr) => {
602      mgr.getPluralString($r("app.plural.test").id, 1, (error, value) => {
603          if (error != null) {
604              console.log("error is " + error);
605          } else {
606              let str = value;
607          }
608      });
609  });
610  ```
611
612
613### getPluralString
614
615getPluralString(resId: number, num: number): Promise&lt;string&gt;
616
617根据指定数量获取对指定ID字符串表示的单复数字符串,使用Promise形式返回字符串。
618
619**系统能力**:SystemCapability.Global.ResourceManager
620
621**参数:**
622| 参数名   | 类型     | 必填   | 说明    |
623| ----- | ------ | ---- | ----- |
624| resId | number | 是    | 资源ID值 |
625| num   | number | 是    | 数量值   |
626
627**返回值:**
628| 类型                    | 说明                        |
629| --------------------- | ------------------------- |
630| Promise&lt;string&gt; | 根据提供的数量获取对应ID字符串表示的单复数字符串 |
631
632**示例:**
633  ```
634  resourceManager.getResourceManager((error, mgr) => {
635      mgr.getPluralString($r("app.plural.test").id, 1).then(value => {
636          let str = value;
637      }).catch(error => {
638          console.log("getPluralString promise error is " + error);
639      });
640  });
641  ```
642
643### getRawFile<sup>8+</sup>
644
645getRawFile(path: string, callback: AsyncCallback&lt;Uint8Array&gt;): void
646
647用户获取resources/rawfile目录下对应的rawfile文件内容,使用callback形式返回字节数组。
648
649**系统能力**:SystemCapability.Global.ResourceManager
650
651**参数:**
652| 参数名      | 类型                              | 必填   | 说明                      |
653| -------- | ------------------------------- | ---- | ----------------------- |
654| path     | string                          | 是    | rawfile文件路径             |
655| callback | AsyncCallback&lt;Uint8Array&gt; | 是    | 异步回调,用于返回获取的rawfile文件内容 |
656
657**示例:**
658  ```
659  resourceManager.getResourceManager((error, mgr) => {
660      mgr.getRawFile("test.xml", (error, value) => {
661          if (error != null) {
662              console.log("error is " + error);
663          } else {
664              let rawFile = value;
665          }
666      });
667  });
668  ```
669
670### getRawFile<sup>8+</sup>
671
672getRawFile(path: string): Promise&lt;Uint8Array&gt;
673
674用户获取resources/rawfile目录下对应的rawfile文件内容,使用Promise形式返回字节数组。
675
676**系统能力**:SystemCapability.Global.ResourceManager
677
678**参数:**
679| 参数名  | 类型     | 必填   | 说明          |
680| ---- | ------ | ---- | ----------- |
681| path | string | 是    | rawfile文件路径 |
682
683**返回值:**
684| 类型                        | 说明          |
685| ------------------------- | ----------- |
686| Promise&lt;Uint8Array&gt; | rawfile文件内容 |
687
688**示例:**
689  ```
690  resourceManager.getResourceManager((error, mgr) => {
691      mgr.getRawFile("test.xml").then(value => {
692          let rawFile = value;
693      }).catch(error => {
694          console.log("getRawFile promise error is " + error);
695      });
696  });
697  ```
698
699### getRawFileDescriptor<sup>8+</sup>
700
701getRawFileDescriptor(path: string, callback: AsyncCallback&lt;RawFileDescriptor&gt;): void
702
703用户获取resources/rawfile目录下对应rawfile文件的descriptor,使用callback形式返回。
704
705**系统能力**:SystemCapability.Global.ResourceManager
706
707**参数:**
708| 参数名      | 类型                                       | 必填   | 说明                               |
709| -------- | ---------------------------------------- | ---- | -------------------------------- |
710| path     | string                                   | 是    | rawfile文件路径                      |
711| callback | AsyncCallback&lt;[RawFileDescriptor](#rawfiledescriptor8)&gt; | 是    | 异步回调,用于返回获取的rawfile文件的descriptor |
712
713**示例:**
714  ```
715  resourceManager.getResourceManager((error, mgr) => {
716      mgr.getRawFileDescriptor("test.xml", (error, value) => {
717          if (error != null) {
718              console.log("error is " + error);
719          } else {
720              let fd = value.fd;
721              let offset = value.offset;
722              let length = value.length;
723          }
724      });
725  });
726  ```
727
728### getRawFileDescriptor<sup>8+</sup>
729
730getRawFileDescriptor(path: string): Promise&lt;RawFileDescriptor&gt;
731
732用户获取resources/rawfile目录下对应rawfile文件的descriptor,使用Promise形式返回。
733
734**系统能力**:SystemCapability.Global.ResourceManager
735
736**参数:**
737| 参数名  | 类型     | 必填   | 说明          |
738| ---- | ------ | ---- | ----------- |
739| path | string | 是    | rawfile文件路径 |
740
741**返回值:**
742| 类型                                       | 说明                  |
743| ---------------------------------------- | ------------------- |
744| Promise&lt;[RawFileDescriptor](#rawfiledescriptor8)&gt; | rawfile文件descriptor |
745
746**示例:**
747  ```
748  resourceManager.getResourceManager((error, mgr) => {
749      mgr.getRawFileDescriptor("test.xml").then(value => {
750          let fd = value.fd;
751          let offset = value.offset;
752          let length = value.length;
753      }).catch(error => {
754          console.log("getRawFileDescriptor promise error is " + error);
755      });
756  });
757  ```
758
759### closeRawFileDescriptor<sup>8+</sup>
760
761closeRawFileDescriptor(path: string, callback: AsyncCallback&lt;void&gt;): void
762
763用户关闭resources/rawfile目录下rawfile文件的descriptor,使用callback形式返回。
764
765**系统能力**:SystemCapability.Global.ResourceManager
766
767**参数:**
768| 参数名      | 类型                        | 必填   | 说明          |
769| -------- | ------------------------- | ---- | ----------- |
770| path     | string                    | 是    | rawfile文件路径 |
771| callback | AsyncCallback&lt;void&gt; | 是    | 异步回调        |
772
773**示例:**
774  ```
775  resourceManager.getResourceManager((error, mgr) => {
776      mgr.closeRawFileDescriptor("test.xml", (error, value) => {
777          if (error != null) {
778              console.log("error is " + error);
779          }
780      });
781  });
782  ```
783
784### closeRawFileDescriptor<sup>8+</sup>
785
786closeRawFileDescriptor(path: string): Promise&lt;void&gt;
787
788用户关闭resources/rawfile目录下rawfile文件的descriptor,使用Promise形式返回。
789
790**系统能力**:SystemCapability.Global.ResourceManager
791
792**参数:**
793| 参数名  | 类型     | 必填   | 说明          |
794| ---- | ------ | ---- | ----------- |
795| path | string | 是    | rawfile文件路径 |
796
797**返回值:**
798| 类型                  | 说明   |
799| ------------------- | ---- |
800| Promise&lt;void&gt; | 无返回值 |
801
802**示例:**
803  ```
804  resourceManager.getResourceManager((error, mgr) => {
805      mgr.closeRawFileDescriptor("test.xml").then(value => {
806          let result = value;
807      }).catch(error => {
808          console.log("closeRawFileDescriptor promise error is " + error);
809      });
810  });
811  ```
812
813### release<sup>7+</sup>
814
815release()
816
817用户释放创建的resourceManager。
818
819**系统能力**:SystemCapability.Global.ResourceManager
820
821**示例:**
822  ```
823  resourceManager.getResourceManager((error, mgr) => {
824      mgr.release();
825  });
826  ```
827