# 应用上下文 app

# 接口声明

无需声明

# 导入模块

import app from '@system.app' 
// 或 const app = require('@system.app')
1
2

# 接口定义

# app.getInfo()

获取当前应用信息

# 参数：

无

# 返回值

参数名 类型 说明
packageName String 应用包名
icon String 应用图标路径
name String 应用名称
versionName String 应用版本名称
versionCode Integer 应用版本号

# 示例：

console.log(JSON.stringify(app.getInfo()))
1
// console 值打印
{
  // 应用包名
  "packageName": "com.example.demo",
  // 应用名称
  "name": "demo",
  // 应用版本名称
  "versionName": "1.0.0",
  // 应用版本号
  "versionCode": 1,
  // 应用图片
  "icon": "/Common/logo.png"
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# app.loadLibrary(name: string) 2+

加载静态库，需要与厂商合作

# 参数：

参数名 类型 必填 说明
name String 是 静态库名称。

# 返回值

静态库加载结果

# 示例：

import app from '@system.app'
const testApp = app.loadLibrary('test_app')

testApp.on('js_task_callback', () => {
  // callback action
})
1
2
3
4
5
6

# app.canIUse()3+

# 参数：

类型 描述
String 要查询的能力，格式见下方

# 返回值：

类型 描述
Boolean 查询的能力是否支持

# 入参格式

# 查询接口

// 查询feature下的方法是否支持
`@${featureName}.${method}`
// 查询某个feature是否支持
`@${featureName}`
1
2
3
4

示例

import app from '@system.app';

if (app.canIUse('@system.router.push')) {
  // 可以使用方法@system.router.push
}
if (app.canIUse('@system.router')) {
  // 可以使用@system.router接口
}
1
2
3
4
5
6
7
8

# 查询组件

type取值可以是'attr'、'style'、'method'，分别对应组件的属性、样式、方法。

// 查询组件下的属性、样式、方法是否支持
`${componentName}.${type}.${name}`
// 查询组件是否支持
`${componentName}`
1
2
3
4

示例

import app from '@system.app';

if (app.canIUse('scroll')) {
  // 可以使用scroll组件
}
if (app.canIUse('scroll.attr.scroll-x')) {
  // 可以使用scroll组件的scroll-x属性
}
1
2
3
4
5
6
7
8