@system.app (应用上下文)

说明：

本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import app, { AppResponse } from '@system.app'

App

getInfo

static getInfo(): AppResponse

获取当前应用配置文件中声明的信息。

从API Version9开始，推荐使用bundleManager.getApplicationInfo。

系统能力： SystemCapability.ArkUI.ArkUI.Lite

返回值：

示例：

import app, { AppResponse } from '@system.app'
export default class Info {
  getInfo() {
    let info:AppResponse = app.getInfo()
    console.log(JSON.stringify(info))
  }
}

terminate

static terminate(): void

退出当前Ability。

从API Version 7开始，推荐使用@ohos.ability.featureAbility。

系统能力： SystemCapability.ArkUI.ArkUI.Lite

示例：

import app, { AppResponse } from '@system.app'
export default class TerM {
  terminate() {
    app.terminate()
  }
}

setImageCacheCount⁷⁺

static setImageCacheCount(value: number): void

设置内存中缓存解码后图片的数量上限，提升再次加载同源图片的加载速度。如果不设置则默认为0，不进行缓存。缓存采用内置的LRU策略，新图片加载后，如果超过缓存上限，会删除最久未再次加载的缓存。建议根据应用内存需求，设置合理缓存数量，数字过大可能导致内存使用过高。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

// app.ets
import app, { AppResponse } from '@system.app'

export default class OnC {
  onCreate() {
    app.setImageCacheCount(100) // 设置解码后图片内存缓存上限为100张
    console.info('Application onCreate')
  },
  onDestroy() {
    console.info('Application onDestroy')
  },
}

setImageRawDataCacheSize⁷⁺

static setImageRawDataCacheSize(value: number): void

设置内存中缓存解码前图片数据的大小上限，单位为字节，提升再次加载同源图片的加载速度。如果不设置则默认为0，不进行缓存。缓存采用内置的LRU策略，新图片加载后，如果解码前数据超过缓存上限，会删除最久未再次加载的图片数据缓存。建议根据应用内存需求，设置合理缓存上限，过大可能导致应用内存使用过高。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

// app.ets
import app, { AppResponse } from '@system.app'

export default class OnC {
  onCreate() {
    app.setImageRawDataCacheSize(104857600)
    // 设置解码前图片数据内存缓存上限为100MB (100MB=100*1024*1024B=104857600B)
    console.info('Application onCreate')
  },
  onDestroy() {
    console.info('Application onDestroy')
  },
}

setImageFileCacheSize⁷⁺

static setImageFileCacheSize(value: number): void

设置图片文件缓存的大小上限，单位为字节，提升再次加载同源图片的加载速度，特别是对网络图源、缩略图会有较明显提升。如果不设置则默认为100MB。缓存采用内置的LRU策略，新图片加载后，如果超过文件缓存上限，会按照时间由远到近删除缓存图片文件直到缓存图片大小满足缓存上限。建议根据应用实际需求，设置合理文件缓存上限，数字过大可能导致磁盘空间占用过高。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

// app.ets
import app, { AppResponse } from '@system.app'

export default class OnC {
  onCreate() {
    app.setImageFileCacheSize(209715200)
    // 设置图片文件数据缓存上限为200MB (200MB=200*1024*1024B=209715200B) 
    console.info('Application onCreate')
  },
  onDestroy() {
    console.info('Application onDestroy')
  },
}

ScreenOnVisible^(deprecated)

static screenOnVisible(options?: ScreenOnVisibleOptions): void

定义屏幕唤醒时是否保持应用可见。

该接口从API Version 8 开始废弃。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

requestFullWindow^(deprecated)

static requestFullWindow(options?: RequestFullWindowOptions): void

请求应用以全窗口运行，FA在某些场景下（如半模态FA）会以非全窗口运行，调用该接口会从非全窗口切换为全窗口运行，如果已经以全窗口运行则该接口调用无效。

从API Version 7开始，推荐使用@ohos.window。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

import app, { AppResponse } from '@system.app'
export default class Req {
  requestFullWindow() {
    app.requestFullWindow({
      duration: 200
    })
  }
} 

AppResponse

定义AppResponse信息。

系统能力： 以下各项对应的系统能力有所不同，详见下表。

ScreenOnVisibleOptions

定义屏幕上可见接口的选项。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

RequestFullWindowOptions

定义RequestFullWindow接口的选项。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)