應用上下文

說明：

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

導入模塊

import app from '@system.app';

app.getInfo

getInfo(): AppResponse

獲取當前應用配置文件中聲明的信息。

說明： 從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

退出當前Ability。

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

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

示例：

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

app.requestFullWindow

requestFullWindow(options?: RequestFullWindowOptions): void

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

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

說明： 從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ù)量上限，提升再次加載同源圖片的加載速度。如果不設置則默認為0，不進行緩存。緩存采用內置的LRU策略，新圖片加載后，如果超過緩存上限，會刪除最久未再次加載的緩存。建議根據(jù)應用內存需求，設置合理緩存數(shù)量，數(shù)字過大可能導致內存使用過高。

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

參數(shù)：

示例：

// 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

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

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

參數(shù)：

示例：

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

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

app.setImageFileCacheSize7+

setImageFileCacheSize(value: number): void

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

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

參數(shù)：

示例：

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

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

AppResponse

定義AppResponse信息。

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

ScreenOnVisibleOptions

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

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

RequestFullWindowOptions

定義RequestFullWindow接口的選項。

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

審核編輯 黃宇