Android 输入法框架简介

每种平台都有自己的输入法框架. GNU/Linux 桌面环境有多种输入法框架, 比如 ibus, fcitx 等. 但是 Android 操作系统只有一种, 是统一提供的输入法框架.


相关链接:

  • 《ibus 源代码阅读 (1)》 https://blog.csdn.net/secext2022/article/details/136099328
  • https://developer.android.google.cn/develop/ui/views/touch-and-input/creating-input-method

目录

  • 1 Android 输入法框架
  • 2 实现一个简单的 Android 输入法
  • 3 测试
  • 4 总结与展望
  • 附录 1 相关代码

1 Android 输入法框架

在这里插入图片描述

这个图看起来和 ibus 输入法框架差不多, 都有具体的输入法 (engine), 接受输入的应用, 以及系统服务 (输入法框架).

在 Android 系统中, 输入法, 以及接受输入的应用, 都以应用 (apk) 的形式存在. 可以很方便的安装新的输入法, 就和安装普通的应用一样.

2 实现一个简单的 Android 输入法

要想详细的了解 Android 系统的输入法接口, 最好的方法还是自己做一个输入法.

  • (1) 打开 Android Studio, 随意创建一个新的空白应用.

  • (2) 编写一个新的类, 继承 InputMethodService https://developer.android.google.cn/reference/android/inputmethodservice/InputMethodService

    比如创建文件 app/src/main/java/io/github/fm_elpac/pmim_apk/im/PmimService.kt (有省略):

    package io.github.fm_elpac.pmim_apk.im
    
    import android.inputmethodservice.InputMethodService
    
    import android.webkit.WebView
    import android.webkit.JavascriptInterface
    
    class PmimService : InputMethodService() {
    
        // 生命周期函数
        override fun onCreate() {
            super.onCreate()
            // 用于调试 (服务生命周期), 下同
            println("PmimService.onCreate()")
        }
    
        override fun onCreateInputView(): View {
            println("PmimService.onCreateInputView()")
    
            // 创建 WebView
            var w = WebView(this)
            w.getSettings().setJavaScriptEnabled(true)
    
            class 接口 {
                @JavascriptInterface
                fun commit(t: String) {
                    im_commitText(t)
                }
            }
    
            w.addJavascriptInterface(接口(), "pmim")
    
            w.loadUrl("file:///android_asset/ui/index.html")
            return setH(w)
        }
    
        // 预留接口: 输入文本
        fun im_commitText(text: String) {
            currentInputConnection.commitText(text, 1)
        }
    
        fun sendKeyEvent(event: KeyEvent) {
            currentInputConnection.sendKeyEvent(event)
        }
    

    这个类就相当于自己实现的一个输入法了.

    其中重要函数 onCreateInputView() 创建软键盘, 就是显示在屏幕底部的触摸输入区域.

  • (3) 添加输入法相关信息.

    文件 app/src/main/res/xml/im.xml:

    <?xml version="1.0" encoding="utf-8"?>
    <input-method
      xmlns:android="http://schemas.android.com/apk/res/android"
      android:settingsActivity="io.github.fm_elpac.pmim_apk.MainActivity"
      android:icon="@mipmap/ic_launcher">
      <subtype
        android:label="@string/im_label"
        android:name="@string/im_name"
        android:imeSubtypeLocale="zh_CN"
        android:imeSubtypeMode="keyboard"
      />
      <subtype
        android:label="@string/im_label_en"
        android:name="@string/im_name"
        android:imeSubtypeLocale="en_US"
        android:imeSubtypeMode="keyboard"
      />
    </input-method>
    

    文件 app/src/main/res/values/strings.xml:

    <resources>
      <string name="app_name">胖喵拼音</string>
    
      <string name="im_name">胖喵拼音</string>
      <string name="im_label">中文 (中国)</string>
      <string name="im_label_en">Chinese (zh_CN)</string>
    </resources>
    

    im.xml 里面是输入法的信息, 操作系统 (设置输入法) 需要使用.

  • (4) 清单文件 app/src/main/AndroidManifest.xml (有省略):

    <!-- Android 输入法服务 -->
    <service
      android:name=".im.PmimService"
      android:exported="true"
      android:label="@string/im_name"
      android:permission="android.permission.BIND_INPUT_METHOD">
      <intent-filter>
        <action android:name="android.view.InputMethod" />
      </intent-filter>
      <!-- 必须有此元数据, 输入法才能在系统设置中出现 -->
      <meta-data android:name="android.view.im" android:resource="@xml/im" />
    </service>
    

    前面编写的类 PmimService 是传说中的 Android 四大组件 之一 (服务), 所以必须在清单文件中声明.

  • (5) 最后实现用户界面 (底部的软键盘).

    文件 app/src/main/assets/ui/index.html:

    <!DOCTYPE html>
    <html>
    <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>测试输入法键盘</title>
    <style>
    
    body {
      background-color: #FFF3E0;
    }
    
    img {
      width: 150px;
      height: 150px;
    }
    
    .b {
      position: fixed;
      top: 0;
      left: 0;
      width: 100%;
      height: 100%;
      box-sizing: border-box;
      border-top: solid 8px #FF9800;
    
      display: flex;
      align-items: center;
      justify-content: space-around;
    }
    </style>
    </head>
    <body>
      <div class="b">
        <img id="m" src="./m.jpg" />
        <img id="q" src="./q.png" />
      </div>
    
    <script>
    function 输入(t) {
      console.log(t);
    
      pmim.commit(t);
    }
    
    function 初始化() {
      const m = document.getElementById("m");
      const q = document.getElementById("q");
    
      m.addEventListener("click", () => 输入("喵"));
      q.addEventListener("click", () => 输入("穷"));
    }
    
    初始化();
    </script>
    </body>
    </html>
    

3 测试

又到了喜闻乐见的测试环节.

  • (1) 编译 apk (相关重要文件的完整代码请见 附录 1):

    JAVA_HOME=/usr/lib/jvm/java-17-openjdk ./gradlew assembleDebug
    

    编译生成的 apk 文件位于: app/build/outputs/apk/debug/app-debug.apk

  • (2) 安装 apk.

    使用 USB 数据线连接手机和 PC, 然后:

    > adb devices
    List of devices attached
    268bca3e	device
    
    > adb install app-debug.apk
    Performing Streamed Install
    Success
    
  • (3) 在手机的系统设置里, 启用新的输入法:

    在这里插入图片描述

  • (4) 找一个能输入的地方, 切换输入法:

    在这里插入图片描述

  • (5) 然后就可以愉快的输入啦 ~

    在这里插入图片描述

    嗯, 点击这俩图标分别可以输入一个汉字.


我们来分析一下, 点击图标的时候发生了什么.

  • (1) 用户界面 (网页) js 代码调用 pmim.commit()

  • (2) 其中 pmim 是 kotlin 代码调用 addJavascriptInterface() 添加的接口.

  • (3) 最后 kotlin 代码调用了 Android 输入法框架的接口 currentInputConnection.commitText(), 最终实现了文字的输入 (撒花 ~~)

4 总结与展望

各个平台的输入法框架的整体工作原理都差不多, 输入法框架在中间做管理, 一边是输入法, 一边是接受输入的应用.

和 ibus 相比, Android 输入法框架使用起来要简单容易很多, Android 官方文档写的也很清楚, 好评 !

今天实现了输入俩字, 距离实现完整的输入法还会远嘛 ?


彩蛋: 本文使用刚开发的 ibus 输入法编写. 编写本文的过程中顺便又修复了一个 BUG (输入 ).

在这里插入图片描述

附录 1 相关代码

  • app/src/main/java/io/github/fm_elpac/pmim_apk/im/PmimService.kt
package io.github.fm_elpac.pmim_apk.im

import android.inputmethodservice.InputMethodService
import android.view.KeyEvent
import android.view.MotionEvent
import android.view.View
import android.view.inputmethod.EditorInfo
import android.widget.LinearLayout

import android.webkit.WebView
import android.webkit.JavascriptInterface
import android.view.ViewGroup.LayoutParams

// Android 输入法服务, 仅关注面向 Android 系统的接口部分
class PmimService : InputMethodService() {

    // 生命周期函数
    override fun onCreate() {
        super.onCreate()
        // 用于调试 (服务生命周期), 下同
        println("PmimService.onCreate()")
    }

    // 设置软键盘高度
    private fun setH(view: View): View {
        val h = 350f;
        // dp -> px
        val d = resources.displayMetrics.density
        val px = h * d + 0.5f
        println("  dp = " + h + "  d = " + d + "  px = " + px)

        view.setLayoutParams(LayoutParams(-1, px.toInt()))

        val l = LinearLayout(this)
        l.addView(view)
        return l
    }

    override fun onCreateInputView(): View {
        println("PmimService.onCreateInputView()")

        // 创建 WebView
        var w = WebView(this)
        w.getSettings().setJavaScriptEnabled(true);

        class 接口 {
            @JavascriptInterface
            fun commit(t: String) {
                im_commitText(t)
            }
        }

        w.addJavascriptInterface(接口(), "pmim")

        w.loadUrl("file:///android_asset/ui/index.html")
        return setH(w)
    }

    override fun onBindInput() {
        super.onBindInput()
        println("PmimService.onBindInput()")
    }
    override fun onUnbindInput() {
        super.onUnbindInput()
        println("PmimService.onUnbindInput()")
    }

    // 软键盘显示
    override fun onStartInputView(info: EditorInfo, restarting: Boolean) {
        println("PmimService.onStartInputView()")
    }
    // 软键盘隐藏
    override fun onFinishInput() {
        println("PmimService.onFinishInput()")
    }

    override fun onDestroy() {
        super.onDestroy()
        println("PmimService.onDestroy()")
    }

    // 预留接口: 关闭软键盘
    fun im_hideKb() {
        // run on ui thread
        hideWindow()
    }

    // 预留接口: 输入文本
    fun im_commitText(text: String) {
        currentInputConnection.commitText(text, 1)
    }

    fun sendKeyEvent(event: KeyEvent) {
        currentInputConnection.sendKeyEvent(event)
    }

    // 预留接口: 发送编辑器默认动作 (比如: 搜索)
    fun im_sendDefaultEditorAction(fromEnterKey: Boolean) {
        sendDefaultEditorAction(fromEnterKey)
    }

    // 预留接口: 发送字符
    fun im_sendKeyChar(code: Char) {
        sendKeyChar(code)
    }

    // 预留接口: 获取选择的文本 (复制)
    fun im_getSelectedText(): String? {
        return currentInputConnection.getSelectedText(0)?.toString()
    }

    // 预留接口: 设置选择的文本 (比如: 全选)
    fun im_setSelection(start: Int, end: Int) {
        currentInputConnection.setSelection(start, end)
    }
}
  • app/src/main/res/xml/im.xml: 正文中已贴出完整代码.

  • app/src/main/res/values/strings.xml: 正文中已贴出完整代码.

  • app/src/main/AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest
  xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.VIBRATE" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <uses-permission android:name="android.permission.INTERNET" />

  <application
    android:allowBackup="true"
    android:dataExtractionRules="@xml/data_extraction_rules"
    android:fullBackupContent="@xml/backup_rules"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.MyApp"
    tools:targetApi="31">

    <activity
      android:name=".MainActivity"
      android:exported="true"
      android:label="@string/app_name"
      android:theme="@style/Theme.MyApp">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>

    <!-- Android 输入法服务 -->
    <service
      android:name=".im.PmimService"
      android:exported="true"
      android:label="@string/im_name"
      android:permission="android.permission.BIND_INPUT_METHOD">
      <intent-filter>
        <action android:name="android.view.InputMethod" />
      </intent-filter>
      <!-- 必须有此元数据, 输入法才能在系统设置中出现 -->
      <meta-data android:name="android.view.im" android:resource="@xml/im" />
    </service>

  </application>
</manifest>
  • app/src/main/assets/ui/index.html: 正文中已贴出完整代码.

本文使用 CC-BY-SA 4.0 许可发布.

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/412211.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

深入理解 JavaScript 对象原型,解密原型链之谜(上)

&#x1f90d; 前端开发工程师、技术日更博主、已过CET6 &#x1f368; 阿珊和她的猫_CSDN博客专家、23年度博客之星前端领域TOP1 &#x1f560; 牛客高级专题作者、打造专栏《前端面试必备》 、《2024面试高频手撕题》 &#x1f35a; 蓝桥云课签约作者、上架课程《Vue.js 和 E…

前端Vue项目无法启动服务,提示无 ‘dev‘ npm的脚本问题解决

目录 一、问题详情 二、问题解决 一、问题详情 上周还能运行的项目&#xff0c;今天突然无法执行了&#xff0c;连最基本的启动按钮也没有了&#xff0c;所有的项目本地都突然跑不起来了&#xff0c;附上截图。 二、问题解决 后来排查的根本原因有点奇葩&#xff0c;是因为…

C语言--- 指针(3)

一.字符指针变量 在指针的类型中&#xff0c;我们知道有一种指针类型为字符指针char * 一般使用&#xff1a; #include<stdio.h> int main() {char ch a;char* p &ch;*p b;printf("%c\n",ch);return 0; } 其实还有一种使用方式 &#xff1a; #inc…

JSP实现数据传递与保存(一)

一、Web开发步骤 1.1两类模式 后端——————前端 先有前端&#xff0c;前端用的时候直接调用 后端已实现注册接口&#xff0c;接口名为doRegister.jsp 前端此时&#xff1a; 前端的form表单中的action提交地址就只能填doRegister.jsp&#xff0c;即&#xff1a; <f…

ESD管理应用中的浪涌电阻?

静电放电 &#xff08;ESD&#xff09; 会对敏感的电子元件和电路造成严重破坏。为了保护电子设备免受ESD的影响&#xff0c;系统设计人员采用了许多保护措施&#xff0c;包括浪涌电阻器。本文探讨了浪涌电阻器在ESD管理应用中的作用。 首先是一个定义&#xff0c;术语脉冲通常…

Rider 2023:打造高效.NET项目的智能IDE,让开发更简单mac/win版

JetBrains Rider 2023激活版下载是一款专为.NET开发者打造的强大集成开发环境&#xff08;IDE&#xff09;。这款IDE提供了丰富的功能&#xff0c;旨在帮助开发者更快速、更高效地编写、调试和测试.NET应用程序。 Rider 2023 软件获取 Rider 2023在保持了其一贯的智能代码补全…

jmeter 数据库断言

当前版本&#xff1a; jmeter 5.6.3mysql 5.7.39 简介 本篇文章主要通过获取结果集断言&#xff0c;流程&#xff1a;先通过查看结果树获取正确结果&#xff0c;再将正确的结果放入文本断言中&#xff0c;直接启动即可。测试数据库的详细方法见另一篇文章&#xff1a; https:/…

设计模式(八)外观模式

相关文章设计模式系列 1.外观模式简介 外观模式介绍 当我们开发Android的时候&#xff0c;无论是做SDK还是封装API&#xff0c;我们大多都会用到外观模式&#xff0c;它通过一个外观类使得整个系统的结构只有一个统一的高层接口&#xff0c;这样能降低用户的使用成本。 外观…

【c++leetcode】1382. Balance a Binary Search Tree

问题入口 DSW (DAY, STOUT & WARREN) ALGORITHM 时间复杂度O(n) class Solution { public:int makeVine(TreeNode* grand, int cnt 0){auto n grand->right;while (n ! nullptr){if(n->left ! nullptr){auto old_n n;n n->left;old_n->left n->righ…

基于Java SSM框架实现高考填报信息系统项目【项目源码】计算机毕业设计

基于java的SSM框架实现高考填报信息系统演示 JAVA简介 Java主要采用CORBA技术和安全模型&#xff0c;可以在互联网应用的数据保护。它还提供了对EJB&#xff08;Enterprise JavaBeans&#xff09;的全面支持&#xff0c;java servlet API&#xff0c;JSP&#xff08;java serv…

消息中间件篇之Kafka-数据清理机制

一、Kafka文件存储机制 Kafka文件存储结构&#xff1a;一个Topic有多个分区。每一个分区都有多个段&#xff0c;每个段都有三个文件。 为什么要分段&#xff1f;1. 删除无用文件方便&#xff0c;提高磁盘利用率。 2. 查找数据便捷。 二、数据清理机制 1.日志的清理策略方案1 根…

关于python的数据可视化与可视化:数据读取

带着问题寻找答案可以使自己不再迷茫或者不知所措&#xff01; 了解什么python的数据可视化&#xff1f; 数据的读取&#xff08;一般伴随着课程文件中会进行提供和利用&#xff09; 数据可视化是将Python应用于大气海洋科学中数据处理及分析过程的重要环节&#xff0c;它可以…

Flutter SDK 常见问题

镜像配置 配置pub服务的镜像地址&#xff1a; export PUB_HOSTED_URLhttps://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn 第一次运行项目很慢&#xff0c;搜索整个Flutter SDK项目&#xff0c;使用以下内容替换google和mavenCentral仓…

进行模型测量这种量出来坡面的是平面面积还是真实面积?

斜面面积&#xff0c;不是表面积。 DasViewer是由大势智慧自主研发的免费的实景三维模型浏览器,采用多细节层次模型逐步自适应加载技术,让用户在极低的电脑配置下,也能流畅的加载较大规模实景三维模型,提供方便快捷的数据浏览操作。 #DasViewer##实景三维##三维重建##三维模型…

CKA认证,开启您的云原生之旅!

在当今数字化时代&#xff0c;云计算已经成为企业和个人发展的关键技术。而获得CKA&#xff08;Certified Kubernetes Administrator&#xff09;认证&#xff0c;将是您在云原生领域迈出的重要一步。 CKA认证是由Kubernetes官方推出的权威认证&#xff0c;它旨在验证您在Kuber…

嵌入式学习day25 Linux

进程基本概念: 1.进程: 程序&#xff1a;存放在外存中的一段数据组成的文件 进程&#xff1a;是一个程序动态执行的过程,包括进程的创建、进程的调度、进程的消亡 2.进程相关命令: 1.top 动态查看当前系统中的所有进程信息&#xff08;根据CPU占用率排序&a…

网站三合一缩略图片介绍展示源码

网站三合一缩略图片介绍展示源码&#xff0c;PHP源码&#xff0c;运行需要php环境支持&#xff0c;效果截图如下 蓝奏云下载&#xff1a;https://wfr.lanzout.com/ihY8y1pgim6j

php脚本输出中文在浏览器中显示乱码

问题说明 这个问题一般出现在较低版本的php中&#xff0c;原因是php和浏览器的字符解析方式不对应 &#xff0c;导致中文字符被错误解析成乱码 &#xff08;注&#xff0c;此处的php版本任意切换是依赖于小皮面板&#xff08;phpstudy&#xff09;实现的&#xff0c;感兴趣可以…

政安晨:【机器学习基础】(三)—— 提高泛化能力

根据我这个系列的前两篇文章&#xff0c;您会发现您的模型已经表现出了一定的泛化能力&#xff0c;并且能够过拟合&#xff0c;接下来应该专注于将泛化能力最大化。 政安晨的个人主页&#xff1a;政安晨 欢迎 &#x1f44d;点赞✍评论⭐收藏 收录专栏: 政安晨的机器学习笔记 希…

CSS 入门手册(一)

目录 什么是 CSS? 1-CSS语法规则 2-样式表 外部样式表 内部样式表 行内样式表 3-选择器 4-背景 4.1 颜色定义方式 4.2 背景图像 5-文本 5.1 文本颜色 5.2 文本对齐方式 5.3 文本装饰 5.4 文本转换 5.5 文本首行缩进/间距 6-字体 6.1 字体系列 6.2 字体样式…