Android 12及以上版本自定义输入法（InputMethodService）候选视图不显示

检查布局参数与视图加载逻辑 #

• 确认候选视图的android:layout_height未设置为wrap_content或0dp，Android 12+对输入法视图测量逻辑有调整，建议显式设置固定高度（如48dp）或合理的自适应高度。
• 确保正确实现onCreateCandidateView()方法，Android 12后系统更依赖此方法加载候选视图，避免仅在输入视图中嵌套候选区域；若之前用嵌套方式，改为单独返回候选视图实例。
• 输入状态变化（如输入字符后）主动调用setCandidateViewShown(true)，Android 12+不会自动触发候选视图显示。

验证视图可见性与绘制状态 #

• 在候选视图的onDraw()中添加日志，确认是否触发绘制逻辑；若未触发，检查视图是否被正确添加到输入法窗口。
• 排查代码中是否意外将候选视图设为GONE或INVISIBLE，确保setVisibility(View.VISIBLE)在合适时机调用。

适配系统权限与服务配置 #

• 确认Manifest中已声明android.permission.INPUT_METHOD，且输入法服务声明正确：

  <service
      android:name=".YourInputMethodService"
      android:permission="android.permission.BIND_INPUT_METHOD">
      <meta-data
          android:name="android.view.im"
          android:resource="@xml/method"/>
      <intent-filter>
          <action android:name="android.view.InputMethod"/>
      </intent-filter>
  </service>
  

• 在onStartInput()回调中初始化候选数据并显示视图，onFinishInput()中做必要的资源释放，确保生命周期逻辑正确。

排查视图层级冲突 #

• 用Android Studio的Layout Inspector查看输入法窗口视图层级，确认候选视图是否存在、是否被其他视图（如输入框、导航栏）遮挡。
• 暂时移除表情面板、工具栏等自定义组件，仅保留候选视图，排查是否为视图叠加导致的显示问题。

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