核心判断 #

这个问题是API 34（Android 14）及以上版本的输入法适配问题，而非Wear OS的系统限制——毕竟API 34以下版本能正常显示，说明系统本身允许第三方键盘出现在Gboard的选择列表里。

具体排查点 #

• 核对输入法服务的权限声明
  Android 14收紧了输入法的权限要求，务必在AndroidManifest.xml里正确配置服务权限：

  <service
      android:name=".YourInputMethodService"
      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/method" />
  </service>
  

  这里的android:permission必须是android.permission.BIND_INPUT_METHOD，不能用旧的权限值。

• 检查输入法元数据完整性
  确认res/xml/method.xml的配置是否符合API 34+的要求，尤其是子类型和设置页的声明：

  <input-method xmlns:android="http://schemas.android.com/apk/res/android">
      <subtype
          android:label="@string/subtype_label"
          android:imeSubtypeMode="keyboard"
          android:imeSubtypeLocale="en_US" />
      <settings android:activity=".SettingsActivity" />
  </input-method>
  

  缺失关键字段可能导致Gboard无法识别你的输入法。

• 验证服务注册逻辑
  Android 14对输入法服务的启动和注册逻辑有新限制，在InputMethodService的onCreate方法中添加日志，确认服务是否正常被系统初始化并注册。如果服务被后台限制，也可能导致Gboard看不到它。

• 排查Gboard版本问题
  部分新版Gboard在Wear OS上可能调整了第三方键盘的筛选规则，试试降级Gboard到API 34刚发布时的版本，看是否能正常显示，排除Gboard自身的适配bug。

结论 #

先从API 34+的权限、配置适配入手解决，系统限制的概率极低——低版本API的正常表现已经说明系统框架支持第三方键盘出现在该选择列表中。

内容的提问来源于stack exchange，提问作者Taeun Park