Android软键盘输入imeOptions

android:imeOptions
根据输入框输入完成后要执行的业务逻辑指定软键盘右下角Action按钮的样式和行为，如让右下角按钮显示为“搜索”，点击后执行搜索逻辑。

imeOptions 有下面一些值：

IME_ACTION_UNSPECIFIED. 编辑器决定Action按钮的行为

IME_ACTION_GO Action按钮将作为 “开始” 按钮。点击后跳转到输入字符的意图页面 
IME_ACTION_SEARCH 执行“搜索”按钮。点击后跳转到输入字符的搜索结果页面 
IME_ACTION_SEND. 执行 “发送”按钮。点击后将输入字符发送给它的目标 
IME_ACTION_NEXT. Action按钮将作为next(下一个)按钮。点击后将进行下一个输入框的输入 
IME_ACTION_DONE. Action按钮将作为done(完成)按钮。点击后IME输入法将会关闭 
IME_ACTION_PREVIOUS. 作为”上一个”按钮。点击后将进行上一个输入框的输入 
IME_FLAG_NO_FULLSCREEN. 请求IME输入法永远不要进入全屏模式 
IME_FLAG_NAVIGATE_PREVIOUS. 类似IME_FLAG_NAVIGATE_NEXT， 表明这里有后退导航可以关注的兴趣点 
IME_FLAG_NAVIGATE_NEXT. 表明这里有前进导航可以关注的兴趣点，类似IME_ACTION_NEXT，不过允许IME输入多行且提供前进导航。 
IME_FLAG_NO_EXTRACT_UI. 请求IME输入法不要显示额外的文本UI 
IME_FLAG_NO_ACCESSORY_ACTION. 和一个Action结合使用表明在全屏输入法中不作为可访问性按钮 
IME_FLAG_NO_ENTER_ACTION. 多行文本将自动设置了该标志位，执行Action时为换行效果，如果未设置，IME输入法将把Enter按钮自动替换为Action按钮 
IME_FLAG_FORCE_ASCII. 请求IME输入法接受ASCII字符的输

注意
这里大部分ImeOptions的值都比较好理解，有下面几个值需要注意： 
通过一些bug案例来说明

IME_FLAG_NO_EXTRACT_UI
【bug】当时做一款输入法，从自定义假框切换回真框时，需要把自定义InputConnection切换回系统的InputConnection，这时需要恢复系统的imeOption，只恢复了低8位Action值，导致一些手机横屏后，弹出的软键盘没有候选栏，中文输入法无法使用。

原因：imeOption丢失高位上的值，UI相关信息丢失，InputMethodService中代码如下

 /**

   * Return whether the fullscreen extract view is shown.  This will only

   * return true if {@link #isFullscreenMode()} returns true, and in that

   * case its value depends on the last call to

   * {@link #setExtractViewShown(boolean)}.  This effectively lets you

   * determine if the application window is entirely covered (when this

   * returns true) or if some part of it may be shown (if this returns

   * false, though if {@link #isFullscreenMode()} returns true in that case

   * then it is probably only a sliver of the application).

   */

   public boolean isExtractViewShown() {

     return mIsFullscreen && !mExtractViewHidden;

   }

   void updateExtractFrameVisibility() {

    final int vis;

   if (isFullscreenMode()) {

   vis = mExtractViewHidden ? View.INVISIBLE : View.VISIBLE;

   // "vis" should be applied for the extract frame as well in the fullscreen mode.

    mExtractFrame.setVisibility(vis);

    } else {

     vis = View.VISIBLE;

     mExtractFrame.setVisibility(View.GONE);

   }

   // ...

  }

意思是，当全屏模式下有IME_FLAG_NO_EXTRACT_UI时，即mExtractViewHidden= true是cand候选栏的父Layout为INVISIBLE，

解决： 
可以在判断全屏模式时加一个变量控制

isNoExtractUI = (option & EditorInfo.IME_FLAG_NO_EXTRACT_UI) == EditorInfo.IME_FLAG_NO_EXTRACT_UI;
  @Override 
public final boolean onEvaluateFullscreenMode() {
     return (super.onEvaluateFullscreenMode() && (!isNoExtractUI)); 
  }

IME_FLAG_NO_ENTER_ACTION
【bug】 在备忘录输入文字后，按回车键，这时需要换行，但是输入法没有换行，而是收起输入键盘。

原因： 
EditText／TextView输入框默认是可以多行显示的，此时的右下角Action按钮只会作为换行按钮，无论你的imeOptions指定的是什么。 
原因是系统在onCreateInputConnection中设置了，代码如下：

if (isMultilineInputType(outAttrs.inputType)) {
     // Multi-line text editors should always show an enter key.
     outAttrs.imeOptions |= EditorInfo.IME_FLAG_NO_ENTER_ACTION;
 }
private static boolean isMultilineInputType(int type) {
      return (type & (EditorInfo.TYPE_MASK_CLASS | EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE)) ==
         (EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE);
  }

当EditText的inputType包含textMultiLine标志位，会强迫imeOptions加上IME_FLAG_NO_ENTER_ACTION位，这导致了只显示Enter键。

上面描述的与我出现bug正好相反，因为我对Action操作进行拦截了，定义了一些列的操作，当imeOptions有IME_FLAG_NO_ENTER_ACTION，应该执行回车操作，而实际执行了 
提交操作performEditorAction，收起输入面板

修改：

  // 多行文本换行问题
 boolean isNoEnter = (action & EditorInfo.IME_FLAG_NO_ENTER_ACTION) == EditorInfo.IME_FLAG_NO_ENTER_ACTION;

加一个isNoEnter变量，当isNoEnter = true时，不执行提交操作。

IME_FLAG_NAVIGATE_NEXT
【bug】在小米视频APP中，搜索框输入文本点击回车键，Action状态从“搜索”变成“回车”，却没有执行搜索功能，并且搜索框失去焦点

原因： 

imeOption值中包含了IME_FLAG_NAVIGATE_NEXT，表明这里有前进导航可以关注的兴趣点，代码逻辑在TextView.onCreateInputConnection

public InputConnection onCreateInputConnection(EditorInfo outAttrs) {

   if (focusSearch(FOCUS_DOWN) != null) {

        outAttrs.imeOptions |= EditorInfo.IME_FLAG_NAVIGATE_NEXT;

    }

    if (focusSearch(FOCUS_UP) != null) {

      outAttrs.imeOptions |= EditorInfo.IME_FLAG_NAVIGATE_PREVIOUS;

     }

    }
这里先获取当前焦点控件，然后根据direction获取下一个最佳的控件，获取控件后调用他的requestFocus,并给前面的焦点控件一个机会处理失去焦点事件，看一下focusSearch

   

public View focusSearch(@FocusRealDirection int direction) { 
       if (mParent != null) {    
       return mParent.focusSearch(this, direction);   
  } else {  
          return null;   
     }
   }

焦点丢失，搜索没有执行搜索，且搜索框失去焦点。

修改：

action = imeOption & EditorInfo.IME_MASK_ACTION
对imeOption取低8位执行搜索操作