1. 为什么要在Android 13里集成搜狗输入法如果你是一个Android系统开发者或者是一个喜欢折腾自己手机ROM的发烧友那你肯定遇到过输入法的问题。原生的AOSP输入法功能比较基础对于习惯了搜狗、百度这类第三方输入法丰富词库和智能预测的用户来说体验上总差那么点意思。所以把搜狗输入法直接“烧”进系统里让它成为出厂自带的、甚至是唯一的默认输入法就成了很多定制ROM的刚需。我做过不少这类集成工作实测下来好处很明显。首先用户体验无缝衔接。用户开机激活设备后不需要再去应用市场下载安装直接就能用上功能全面的输入法减少了设置步骤也避免了用户因为找不到好用的输入法而抱怨。其次系统级集成更稳定。作为系统应用System App搜狗输入法可以获得更高的运行权限和更稳定的进程保活能力不容易被系统“杀掉”切换和响应都会更流畅。最后对于商业项目来说这也是品牌定制化的一部分可以预装符合特定用户群体习惯的输入法。当然在Android 13Tiramisu上做这件事和之前的版本有些不一样。Android 13在隐私、权限和后台行为管理上更加严格比如对常驻通知、后台服务唤醒都有新规。这要求我们在集成时不仅要考虑“能不能用”还要考虑“能不能长久稳定地用”以及“是否符合新系统的规范”。所以接下来的内容我会手把手带你走一遍完整的集成与优化流程把我在实际项目中踩过的坑和总结的经验都分享给你。2. 前期准备获取正确的输入法APK与理解系统结构动手之前准备工作做得好后面能省下一大半的麻烦。这里有两个关键点APK来源和目录规划。首先关于搜狗输入法APK。你绝对不能随便从某个应用商店下载一个安装包就拿来用。普通渠道下载的APK是给用户安装的它依赖Google Play服务或各家应用商店的推送框架并且签名是开发者的无法直接放入系统。我们需要的是搜狗官方提供的、用于OEM预装的版本。这类版本通常移除了不必要的依赖和广告组件并且签名是“平台签名”platform或“共享签名”shared这样才能被系统信任。如果你没有商业合作渠道也可以尝试自己反编译普通APK移除相关依赖后重新用平台密钥签名但这涉及复杂的逆向工程且可能违反许可协议这里就不展开了。我们假设你已经拿到了合规的预装版APK文件名叫SogouInput.apk。其次理解AOSP的预装目录结构。AOSP提供了好几个地方可以放预装应用常见的有vendor/、system/分区下的app/或priv-app/。我们的选择会影响应用的权限等级放在system/app/普通系统应用权限较低。放在system/priv-app/特权系统应用可以申请更高的权限。放在vendor/分区下如vendor/rockchip/common/apps这是芯片厂商或设备制造商ODM/OEM放置定制应用的地方灵活性最高也便于在编译时通过BoardConfig.mk来控制。我强烈推荐放在vendor/目录下。这样做的好处是当你需要为不同型号设备编译时可以很方便地通过PRODUCT_COPY_FILES变量来包含或排除这个应用而不用去改动AOSP的核心代码树。我们就以原始文章提到的vendor/rockchip/common/apps为例但你要知道这个路径是因厂商而异的你的平台可能是vendor/xxx/yyy/apps。准备好APK并确定好要放的目录例如vendor/your_company/apps/SougouInput/我们就可以开始第一步了。3. 第一步将输入法APK内置为系统应用这一步的目标是让搜狗输入法APK在系统编译时被打包到系统镜像system.img或vendor.img的指定位置并赋予其系统应用的属性。3.1 创建目录与编写Android.mk首先在你的AOSP源码树下创建对应的目录cd /path/to/your/aosp mkdir -p vendor/your_company/apps/SougouInput将准备好的SogouInput.apk拷贝到这个目录。然后创建关键的Android.mk文件touch vendor/your_company/apps/SougouInput/Android.mk接下来是Android.mk的内容这是告诉编译系统如何处理这个模块的脚本。原始文章给出的是一个示例但我们需要根据实际情况调整和解释LOCAL_PATH : $(my-dir) include $(CLEAR_VARS) LOCAL_MODULE : SogouInput LOCAL_MODULE_CLASS : APPS LOCAL_MODULE_TAGS : optional LOCAL_MODULE_SUFFIX : $(COMMON_ANDROID_PACKAGE_SUFFIX) LOCAL_CERTIFICATE : PRESIGNED LOCAL_PRIVILEGED_MODULE : false LOCAL_SRC_FILES : $(LOCAL_MODULE).apk # 指定ABI确保32位库被正确安装 LOCAL_MULTILIB : 32 # 预编译的JNI库声明非常重要 LOCAL_PREBUILT_JNI_LIBS : \ lib/armeabi/libac_checker.so \ lib/armeabi/libaffinity.so \ lib/armeabi/libbugly_dumper.so \ lib/armeabi/libBugly_Native.so \ lib/armeabi/libc_shared.so \ lib/armeabi/libcleanmmap.so \ lib/armeabi/libcrash_collect.so \ lib/armeabi/libCtaApiLib.so \ lib/armeabi/libframesequence.so \ lib/armeabi/libframesequence_doutu.so \ lib/armeabi/liblogan.so \ lib/armeabi/libluajava.so \ lib/armeabi/libmarsxlog.so \ lib/armeabi/libMMANDKSignature.so \ lib/armeabi/libmmkv.so \ lib/armeabi/libnative-sec.so \ lib/armeabi/libopus_v1.so \ lib/armeabi/libostar.so \ lib/armeabi/libqmp.so \ lib/armeabi/libSGMtlgShell.so \ lib/armeabi/libsogou_speex_nt_v01.so \ lib/armeabi/libsogouime.so \ lib/armeabi/libsogouupdcore.so \ lib/armeabi/libtma_blowing_sound_detection.so \ lib/armeabi/libtrace-canary.so \ lib/armeabi/libturingga.so \ lib/armeabi/libvivo_account_wave.so \ lib/armeabi/libwebrtc_ns.so \ lib/armeabi/libweibosdkcore.so include $(BUILD_PREBUILT)我来解释几个容易出错的点LOCAL_CERTIFICATE : PRESIGNED这表示APK已经签好名了编译系统不会对它重新签名。这要求你的APK必须是用合适的密钥如平台密钥预先签名的。如果你用的是搜狗提供的预装版通常就是这个情况。LOCAL_MULTILIB : 32这指定了APK中本地库.so文件的位数。搜狗输入法可能仍主要提供32位库以保证兼容性。如果你的设备是纯64位系统可能需要确认搜狗是否有提供64位库并相应修改此项和LOCAL_PREBUILT_JNI_LIBS的路径如lib/arm64-v8a/。LOCAL_PREBUILT_JNI_LIBS这是整个Android.mk里最容易出错的部分。它列出了APK中lib/目录下的所有JNI库文件。符号是必须的它告诉编译系统这些库文件是从APK中解压出来的。后面的路径是APK内部lib/文件夹下的相对路径。你必须确保这个列表和你APK里lib/armeabi/或lib/arm64-v8a/文件夹下的.so文件完全一致一个都不能多一个也不能少。否则编译时会报错。检查方法很简单用解压软件打开SogouInput.apk查看lib/目录结构即可。3.2 确保模块被编译系统包含创建好Android.mk还不够你需要确保这个模块能被顶层编译系统发现。通常需要在你的设备产品定义文件比如device/your_company/your_device/device.mk或your_device.mk中通过PRODUCT_PACKAGES变量添加这个模块PRODUCT_PACKAGES \ SogouInput这样在执行lunch选择你的设备并m编译时SogouInput模块就会被编译并打包进系统镜像。4. 第二步配置系统默认输入法现在搜狗输入法已经能作为系统应用安装了但系统启动后并不知道要把它设为默认输入法。我们需要修改系统设置数据库的默认值。4.1 修改默认输入法列表这个配置位于frameworks/base/packages/SettingsProvider/res/values/defaults.xml。这个文件定义了系统各项设置的初始默认值。我们需要找到def_enabled_input_methods这个字符串并将其值设置为搜狗输入法的组件名。用编辑器打开这个文件找到类似下面的行string namedef_enabled_input_methods translatablefalsecom.android.inputmethod.latin/.LatinIME/string这是默认的AOSP拉丁输入法。我们需要把它改成搜狗输入法的。如何获取搜狗输入法的组件名最准确的方法是解压APK查看AndroidManifest.xml文件中service或receiver标签里声明了android:name.SogouIME或类似名称并且带有android.permission.BIND_INPUT_METHOD权限的那个组件的全名。通常格式是包名/类名。根据原始文章搜狗输入法的组件名是com.sohu.inputmethod.sogou/.SogouIME。因此修改为string namedef_enabled_input_methods translatablefalsecom.sohu.inputmethod.sogou/.SogouIME/string这意味着系统在首次启动初始化设置数据库时就会将搜狗输入法加入到“已启用的输入法”列表中。4.2 修改SettingsProvider的数据库初始化逻辑仅仅修改defaults.xml还不够因为Settings.Secure.ENABLED_INPUT_METHODS这个键值对需要在系统首次启动时由SettingsProvider从defaults.xml中读取并写入数据库。这个逻辑在frameworks/base/packages/SettingsProvider/src/com/android/providers/settings/DatabaseHelper.java文件中。你需要在这个文件的loadSecureSettings()方法里找到加载ENABLED_INPUT_METHODS的那一行代码。通常它长这样loadStringSetting(stmt, Settings.Secure.ENABLED_INPUT_METHODS, R.string.def_enabled_input_methods);原始文章里提到了这行代码你只需要确认它存在即可。通常AOSP的代码里已经有了这行你不需要新增只需要确保它引用的R.string.def_enabled_input_methods就是我们上一步修改的那个资源ID。这一步主要是为了让你理解整个链条defaults.xml定义默认值 -DatabaseHelper.java在初始化数据库时将其写入 - 系统服务读取该设置。5. 第三步屏蔽原生系统输入法可选但推荐完成前两步搜狗输入法已经是默认启用的输入法了。但为了更极致的定制避免用户看到或切换到那个用不到的原生输入法我们可以选择在编译时将其移除。原始文章提到在build/make/target/product/handheld_product.mk中注释掉相关包。这是一个全局性的配置会影响所有基于handheld_product的产品。更推荐的做法是在你自己设备的产品配置文件如device.mk中使用PRODUCT_PACKAGES变量来覆盖。首先你需要知道AOSP原生输入法的模块名。通常是LatinIME对于AOSP键盘或OpenWnn等。你可以在handheld_product.mk里搜索PRODUCT_PACKAGES找到它们。然后在你的device/your_company/your_device/device.mk文件中不要把这些输入法模块添加到PRODUCT_PACKAGES里。因为PRODUCT_PACKAGES是累加的所以更干净的做法是在你的device.mk文件末尾明确地移除它们# 移除不需要的AOSP输入法 PRODUCT_PACKAGES : $(filter-out LatinIME, $(PRODUCT_PACKAGES)) PRODUCT_PACKAGES : $(filter-out OpenWnn, $(PRODUCT_PACKAGES))这样在最终编译生成的系统镜像中就不会包含这些输入法应用了。6. 进阶优化与Android 13适配要点如果你以为做完上面三步就万事大吉那在实际项目中可能会遇到一些头疼的问题。尤其是在Android 13上系统对后台应用的管理和权限控制更加细致。下面是我总结的几个优化和适配点。6.1 处理输入法服务IME的常驻通知从Android 11开始前台服务Foreground Service必须显示一个常驻通知。输入法服务在激活时通常以前台服务形式运行。在Android 13上用户对通知权限的控制更强。如果处理不好用户可能会在通知栏看到一个无法关闭的“搜狗输入法正在运行”的通知体验很差。优化建议检查你集成的搜狗输入法APK版本。较新的、为Android 11适配的版本其通知应该被归类为“服务通知”或“系统输入法通知”并且重要性等级较低可能可以折叠或隐藏。如果版本较旧你可能需要反编译修改其通知渠道Notification Channel的配置或者联系搜狗获取适配版本。作为系统集成者你可以在系统层面尝试通过NotificationManager的策略来管理这类通知的显示但这需要更深入的HAL层定制。6.2 确保在“设置-系统-语言与输入法”中可见有时候即使输入法被正确启用在系统的输入法选择列表里也可能不显示。这通常是因为输入法应用的AndroidManifest.xml中声明输入法服务的service标签里缺少了android:isDefaulttrue属性或者其android:permission不是android.permission.BIND_INPUT_METHOD。由于我们使用的是预编译的APK无法直接修改清单文件。排查方法在设备启动后通过ADB shell执行以下命令adb shell ime list -a这个命令会列出所有已安装且可用的输入法。如果搜狗输入法没有出现在列表里说明系统没有识别它为一个有效的输入法服务。这时需要检查APK是否成功安装到了system/priv-app或system/app目录通过adb shell pm list packages | grep sogou查看。输入法服务所需的权限是否被正确授予。作为系统应用通常没问题。最可能的原因还是APK本身与当前系统ABI不兼容或者其AndroidManifest.xml声明有误。这只能通过更换APK版本来解决。6.3 应对Android 13的“后台运行限制”Android 13进一步收紧了应用在后台运行和获取资源的能力。虽然系统输入法优先级较高但仍可能在某些极端省电策略下受到影响。优化建议确保输入法应用在设备“电池优化”的白名单中。这可以通过在设备初始化脚本如init.rc或一个系统应用中使用dumpsys deviceidle whitelist命令将搜狗输入法的包名加入白名单。更优雅的方式是在你的device.mk中配置PRODUCT_SYSTEM_SERVER_COMPILER_FILTER和电池优化策略文件但这部分内容较深需要根据具体设备厂商的框架进行调整。一个简单的测试方法是集成完成后让设备长时间待机再点亮屏幕尝试调出输入法看是否有延迟或需要重新加载的情况。6.4 多用户场景下的兼容性Android支持多用户主用户、访客用户、工作资料等。系统级别的默认设置有时只对主用户User 0生效。解决方案我们之前修改的defaults.xml和DatabaseHelper.java影响的是系统全局的默认值对新创建的用户是有效的。但是如果你需要确保在所有现有和未来的用户中搜狗输入法都是唯一选择可能需要更强大的手段。一种方法是在系统启动时通过一个守护进程或SettingsProvider的扩展监听用户切换事件然后通过ContentResolver调用Settings.Secure.putStringForUser()为每个用户都设置ENABLED_INPUT_METHODS。这属于高级定制在大多数只面向单用户的设备如专用终端、Kiosk模式设备上不需要。7. 验证与调试如何确认集成成功代码改完了系统也编译刷机了怎么知道一切是否按预期工作呢下面是一套我常用的验证流程。第一步检查应用是否安装为系统应用。连接设备ADB执行adb shell pm list packages | grep sogou adb shell pm path com.sohu.inputmethod.sogou第一条命令应输出包名第二条命令应显示APK的安装路径路径应该是以/system/或/vendor/开头证明它是系统应用。第二步检查输入法服务是否被系统识别。adb shell ime list -a输出中应该能看到com.sohu.inputmethod.sogou/.SogouIME并且状态可能是idxx这表示它已被系统输入法管理器InputMethodManager加载。第三步检查默认输入法设置。adb shell settings get secure default_input_method adb shell settings get secure enabled_input_methodsdefault_input_method应该显示为搜狗输入法的组件名。enabled_input_methods应该只包含搜狗输入法或者至少包含它。如果default_input_method为空可能是输入法切换逻辑有问题可以尝试用命令设置adb shell settings put secure default_input_method com.sohu.inputmethod.sogou/.SogouIME第四步实际使用测试。在设备的任何一个可以调出键盘的应用如浏览器、短信中点击输入框。观察弹出的键盘是否是搜狗输入法。键盘的布局、功能是否正常。中英文切换、语音输入如果有是否可用。长按输入框选择“输入法”看列表里是否只有搜狗输入法如果你移除了AOSP输入法。第五步压力与稳定性测试。快速在不同应用间切换频繁调出和收起键盘。让设备进入深度睡眠后再唤醒测试输入法是否能快速响应。观察内存占用确保输入法服务不会异常崩溃或重启。如果在验证过程中任何一步失败就需要根据错误现象回溯到前面的步骤进行排查。最常见的问题集中在APK签名、JNI库列表、默认设置写入以及APK与系统ABI的兼容性上。耐心地根据日志adb logcat | grep -i sogou或adb logcat | grep -i inputmethod和上述检查点进行调试总能找到问题所在。