资源管理

说明： 从 API Version 6 开始支持。

导入模块

import resourceManager from '@ohos.resourceManager';

权限

无

resourceManager.getResourceManager

getResourceManager(callback: AsyncCallback<ResourceManager>): void

获取当前应用的资源管理对象，使用callback形式返回ResourceManager对象。

• 参数：

  参数名	类型	必填	说明
  callback	AsyncCallback<ResourceManager>	是	callback方式返回ResourceManager对象

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      if (error != null) {
          console.log("error occurs" + error);
          return; 
      }
      mgr.getString(0x1000000, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  
  

resourceManager.getResourceManager

getResourceManager(bundleName: string, callback: AsyncCallback<ResourceManager>): void

获取指定应用的资源管理对象，使用callback形式返回ResourceManager对象。

• 参数：

  参数名	类型	必填	说明
  bundleName	string	是	指定应用的Bundle名称
  callback	AsyncCallback<ResourceManager>	是	callback方式返回ResourceManager对象

• 示例：

  resourceManager.getResourceManager("com.example.myapplication", (error, mgr) => {
  }
  

resourceManager.getResourceManager

getResourceManager(): Promise<ResourceManager>

获取当前应用的资源管理对象，使用Promise形式返回ResourceManager对象。

• 返回值：

  类型	说明
  Promise<ResourceManager>	Promise方式返回资源管理对象

• 示例：

  resourceManager.getResourceManager().then(mgr => {
      mgr.getString(0x1000000, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }).catch(error => {
      console.log(error);
  });
  

resourceManager.getResourceManager

getResourceManager(bundleName: string): Promise<ResourceManager>

获取指定应用的资源管理对象，使用Promise形式返回ResourceManager对象。

• 参数：

  参数名	类型	必填	说明
  bundleName	string	是	指定应用的Bundle名称

• 返回值：

  类型	说明
  Promise<ResourceManager>	Promise方式返回的资源管理对象

• 示例：

  resourceManager.getResourceManager("com.example.myapplication").then(mgr => {
  
  }).catch(error => {
  
  });
  

Direction

用于表示设备屏幕方向。

DeviceType

用于表示当前设备类型。

ScreenDensity

用于表示当前设备屏幕密度。

Configuration

表示当前设备的状态。

属性

DeviceCapability

表示设备支持的能力。

属性

ResourceManager

提供访问应用资源的能力。

getString

getString(resId: number, callback: AsyncCallback<string>): void

用户获取指定资源ID对应的字符串，使用callback形式返回字符串。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值
  callback	AsyncCallback<string>	是	异步回调，用于返回获取的字符串

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getString(0x1000000, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getString

getString(resId: number): Promise<string>

用户获取指定资源ID对应的字符串，使用Promise形式返回字符串。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值

• 返回值：

  类型	说明
  Promise<string>	资源ID值对应的字符串

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getString(0x1000000).then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }
  

getStringArray

getStringArray(resId: number, callback: AsyncCallback<Array<string>>): void

用户获取指定资源ID对应的字符串数组，使用callback形式返回字符串数组。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值
  callback	AsyncCallback<Array<string>>	是	异步回调，用于返回获取的字符串数组

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getStringArray(0x1000000, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getStringArray

getStringArray(resId: number): Promise<Array<string>>

用户获取指定资源ID对应的字符串数组，使用Promise形式返回字符串数组。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值

• 返回值：

  类型	说明
  Promise<Array<string>>	资源ID值对应的字符串数组

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
       mgr.getStringArray(0x1000000).then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }
  

getMedia

getMedia(resId: number, callback: AsyncCallback<Uint8Array>): void

用户获取指定资源ID对应的媒体文件内容，使用callback形式返回字节数组。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值
  callback	AsyncCallback<Array<Uint8Array>>	是	异步回调，用于返回获取的媒体文件内容

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getMedia(0x1000000, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getMedia

getMedia(resId: number): Promise<Uint8Array>

用户获取指定资源ID对应的媒体文件内容，使用Promise形式返回字节数组。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值

• 返回值：

  类型	说明
  Promise<Array<Uint8Array>>	资源ID值对应的媒体文件内容

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getMedia(0x1000000).then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }
  

getMediaBase64

getMediaBase64(resId: number, callback: AsyncCallback<string>): void

用户获取指定资源ID对应的图片资源Base64编码，使用callback形式返回字符串。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值
  callback	AsyncCallback<string>	是	异步回调，用于返回获取的图片资源Base64编码

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getMediaBase64(0x1000000, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getMediaBase64

getMediaBase64(resId: number): Promise<string>

用户获取指定资源ID对应的图片资源Base64编码，使用Promise形式返回字符串。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值

• 返回值：

  类型	说明
  Promise<string>	资源ID值对应的图片资源Base64编码

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getMediaBase64(0x1000000).then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }
  

getConfiguration

getConfiguration(callback: AsyncCallback<Configuration>): void

用户获取设备的Configuration，使用callback形式返回Configuration对象。

• 参数：

  参数名	类型	必填	说明
  callback	AsyncCallback<Configuration>	是	异步回调，用于返回设备的Configuration

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getConfiguration((error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getConfiguration

getConfiguration(): Promise<Configuration>

用户获取设备的Configuration，使用Promise形式返回Configuration对象。

• 返回值：

  类型	说明
  Promise<Configuration>	设备的Configuration

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getConfiguration().then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }
  

getDeviceCapability

getDeviceCapability(callback: AsyncCallback<DeviceCapability>): void

用户获取设备的DeviceCapability，使用callback形式返回DeviceCapability对象。

• 参数：

  参数名	类型	必填	说明
  callback	AsyncCallback<DeviceCapability>	是	异步回调，用于返回设备的DeviceCapability

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getDeviceCapability((error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getDeviceCapability

getDeviceCapability(): Promise<DeviceCapability>

用户获取设备的DeviceCapability，使用Promise形式返回DeviceCapability对象。

• 返回值：

  类型	说明
  Promise<DeviceCapability>	设备的DeviceCapability

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getDeviceCapability().then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }
  

getPluralString

getPluralString(resId: number, num: number, callback: AsyncCallback<string>): void

根据指定数量获取指定ID字符串表示的单复数字符串，使用callback形式返回字符串。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值
  num	number	是	数量值
  callback	AsyncCallback<string>	是	异步回调，返回根据指定数量获取指定ID字符串表示的单复数字符串

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getPluralString(0x1000000, 1, (error, value) => {
          if (error != null) {
              console.log(value);
          } else {
              console.log(value);
          }
      });
  }
  

getPluralString

getPluralString(resId: number, num: number): Promise<string>

根据指定数量获取对指定ID字符串表示的单复数字符串，使用Promise形式返回字符串。

• 参数：

  参数名	类型	必填	说明
  resId	number	是	资源ID值
  num	number	是	数量值

• 返回值：

  类型	说明
  Promise<string>	根据提供的数量获取对应ID字符串表示的单复数字符串

• 示例：

  resourceManager.getResourceManager((error, mgr) => {
      mgr.getPluralString(0x1000000, 1).then(value => {
          console.log(value);
      }).catch(error => {
          console.log("getstring promise " + error);
      });
  }