鸿蒙语言基础类库：【@system.app (应用上下文)】

应用上下文

说明：

• 从API Version 7 开始，该接口不再维护，推荐使用新接口。
• 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import app from '@system.app';

app.getInfo

getInfo(): AppResponse

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

说明： 从API Version 7开始，推荐使用[@ohos.bundle]。

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

返回值：

示例：

export default {    
  getInfo(){        
    var info = app.getInfo();        
      console.log(JSON.stringify(info));    
  } 
}

app.terminate

terminate(): void

退出当前Ability。

说明： 从API Version 7开始，推荐使用[@ohos.ability.featureAbility]。

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

示例：

export default {    
  terminate(){        
    app.terminate();    
  }}

app.requestFullWindow

requestFullWindow(options?: RequestFullWindowOptions): void

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

此接口为系统接口，三方应用不支持调用。

说明： 从API Version 7开始，推荐使用[@ohos.window]。

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

参数：

示例：

export default {    
  requestFullWindow(){        
    app.requestFullWindow({            
      duration: 200});    
  }
}

app.setImageCacheCount7+

setImageCacheCount(value: number): void

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

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

参数：

示例：

// app.ets
import app from '@system.app';

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

app.setImageRawDataCacheSize7+

setImageRawDataCacheSize(value: number): void

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

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

参数：

示例：

// app.ets
import app from '@system.app';

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

app.setImageFileCacheSize7+

setImageFileCacheSize(value: number): void

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

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

参数：

示例：

// app.ets
import app from '@system.app';

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

AppResponse

定义AppResponse信息。

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

ScreenOnVisibleOptions

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

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

RequestFullWindowOptions

定义RequestFullWindow接口的选项。

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