應(yīng)用上下文

說明：

• 從API Version 7 開始，該接口不再維護(hù)，推薦使用新接口。
• 本模塊首批接口從API version 3開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨標(biāo)記接口的起始版本。

導(dǎo)入模塊

import app from '@system.app';

app.getInfo

getInfo(): AppResponse

獲取當(dāng)前應(yīng)用配置文件中聲明的信息。

說明： 從API Version 7開始，推薦使用[@ohos.bundle]。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Lite

返回值：

示例：

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

app.terminate

terminate(): void

退出當(dāng)前Ability。

說明： 從API Version 7開始，推薦使用[@ohos.ability.featureAbility]。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Lite

示例：

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

app.requestFullWindow

requestFullWindow(options?: RequestFullWindowOptions): void

請求應(yīng)用以全窗口運行，F(xiàn)A在某些場景下（如半模態(tài)FA）會以非全窗口運行，調(diào)用該接口會從非全窗口切換為全窗口運行，如果已經(jīng)以全窗口運行則該接口調(diào)用無效。

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

說明： 從API Version 7開始，推薦使用[@ohos.window]。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

示例：

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

app.setImageCacheCount7+

setImageCacheCount(value: number): void

設(shè)置內(nèi)存中緩存解碼后圖片的數(shù)量上限，提升再次加載同源圖片的加載速度。如果不設(shè)置則默認(rèn)為0，不進(jìn)行緩存。緩存采用內(nèi)置的LRU策略，新圖片加載后，如果超過緩存上限，會刪除最久未再次加載的緩存。建議根據(jù)應(yīng)用內(nèi)存需求，設(shè)置合理緩存數(shù)量，數(shù)字過大可能導(dǎo)致內(nèi)存使用過高。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

示例：

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

export default {
    onCreate() { 
        app.setImageCacheCount(100)    // 設(shè)置解碼后圖片內(nèi)存緩存上限為100張
        console.info('Application onCreate')
    },
    onDestroy() {
        console.info('Application onDestroy')
    },
}

app.setImageRawDataCacheSize7+

setImageRawDataCacheSize(value: number): void

設(shè)置內(nèi)存中緩存解碼前圖片數(shù)據(jù)的大小上限，單位為字節(jié)，提升再次加載同源圖片的加載速度。如果不設(shè)置則默認(rèn)為0，不進(jìn)行緩存。緩存采用內(nèi)置的LRU策略，新圖片加載后，如果解碼前數(shù)據(jù)超過緩存上限，會刪除最久未再次加載的圖片數(shù)據(jù)緩存。建議根據(jù)應(yīng)用內(nèi)存需求，設(shè)置合理緩存上限，過大可能導(dǎo)致應(yīng)用內(nèi)存使用過高。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

示例：

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

export default {
    onCreate() {
        app.setImageRawDataCacheSize(104857600) 
        // 設(shè)置解碼前圖片數(shù)據(jù)內(nèi)存緩存上限為100MB (100MB=100*1024*1024B=104857600B)
        console.info('Application onCreate')
    },
    onDestroy() {
        console.info('Application onDestroy')
    },
}

app.setImageFileCacheSize7+

setImageFileCacheSize(value: number): void

設(shè)置圖片文件緩存的大小上限，單位為字節(jié)，提升再次加載同源圖片的加載速度，特別是對網(wǎng)絡(luò)圖源、縮略圖會有較明顯提升。如果不設(shè)置則默認(rèn)為100MB。緩存采用內(nèi)置的LRU策略，新圖片加載后，如果超過文件緩存上限，會按照時間由遠(yuǎn)到近刪除緩存圖片文件直到緩存圖片大小滿足緩存上限。建議根據(jù)應(yīng)用實際需求，設(shè)置合理文件緩存上限，數(shù)字過大可能導(dǎo)致磁盤空間占用過高。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

示例：

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

export default {  
    onCreate() {    
        app.setImageFileCacheSize(209715200) 
        // 設(shè)置圖片文件數(shù)據(jù)緩存上限為200MB (200MB=200*1024*1024B=209715200B) 
        console.info('Application onCreate')
    },  
    onDestroy() {
        console.info('Application onDestroy')
    },
}

AppResponse

定義AppResponse信息。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力有所不同，詳見下表。

ScreenOnVisibleOptions

定義屏幕上可見接口的選項。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full

RequestFullWindowOptions

定義RequestFullWindow接口的選項。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full

審核編輯 黃宇