---
title: "getInfo"
description: "读取应用名、版本、运行平台和当前语言。"
---


> 读取应用名、版本、运行平台和当前语言。

## 签名

```ts
KSM.app.getInfo(): Promise<KSMAppInfo>
```

也可调用 `KSM.getInfo()`，两者执行同一条 `app.getInfo` 命令。

## 平台与权限

| Windows | Android |权限 |
| --- | --- | --- |
|支持 |支持 |无 |

## 参数

无。

## 返回值

```ts
interface KSMAppInfo {
  name: string;
  version: string;
  platform: 'windows' | 'android';
  language: string;
}
```

`language` 使用宿主区域设置的语言标签；Windows 读取用户默认区域，Android 使用
`Locale.getDefault().toLanguageTag()`。

## 行为

- 应用名当前固定为 `Kasumi`。
- 版本来自宿主服务；桥接层没有独立版本查询命令。
- 每次调用都会请求宿主，不缓存应用信息。

## 示例

```ts
const info = await KSM.app.getInfo();

if (info.platform === 'android') {
  console.info(`Android ${info.version}`);
}
```

## 错误

|错误 |场景 |
| --- | --- |
|普通 `Error` |桥接未初始化 |
| `TIMEOUT` |宿主未在默认时间内响应 |
| `UNKNOWN_COMMAND` |自定义宿主没有注册命令 |

## 相关

- [exit](/docs/kasumi/api/app/exit)
- [capabilities](/docs/kasumi/api/core/capabilities)