做 RK3588 安卓定制的朋友应该都有过这种经历整机方案刚定客户就提要求说机器出厂必须带某输入法最好是开机就能打字、不能卸载、不要 Google 输入法。最开始我也觉得内置输入法不就是把一个 APK 丢进/system/app吗真动手才发现一次踩坑能浪费一整天。后来在 RK3588 Android 11/12 上做了多次预置才算把这套流程彻底理顺。这篇文章把内置输入法涉及的.mk文件修改方式、默认输入法设置、常见坑和排查方法完整写一遍给做 RK3588 板卡、行业整机或者自定义 ROM 的同学参考。1. 先搞明白RK3588 安卓内置输入法到底在内置什么1.1 为什么客户非得要“内置”而不是自己装个APK先别急着改文件想清楚需求背后的动机更重要。RK3588 这块芯片常见于一体机、互动广告机、边缘计算盒子、视频会议终端、门禁面板、自助收银机这类行业设备。这类设备的最终用户大概率不是“极客”他们不会主动去应用商店下载输入法也没耐心在设置里翻半天。对于整机出货方来说最理想的状态是设备开机、进系统、点一下输入框输入法自己就弹出来了。这个体验只能靠出厂预置来保证而不是让用户自己装 APK。从技术角度看“普通安装”和“内置到系统”也有本质差别。普通安装的 APK 属于用户应用数据放在/data/data下可以被卸载、被清理、被其他应用抢占首选项。而预置到/system/app或/system/priv-app之后它就成了系统应用不仅不可卸载还能拿到普通应用拿不到的权限等级。输入法本质上是一个系统级服务型应用它不打包进系统镜像就总有一种“随时可能被搞掉”的不稳定感。还有一个被大多数人忽视的原因客户后续要批量刷机。如果没有预置你需要在每台设备上手动安装、配置几千台设备这个工作量非常可观。而只要把输入法编进固件烧录一次就全部搞定产线效率完全不同。1.2 输入法框架与 InputMethodService内置的本质是什么很多人把“内置输入法”理解成“把 APK 加进系统镜像”这个理解没错但太浅了。输入法能在安卓里工作靠的是一套完整的框架机制理解这个机制后面排坑才不慌。输入法 APK 的核心是一个继承自android.inputmethodservice.InputMethodService的 Service。这个 Service 必须在AndroidManifest.xml里声明权限android.permission.BIND_INPUT_METHOD并且配置对应的 intent-filter通常是android.view.InputMethod这个 action。系统里的InputMethodManagerService会扫描所有已安装应用的组件把满足条件的 Service 加入“输入法候选列表”。所以内置一个输入法到系统本质上是在解决三个问题APK 一定要存在于系统镜像中开机后系统能扫描到它。APK 里的输入法 Service 必须合法权限声明、intent-filter、类名都不能错。系统设置里要把这个输入法设为默认并且保证它处于启用状态。还有一个容易被忽略的点组件名一定要精确。输入法的默认设置不是按包名认的而是按“包名/Service 完整类名”来认的。比如搜狗输入法的组件名通常是com.sohu.inputmethod.sogou/.SogouIME讯飞输入法是com.iflytek.inputmethod/.FlyIME百度输入法是com.baidu.input/.ImeService。写错一个字母默认输入法就不生效而且系统不会报错只是默默回退到 AOSP 输入法排查起来非常头疼。2. 改 .mk 之前先吃透这几个关键概念2.1 RK3588 SDK 里 .mk 文件到底怎么分工RK3588 的 SDK 里.mk文件不少初学者容易搞混。我按实际用途给你分个类。device/rockchip/rk3588/BoardConfig.mk板级配置主要管 kernel、uboot、分区大小、动态分区、AB 分区、selinux 策略等。一般内置 APK 不需要动它。device/rockchip/rk3588/device.mk有些版本叫rk3588.mk产品级配置文件是产品定义的核心我们常说的PRODUCT_PACKAGES、PRODUCT_COPY_FILES就写在这里。vendor/rockchip/common/device.mkRK 所有产品会继承的公共配置。除非你确认所有 RK3588 产品都要带某个输入法否则不建议改这里影响面太大。各个模块目录下的Android.mk定义单个模块如何编译、预置。我们要内置 APK主要就是写这种文件。在实际项目中我习惯按“模块自包含”的原则处理在vendor/rockchip/common/apps/下为每一个预装 APK 建一个独立目录目录里放Android.mk和 APK 文件然后在产品的device.mk里用PRODUCT_PACKAGES引用模块名。这样每个模块的配置、签名方式、依赖关系都集中管理后续裁剪、升级、排查都方便。2.2 PRODUCT_PACKAGES 怎么用才不出错PRODUCT_PACKAGES是产品 mk 文件里最常见、也最容易被误用的变量。它的作用是告诉构建系统“这个产品需要包含以下模块”。这里的“模块”不是 APK 文件名而是Android.mk里LOCAL_MODULE指定的那个名字。举个例子如果我写了一个Android.mk里面LOCAL_MODULE : SogouInput那么PRODUCT_PACKAGES SogouInput才是对的。如果你写成PRODUCT_PACKAGES SogouInput.apk构建系统会去搜索一个名为SogouInput.apk的模块大概率直接报ninja: error: unknown target。另外注意PRODUCT_PACKAGES支持用\换行追加多个模块这是很常见的写法PRODUCT_PACKAGES SogouInput \ FlyIME \ BaiduInput如果你的产品有多个国内输入法可选这种写法一目了然。但要注意模块名不能重复同一个模块在同一个产品里只能出现一次重复了不会报错但属于冗余。还有一点需要特意提醒有的人图省事直接用PRODUCT_COPY_FILES把 APK 拷贝到/system/app/SogouInput/SogouInput.apk。这在旧版本 Android 上能跑但在 Android 10 及更高版本上容易出问题。因为系统扫描 APK 时不仅仅看路径还会校验 APK 的安装方式、签名、权限模型直接拷贝的文件很容易被系统当作“不合法应用”导致输入法被系统忽略。正规做法还是通过Android.mk写成预置模块让 PackageManager 完整参与安装流程。2.3 内置输入法的三件套APK、权限、默认设置我还真见过不少把 APK 编进镜像就以为万事大吉的项目。实际上一个“能用”的内置输入法必须同时满足三个条件我管它叫“三件套”。第一件是APK 本身。这里不光是文件存在还要求 APK 格式正确、so 库完整、目标平台兼容。RK3588 是 arm64 架构如果你的 APK 只带 32 位库虽然理论上可以兼容运行但实测稳定性会差一些。后面我会专门讲这个坑。第二件是权限。输入法要正常弹键盘除了在 Manifest 里声明BIND_INPUT_METHOD权限之外通常还需要作为系统应用来获得更高的权限等级。预置到/system/app后应用会处于系统应用级别很多受限操作就能做了。如果放到普通路径但又要求它有特权权限就不行。第三件是默认设置。这一步是多数人忽略的。内置输入法之后系统默认输入法仍然是 AOSP 的 LatinIME或者干脆没有默认输入法。用户使用时要么手动切换要么切不出来。所以我们必须通过某种方式把Settings.Secure里的default_input_method和enabled_input_methods写入正确值。这个“某种方式”非常有讲究我在第三章里重点讲。3. 实操.mk 文件修改让输入法预置进系统3.1 准备输入法 APK 和目录结构开始动手之前先准备一个合适的输入法 APK。我的建议是尽量从官方渠道拿正式版别用网上各种“精简版”“去广告版”。这些改版 APK 经常被重新签名甚至篡改过核心代码预置到系统后遇到诡异问题你根本没法跟客户解释。选好 APK 后在 SDK 的vendor/rockchip/common/apps/目录下建一个项目专属文件夹比如叫SogouInput。目录结构如下vendor/rockchip/common/apps/SogouInput/ ├── Android.mk ├── SogouInput.apk └── README.mdREADME.md这个文件是我后来才养成的习惯。里面只写三行包名、输入法 Service 组件名、签名方式。这样过了几个月你再回来维护这个项目不用反编译 APK 就能快速定位问题。3.2 编写 Android.mk 预置模块在SogouInput目录下创建Android.mk内容如下LOCAL_PATH : $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE : SogouInput LOCAL_MODULE_CLASS : APPS LOCAL_MODULE_TAGS : optional LOCAL_BUILT_MODULE_STEM : package.apk LOCAL_MODULE_SUFFIX : $(COMMON_ANDROID_PACKAGE_SUFFIX) LOCAL_SRC_FILES : SogouInput.apk LOCAL_CERTIFICATE : PRESIGNED LOCAL_DEX_PREOPT : false include $(BUILD_PREBUILT)这里每个变量的作用我简单讲一下方便你按需调整。LOCAL_MODULE模块名后面PRODUCT_PACKAGES里用的就是这个名字。LOCAL_MODULE_CLASS : APPS声明这是一个 APK 模块。LOCAL_SRC_FILES指定 APK 文件路径相对于当前Android.mk。LOCAL_CERTIFICATE : PRESIGNED使用 APK 自身的签名不做重签。这是最稳妥的方式。LOCAL_DEX_PREOPT : false关闭 dex 预编译。如果设成true系统会在编译时进行 AOT 优化能提升首次启动速度但有时候会导致优化失败或应用崩溃。对输入法这种 APK 来说我建议先关掉保证稳定。如果要预置到/system/priv-app也就是让它成为特权应用可以加一行LOCAL_PRIVILEGED_MODULE : true不过大多数输入法并不需要特权级权限放/system/app就够了。放到 priv-app 反而可能因为权限过高引发其他安全问题没必要。如果你需要让应用获得平台签名权限可以把LOCAL_CERTIFICATE : PRESIGNED改成LOCAL_CERTIFICATE : platform。但要注意一旦改了系统签名APK 原本的签名校验逻辑就会被破坏很多输入法应用内会检查自身签名发现对不上就拒绝工作。所以不是特殊需要别乱改。3.3 在 device.mk 中注册并设置默认输入法写完Android.mk接下来打开 RK3588 产品的device.mk或者rk3588.mk在文件末尾追加一行PRODUCT_PACKAGES SogouInput到这里APK 已经可以编译进系统镜像了。但别高兴太早还有一个大问题在前面等着默认输入法还没设。设置默认输入法的方式有几种我按可靠性排序说一下。第一种改 SettingsProvider 的默认值。在frameworks/base/packages/SettingsProvider里loadSecureSettings方法会写入一批默认值。我们可以在这里加入out.putString(Settings.Secure.ENABLED_INPUT_METHODS, com.sohu.inputmethod.sogou/.SogouIME); out.putString(Settings.Secure.DEFAULT_INPUT_METHOD, com.sohu.inputmethod.sogou/.SogouIME);这种方式最可靠因为系统在开机的早期阶段就会写库后续不会再有别的流程覆盖它。缺点是必须改 framework 代码每次同步上游代码都可能冲突编译时长也会增加。第二种用 init.rc 在开机完成后执行 settings 命令。在产品目录下放一个类似init.rk3588.rc的文件内容大致如下on property:sys.boot_completed1 exec u:r:system_app:s0 -- /system/bin/settings put secure enabled_input_methods com.sohu.inputmethod.sogou/.SogouIME exec u:r:system_app:s0 -- /system/bin/settings put secure default_input_method com.sohu.inputmethod.sogou/.SogouIME然后通过PRODUCT_COPY_FILES把这个 rc 文件拷贝到/vendor/etc/init/目录。这种方式的优点是不改 framework编译快缺点是要注意 SELinux 权限settings命令在 init 上下文中可能被拦截。顺利的话能用但出问题时要花点时间看 avc 日志。第三种写一个开机广播接收器。简单说就是再内置一个小 APK注册BOOT_COMPLETED广播在广播里调用Settings.Secure.putString写入默认输入法。这个 APK 必须预置为系统应用才能直接写WRITE_SECURE_SETTINGS。这个方法最灵活但要维护多一个 APK稍微有点重。我的实际经验是如果这个 ROM 是长期维护的优先改SettingsProvider如果只是给某个项目快速出包那就用 init.rc 或者开机广播。3.4 编译验证确保真的生效配置写好后开始编译。单编一个模块用source build/envsetup.sh lunch rk3588-userdebug make SogouInput -j16如果只改动了产品 mk 和新增模块不想整编整个系统可以先编模块确认模块本身没问题。但注意PRODUCT_PACKAGES的变更通常需要重新生成镜像所以最后还是要编一下 systemimagemake systemimage -j16刷机之后用下面几条命令验证# 看包是否装进系统 adb shell pm list packages | grep sogou # 看输入法是否被系统识别 adb shell ime list -s # 查看默认输入法设置 adb shell settings get secure default_input_method adb shell settings get secure enabled_input_methods如果最后一条命令返回的组件名和我们设置的一致那基本就成了。然后重启一次打开任意输入框看弹出的键盘是不是我们内置的输入法。这一步一定要做因为有些问题只有冷启动之后才暴露。4. 避坑实录RK3588 内置输入法的典型问题4.1 常见问题速查表先给一张速查表方便你日后真遇到问题时快速定位现象常见原因排查切入点系统设置里看不到输入法APK 未编进镜像、Service 声明错误、权限缺失pm list packages、ime list -s能安装但一打字就崩so 库架构不匹配、APK 与系统版本不兼容logcat、检查 abilist默认输入法设置了但重启失效enabled 列表漏配、被 SetupWizard 覆盖settings get secure编译报 unknown targetPRODUCT_PACKAGES模块名写错检查LOCAL_MODULE首次开机极慢dex 预编译导致调整LOCAL_DEX_PREOPTAPK 扫描到但被标记为错误直接PRODUCT_COPY_FILES拷贝导致改用 PREBUILT 模块方式4.2 坑1系统定位不到输入法组件这是最常见的坑现象就是刷机后打开“设置-语言与输入法”里面空空如也或者你的输入法根本不在列表里。首先确认包有没有真正编进系统。执行adb shell pm list packages | grep sogou如果看不到包名那就是模块没编进去回去查PRODUCT_PACKAGES和LOCAL_MODULE是否匹配。如果包名能查到但adb shell ime list -s里没有问题多半出在 APK 的 Service 声明上。用 aapt 查看 Manifestaapt dump xmltree SogouInput.apk AndroidManifest.xml | grep -E BIND_INPUT|InputMethod一个合法的输入法 Service 至少要有service android:name.SogouIME android:label搜狗输入法 android:permissionandroid.permission.BIND_INPUT_METHOD intent-filter action android:nameandroid.view.InputMethod / /intent-filter meta-data android:nameandroid.view.im android:resourcexml/method / /service如果缺了某个部分系统扫描时就直接跳过。这种情况下你换一个官方正版 APK 一般就能解决不需要改代码。4.3 坑2默认输入法设置不生效我踩过最深的坑就是明明在SettingsProvider里写了默认值刷机后settings get secure default_input_method返回的也是对的但重启后又变了。后来排查发现enabled_input_methods里没有把我们内置的输入法加进去。系统有一个逻辑如果默认输入法不在启用列表里就会自动回退到下一个可用输入法甚至 AOSP 输入法。所以设置默认输入法时必须同时设置启用列表adb shell settings put secure enabled_input_methods com.sohu.inputmethod.sogou/.SogouIME adb shell settings put secure default_input_method com.sohu.inputmethod.sogou/.SogouIME如果是多个输入法并存启用列表要用逗号分隔com.sohu.inputmethod.sogou/.SogouIME,com.baidu.input/.ImeService还有一点容易被忽略开机阶段如果有个 SetupWizard 或者其他初始化流程它可能会在某一时刻覆盖输入法设置。解决方法是把设置动作放到sys.boot_completed1之后并且最好加一个小的延迟确保其他初始化流程已经完成。4.4 坑3一打字就崩溃或键盘弹不出来这个坑的典型症状是键盘图标出来了启动器里也能看到输入法应用但一点输入框就闪退或者键盘直接弹不出来。最常见原因是 so 库架构不匹配。RK3588 的 CPU 是 arm64但你可能下载了一个只包含armeabi-v7a库的 APK。这时候系统虽然可以安装但运行时会因为某些 native 方法找不到而崩溃。用这条命令查看系统支持的架构adb shell getprop ro.product.cpu.abilist正常 RK3588 系统会返回类似arm64-v8a,armeabi-v7a,armeabi如果你的 APK 在lib/arm64-v8a目录下没有对应的 so 文件那就要换一个 arm64 版本。现在主流输入法在应用市场都会提供多架构包直接找官方适配版。排查崩溃时用 logcat 最直接adb logcat -s AndroidRuntime:E adb logcat -s InputMethodManager:I崩溃堆栈里会明确告诉你哪个库找不到哪个类加载失败。有时候还是 APK 的minSdkVersion高于系统版本也会导致运行异常这时候就要找兼容低版本的输入法 APK。4.5 坑4签名与权限的连环坑签名问题一般出现在两种情况。第一种你把LOCAL_CERTIFICATE设成了platform但 APK 原本是第三方签名的APK 内部做了签名校验。编译能过系统也能启动但输入法一运行就提示“版本异常”或者直接闪退。这种情况要么换官方签名的 APK要么用PRESIGNED保留原签名。第二种你用PRODUCT_COPY_FILES把 APK 放到/system/app系统发现 APK 没有经过 PackageManager 的正式安装流程权限模型不完整导致BIND_INPUT_METHOD权限没生效。这种问题表面上很迷惑因为 APK 明明在系统里系统就是不把它当输入法。解决方式就是别用拷贝方式老老实实写Android.mk。另外如果你确实需要系统级权限但又要保留 APK 原始签名可以考虑给 APK 重新签名成 platform 密钥但这需要 APK 没有自我签名校验。实际操作中我会先用keytool -printcert -jarfile SogouInput.apk看下当前签名再用系统platform.x509.pem和platform.pk8重新签名。不过这条路能不走就不走改 APK 签名后万一厂商输入法有更新校验逻辑后续会很麻烦。5. 进阶让内置输入法更接近“出厂自带”5.1 多输入法共存的顺序与切换策略行业设备有时候会预装两个或更多输入法比如搜狗和讯飞。这时候不仅要把它们都编进系统还要处理它们之间的顺序关系。enabled_input_methods用逗号分隔多个组件名列表顺序会影响输入法切换时的循环顺序。default_input_method指向默认那个。我建议把客户最常用的输入法放在default_input_methodenabled_input_methods里也把它放第一位这样用户切换时会优先回到主输入法。有些设备并不希望用户随意切换输入法这时候可以只启用一个输入法把 AOSP 输入法从系统里直接裁剪掉。裁剪方式是在device.mk里用PRODUCT_PACKAGES不包含 AOSP 输入法模块或者用LOCAL_OVERRIDES_PACKAGES在预置模块里声明它覆盖系统输入法。例如LOCAL_OVERRIDES_PACKAGES : LatinIME这样在构建时如果同时预置了SogouInput系统会从最终镜像中移除默认的 LatinIME用户就只能看到搜狗一个输入法整个系统会清爽很多。5.2 分区与优化system 空间和 dex 预编译内置输入法后系统镜像体积会变大。RK3588 的 eMMC 通常 32G 起步一个输入法 APK 几十 MB 根本不算什么但如果你内置了三、四个输入法还要考虑一下空间占用。更大的问题是首次开机的 dex 优化。每次烧写完第一次开机系统会对所有应用做 dex 优化预置的 APK 越多开机时间越长。如果某个 APK 优化失败甚至可能导致整个开机流程卡住。处理思路有几个。一个是在Android.mk里对预置输入法开启LOCAL_DEX_PREOPT : true让它在编译期就完成优化开机时就不用再做了。但要注意不是所有 APK 都能顺利预优化如果遇到问题立刻关掉。另一个思路是控制预置数量行业设备没必要预装一堆输入法一个够用就好。如果你的 SDK 分区结构比较新输入法也可以放到/product/app或/system_ext/app。这些分区在动态分区方案下仍然是只读的但解耦性更好后续 OTA 时可以单独升级。写法上还是用PRODUCT_PACKAGES通过LOCAL_MODULE_PATH指定目标路径即可。对于 RK3588 的常规项目放/system/app最稳不建议为了炫技随便换分区。5.3 SELinux 与自研输入法的权限要点如果你只是内置现成的搜狗、讯飞一般不需要碰 SELinux。但如果你是给公司自研输入法做预置那就绕不开 sepolicy 了。自研输入法如果涉及读取本地词库、访问网络、读取联系人用于联想等敏感操作需要为它单独配置 domain 和 allow 规则。比如在device/rockchip/rk3588/sepolicy/下新建一个mytime.tetype myime, domain, app_domain; type myime_data_file, file_type, data_file_type; app_domain(myime)编译烧录后用adb shell dmesg | grep avc查看有没有被拦截的权限。如果看到avc: denied就根据日志补规则。这里有个排坑技巧输入法弹不出键盘、或者切换不了不一定是代码问题也可能是 SELinux 把某个 binder 调用给挡住了。先看avc日志再去改代码顺序不能反。最后再说几句内置输入法这件事说难不难说简单也藏了不少坑。我个人在实际操作中的体会是不要试图走捷径比如用PRODUCT_COPY_FILES直接塞 APK或者随便把LOCAL_CERTIFICATE改成 platform。每一步都按“模块化、可追溯”的方式来做后面维护会轻松很多。另外每次在.mk里加一个新模块我都会先单独执行一次make 模块名确认模块能编过再整包编译这样能省去整包失败后大海捞针的排查时间。还有一个小习惯就是建一个预装应用清单文件记录每个 APK 的包名、Service 组件名、签名方式、版本号和来源。这看起来笨但在项目交付半年后再回来加需求时你会感谢当年的自己。RK3588 的定制空间很大内置输入法只是其中一个基础操作。把这类基础操作做扎实后面做更复杂的系统定制才不至于栽在阴沟里。