# Ime工具
<!--Kit: IME Kit-->
<!--Subsystem: MiscServices-->
<!--Owner: @illybyy-->
<!--Designer: @andeszhang-->
<!--Tester: @murphy1984-->
<!--Adviser: @zhang_yixin13-->

**工具用法**<br/>

hdc shell ime [选项] [参数]

**命令列表**
| 选项 | 参数       | 描述                                                         |
| ---- | ---------- | ------------------------------------------------------------ |
| -e | bundle [-b /-f] | 启用指定输入法到指定模式。未设置-b/-f选项时，默认-b为基础模式，-f为全量模式。<br/>**注意：** 预置默认输入法不支持调用此命令改变使能状态。 |
| -d | bundle | 禁用指定输入法。<br/>**注意：** 不允许禁用预置默认输入法。|
| -s   | bundle     | 切换到指定输入法。<br/>**注意：** 在锁屏或密码输入场景下，不允许切换到其他输入法。|
| -g   | NA         | 获取当前输入法。|
| -l   | NA         | 列出所有输入法。|
| -h   | NA         | 显示本帮助信息。|

## 通过ime工具管理输入法示例代码

1. 启用输入法，支持启用三方输入法到基础模式或者全量模式。

   ```shell
    # 输入：hdc命令启用输入法。
    # 处理：检查为shell调用后，将接到启用输入法的接口。
    # 输出：效果等同于启用API调用。
    # 基础模式
    hdc shell ime -e com.xxx.yyy 
    # 全量模式
    hdc shell ime -e com.xxx.yyy -f
   ```

2. 禁用输入法，支持停用三方输入法应用。

   ```shell
    # 输入：hdc命令禁用输入法。
    # 处理：检查为shell调用后，将接到禁用输入法的接口。
    # 输出：效果等同于禁用API调用。
    hdc shell ime -d com.xxx.yyy
   ```

3. 切换到指定输入法。

   ```shell
    # 输入：hdc命令切换输入法。
    # 处理：检查为shell调用后，将接到切换输入法接口。
    # 输出：效果等同于切换输入法API调用。
    hdc shell ime -s com.xxx.yyy
   ```

4. 获取当前输入法。

   ```shell
    # 输入：hdc命令获取当前输入法。
    # 处理：检查为shell调用后，将接到获取当前输入法接口。
    # 输出：效果等同于获取当前输入法API调用。
    hdc shell ime -g
   ```

5. 列出所有输入法，预置默认输入法不显示使能状态。

   ```shell
    # 输入：hdc命令列出所有输入法。
    # 处理：检查为shell调用后，将接到列出所有输入法接口。
    # 输出：效果等同于列出所有输入法API调用。
    hdc shell ime -l
   ```

6. 显示本帮助信息。

   ```shell
    # 输入：hdc命令显示ime帮助信息。
    # 输出：显示ime帮助信息。
    hdc shell ime -h
   ```