Android软键盘的全面解析，让你不再怕控件被遮盖

本文转载自：https://blog.csdn.net/l540675759/article/details/74528641

背景

1.Android软键盘这块从我入职到现在，是一个一直纠缠我的问题。

2.从布局挤压，到EditText显示不全，在到弹出时卡顿，在Android软键盘面前我无数次跌倒。

3.因为网上大多数的知识点比较分散而且很杂，所以本篇做一个整合篇。

4.Android软键盘这块知识点比较密集，了解过一次之后，差不多什么情况都可以找到原因了。

5.感谢Android软键盘的问题，从我入职陪伴我到现在，让我一个一个不停的解决。

---

前言

本文将从以下几个方面进行介绍:

(1)InputMethodService的源码解析，从源码解读中告诉你为什么软键盘弹出的是一个Dialog

(2)Android软键盘显示时，设置windowSoftInputMode的作用

(3)EditText设置imeOptions属性对软键盘的影响

(4)软键盘上面的按键监听

(5)横屏状态下，不希望软键盘显示全屏怎么处理

(6)控制软键盘的弹出和关闭的方法

(7)EditText在软键盘弹出的时候显示不全，怎么获取软键盘弹出和关闭的监听

(8)软键盘弹出的时候，造成页面卡顿，这时候如何发现问题并解决问题

   
   
   
   


Android软键盘的显示原理

软键盘其实是一个Dialog

    InputMethodService为我们的输入法创建了一个Dialog，并且对某些参数进行了设置，使之能够在底部或者全屏显示。当我们点击输入框时，系统会对当前的主窗口进行调整，以便留出相应的空间来显示该Dialog在底部，或者全屏。

    其实这段话我们经常在各种软键盘博客所看到，但是大家并不知道Android是怎么为我们创建的这个Dialog，所以我先带大家来看下软键盘生成这块的源码，了解软键盘的生成流程。

   
   
   
   

InputMethodService的源码解析

我们先来看一下InputMethodService的继承关系：


因为InputMethodService属于服务，接下来我们先看一下服务的入口onCreate()方法：

    @Override 
    public void onCreate() {
        //设置主题与xml里面设置theme是一样的道理
        mTheme = Resources.selectSystemTheme(mTheme，
                getApplicationInfo().targetSdkVersion，
                android.R.style.Theme_InputMethod，
                android.R.style.Theme_Holo_InputMethod，
                android.R.style.Theme_DeviceDefault_InputMethod，
                android.R.style.Theme_DeviceDefault_InputMethod);
        super.setTheme(mTheme);
        //创建InputMethodMananger
        mImm = (InputMethodManager)getSystemService(INPUT_METHOD_SERVICE);
        mSettingsObserver = SettingsObserver.createAndRegister(this);
        mShouldClearInsetOfPreviousIme = (mImm.getInputMethodWindowVisibleHeight() > 0);
        mInflater = (LayoutInflater)getSystemService(
                Context.LAYOUT_INFLATER_SERVICE);
        /**
         * 这里注意一下，首先这里的命名属于Window，然后我们发现了Gravity.BOTTOM，就更加确定了这个就是
         * 软键盘所创建的Dialog对象
         */
        mWindow = new SoftInputWindow(this， "InputMethod"， mTheme， null， null， mDispatcherState，
                WindowManager.LayoutParams.TYPE_INPUT_METHOD， Gravity.BOTTOM， false);
        if (mHardwareAccelerated) {
            mWindow.getWindow().addFlags(WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);
        }
        initViews();
        mWindow.getWindow().setLayout(MATCH_PARENT， WRAP_CONTENT);
    }

通过上面的分析，我们怀疑这里的SoftInputWindow是软键盘弹出创建的Dialog对象，下面我们看下SoftInputWindow的源码。

public class SoftInputWindow extends Dialog{
    ....
}
     
     
     
     

     
     
     
     

stateUnspecified-不指定软键盘的状态（隐藏还是可见） 将由系统选择合适的状态，或依赖主题中的设置，这是对软键盘行为的默认设置

stateUnchanged-保留状态 当 Activity 转至前台时保留软键盘最后所处的任何状态，无论是可见还是隐藏

stateHidden-隐藏软键盘 当用户确实是向前导航到 Activity，而不是因离开另一Activity 而返回时隐藏软键盘

stateAlwaysHidden-始终隐藏软键盘 当 Activity 的主窗口有输入焦点时始终隐藏软键盘

stateVisible-显示软键盘 在正常的适宜情况下（当用户向前导航到 Activity 的主窗口时）显示软键盘

stateAlwaysVisible-显示软键盘 当用户确实是向前导航到 Activity，而不是因离开另一Activity 而返回时.

(2)在软键盘弹出时，是否需要Activity对此进行调整

   
   
   
   

   
   
   
   

还是同样的操作，点击最下面的EditText13

（1）设置windowSoftInputMode为adjustNoting

我们可以看出，当点击EditText12时，弹出软键盘将主窗口下半部分给遮盖，并且主窗口没有做出任何反应，和不加ScrollView是一样的情况。

（2）设置windowSoftInputMode为adjustResize

我们可以发现，当设置其属性为adjustResize时，当软键盘弹出时，ScrollView会重新绘制，然后滚动EditText13位置，使其显示在软键盘之上。

（3）设置windowSoftInputMode为adjustUnspecified

当设置其属性为默认属性adjustUnspecified时，可以发现在添加了ScrollView控件时，布局的窗口并不会上移（这个观察Toolbar就可以发现），而通过重绘ScrollView，让其滚动到最低端，并且给软键盘流出控件，而这个表现即和adjustResize完全一致。

（4）设置windowSoftInputMode为adjustPan

可以发现，在滑动空间下，设置属性adjustPan时，依旧会将主窗口上移，来使EditText13显示在软键盘之上，可以通过观察Toolbar得知。

windowSoftInputMode总结

通过上面的例子，我们可以完全理解adjust系列的各个参数的作用。而软键盘的显示和隐藏这里面需要并不多，而且内容并不算复杂，大家回去自己尝试下就可以。

---

EditText设置imeOptions属性对软键盘的影响

在日常开发中，如果需要将软键盘的Enter键更改为其他键，可以设置其android:imeOptions 属性，这个属性可以控制软键盘的Enter键，以及横屏情况下的软键盘显示状态。

该设置必须是下面所列的值之一，或者是一个“action…”值加上一个“flag…”值的组合，在action…组中设置多个值（例如，多个“action…”值）都会产生未定义结果，而flag….可以设置多个。各值之间使用垂直条 (|) 分隔

(1)控制软键盘上的Enter键

   
   
   
   

   
   
   
   

    
    
    
    
1
   
   
   
   

android:imeOptions=”normal”

当android:singleLine=”true”
输入框后面还有输入控件的时候会显示next，没有时会显示done(完成)
当android:singleLine=”false”
输入框会进行换行操作

android:imeOptions=”actionUnspecified”

该属性为默认属性，一般情况下为“normal”的使用情形。

android:imeOptions=”actionNone”

显示回车键，当singleLine为true的时候，会跳到下个可输出的控件，否则软键盘消失，输入完毕。

android:imeOptions=”actionGo”

显示为Go(前往)按钮，需要配合android:singleLine使用，否则为回车键起换行作用，并且需要自己写事件。

android:imeOptions=”actionSearch”

显示搜索（Search）按钮，需要配合android:singleLine使用，否则为回车键起换行作用，并且需要自己写事件。

android:imeOptions=”actionSend”

显示send(发送)按钮，需要配合android:singleLine使用，否则为回车键起换行作用，并且需要自己写事件。

android:imeOptions=”actionNext”

显示next(下一步)按钮，作用是跳到下一个可输入的控件，需要配合android:singleLine使用，否则为回车键起换行作用。

android:imeOptions=”actionDone”

显示done(完成)按钮，作用编辑完成，让软键盘消失.需要配合android:singleLine使用，否则为回车键起换行作用。

android:imeOptions=”actionPrevious”

显示上一步按钮，如果前面有输入控件，点击后会回到前一个控件获取焦点，.需要配合android:singleLine使用，否则为回车键起换行作用。

可能各个输入法的显示图标不一样，但是效果是一样的，这里用的是搜狗输入法。

(2)横屏下控制软键盘

   
   
   
   

   
   
   
   

而如果对于这一块有什么不明白的，可以参考这篇博客。

Android手动显示和隐藏软键盘方法总结

实际案例3：EditText显示不全，并且需要监听软键盘弹出和关闭

现在有一个常见的需求，EditText被布局包裹，然后需要将原生的EditText背景给替换掉或者直接设置为null（或者其他），然后和布局上下存在间距，然后整体与底部对齐。

这时候弹出软键盘，请看图：

从图中可以发现，当原生的EditText背景被替换之后，软键盘会遮盖掉自定义区域，并且直接显示在EditText之下，正常情况下，我们是希望软键盘显示在整个外层的Layout之下的。

当时对于这个问题，我没有头绪好一阵子，现在来看，那时候挺年轻的。

而这个问题，就属于软键盘遮挡布局的问题：

引用块内容

(1)软键盘遮盖焦点：

当软键盘弹出的时候，将EditText等输入类的控件的焦点遮盖时，这时候可以设置adjustPan或者adjustResize可以很好的解决。

这里如果理解好本博文第一块内容就能很好解决这个问题。

(2)软键盘遮盖没有遮盖焦点，但是遮盖了需要显示的控件：

这时候设置通过设置属性adjustPan或者adjustResize还不足以解决问题，因为软键盘并没有遮盖了EditText的焦点，所以单独设置这两个属性是对软键盘或者界面是无法产生改变的。

这时我们必须从另外一个角度来考虑这个问题，就是来监听软键盘的弹出和关闭来操作布局，来解决这个问题。

这时候普遍会有以下的几种解决方案：

(1)设置adjustResize属性，当软键盘弹出的时候会重绘布局，然后设置根布局的OnLayoutChangeListener的监听，来监听布局的变化。

 mScrollView.addOnLayoutChangeListener(new View.OnLayoutChangeListener() {
 @Override
 public void onLayoutChange(View v， int left， int top， int right， int bottom， int oldLeft， int oldTop， int oldRight， int oldBottom) {
                Log.d("new change "， "left : " + left + "top : " + top + "right : " + right + "bottom : " + bottom);
                Log.d("old change "， "oldLeft : " + oldLeft + "oldTop : " + oldTop + "oldRight : " + oldRight + "oldBottom : " + oldBottom);
            }
        });

//当软键盘弹出
07-09 21:16:22.911 23653-23653/com.xiucai.softdemo D/new change: left : 0top : 0right : 1080bottom : 817
07-09 21:16:22.911 23653-23653/com.xiucai.softdemo D/old change: oldLeft : 0oldTop : 0oldRight : 1080oldBottom : 1692

//当软键盘关闭
07-09 21:16:44.457 23653-23653/com.xiucai.softdemo D/new change: left : 0top : 0right : 1080bottom : 1692
07-09 21:16:44.457 23653-23653/com.xiucai.softdemo D/old change: oldLeft : 0oldTop : 0oldRight : 1080oldBottom : 817
   
   
   
   

   
   
   
   

上面代码是借鉴android 解决输入法键盘遮盖布局问题 这篇文章而来，目的让大家了解这种方式是怎么判断软键盘的弹出和隐藏。

里面需要平移的View，不一定是ScrollView，其他View也可，一般来说作为XML的根布局即可。

平常一般来说，我会使用这个工具类

package com.xiucai.common.manager;

import android.graphics.Rect;
import android.util.Log;
import android.view.View;
import android.view.ViewTreeObserver;

import java.util.LinkedList;
import java.util.List;

/**
 * Created by SuperD on 2017/5/12.
 */

public class SoftKeyBroadManager  implements ViewTreeObserver.OnGlobalLayoutListener{

    public interface SoftKeyboardStateListener {
        void onSoftKeyboardOpened(int keyboardHeightInPx);

        void onSoftKeyboardClosed();
    }

    private final List listeners = new LinkedList();
    private final View activityRootView;
    private int lastSoftKeyboardHeightInPx;
    private boolean isSoftKeyboardOpened;

    public SoftKeyBroadManager(View activityRootView) {
        this(activityRootView， false);
    }

    public SoftKeyBroadManager(View activityRootView， boolean isSoftKeyboardOpened) {
        this.activityRootView = activityRootView;
        this.isSoftKeyboardOpened = isSoftKeyboardOpened;
        activityRootView.getViewTreeObserver().addOnGlobalLayoutListener(this);
    }

    @Override
    public void onGlobalLayout() {
        final Rect r = new Rect();
        //r will be populated with the coordinates of your view that area still visible.
        activityRootView.getWindowVisibleDisplayFrame(r);

        final int heightDiff = activityRootView.getRootView().getHeight() - (r.bottom - r.top);
        Log.d("SoftKeyboardStateHelper"， "heightDiff:" + heightDiff);
        if (!isSoftKeyboardOpened && heightDiff > 500) { // if more than 100 pixels， its probably a keyboard...
            isSoftKeyboardOpened = true;
            notifyOnSoftKeyboardOpened(heightDiff);
            //if (isSoftKeyboardOpened && heightDiff < 100)
        } else if (isSoftKeyboardOpened && heightDiff < 500) {
            isSoftKeyboardOpened = false;
            notifyOnSoftKeyboardClosed();
        }
    }

    public void setIsSoftKeyboardOpened(boolean isSoftKeyboardOpened) {
        this.isSoftKeyboardOpened = isSoftKeyboardOpened;
    }

    public boolean isSoftKeyboardOpened() {
        return isSoftKeyboardOpened;
    }

    /**
     * Default value is zero (0)
     *
     * @return last saved keyboard height in px
     */
    public int getLastSoftKeyboardHeightInPx() {
        return lastSoftKeyboardHeightInPx;
    }

    public void addSoftKeyboardStateListener(SoftKeyboardStateListener listener) {
        listeners.add(listener);
    }

    public void removeSoftKeyboardStateListener(SoftKeyboardStateListener listener) {
        listeners.remove(listener);
    }

    private void notifyOnSoftKeyboardOpened(int keyboardHeightInPx) {
        this.lastSoftKeyboardHeightInPx = keyboardHeightInPx;

        for (SoftKeyboardStateListener listener : listeners) {
            if (listener != null) {
                listener.onSoftKeyboardOpened(keyboardHeightInPx);
            }
        }
    }

    private void notifyOnSoftKeyboardClosed() {
        for (SoftKeyboardStateListener listener : listeners) {
            if (listener != null) {
                listener.onSoftKeyboardClosed();
            }
        }
    }
}

   
   
   
   

   
   
   
   

最后如果感觉上面的方案不可行，Github也有一个现成方案，但是博主本人没试过，原理都是一样的。大家可以自行取舍。

Github软键盘监听的工具类

知乎上讨论软键盘的文章

---

实际案例4： 软键盘弹出来卡顿，找不到原因?

正常来说博文实差不多到这里就应该结束了，但是博主在实际开发中，也会遇到一些诡异的现象，例如软键盘弹出卡顿，但是这种情况下，根本无法定位到卡顿原因。

博主遇到这个问题时，怀疑了设置属性错误，怀疑了线程XX没关，怀疑了布局太过于复杂，总之该想的博主都想了，但是无论怎么试都是徒劳的。

因为博主犯了一个大错

在没找到原因之前，胡乱猜测，可能是这块?是不是那个的问题，而不确定问题的来源这个问题我感觉大家都会遇到，不从事情的本质上下手，这样会多花很多时间用在无用的地方，使自己的开发效率很低。

推荐一款检测卡顿的神器BlockCanary

还原下我当时遇到的问题：

当时我在做一个直播间的功能，直播间从主页跳转进入的，给大家截一张图，大家就懂了。

当时做直播间其他功能的时，发现直播间软键盘在弹出和关闭的时候卡顿。

当时怀疑：

(1)什么动画没停，什么线程没关。

(2)软键盘 弹出的时候是不是加载的布局太多.

(3)直播间的布局太过于复杂，导致软键盘弹出时绘制卡顿。

在长期的测试发现一个现象，就是在高端机型上这种状态不明显，而在底端机型问题比较严重，有时候弹出软键盘卡顿很长时间。

过了半个月博主思路换了，想想软键盘弹出卡顿，能不能从卡顿原因下手，来解决问题，后来找到了BlockCanary，接入使用后发现：

原因：
竟然是 主页在软键盘每次弹出或者关闭的时候重新绘制.因为当时BlockCanary当时指向主页的RecyclerView重绘，我当时想是不可能的.
   
   
   
   

   
   
   
   



    
    
    
    
最后，博主凭直觉认为和主页SingleTask有关，因为没有确切的理由，这里只是提出自己的观点，而最后问题也解决了。

    
    
    
    
如果没有BlockCanary我永远发现不了，卡顿的原因是在看不见的主页。

    
    
    
    
后来我给主页设置成adjustNothing因为主页不需要弹出软键盘。

    
    
    
    


    
    
    
    
实际案例5：Android键盘面板冲突，布局闪动的解决方法


    
    
    
    
这个问题是我在找Android软键盘相关的问题的时候发现的，这块我也没遇到这个问题，所以给大家两个相关的介绍的地址，希望能对大家有帮助。


    
    
    
    



    
    
    
    



    
    
    
    
解决Android软键盘，布局闪动的相关博文


    
    
    
    
解决Android软键盘布局闪动的Demo


    
    
    
    
开源的Android软键盘布局闪动的解决方案


    
    
    
    





    
    
    
    
总结


    
    
    
    
(1)第一次写这么长的博客，感觉会有一些不足，各位看官如果有不合理的地方，或者有误的地方请直接指出。


    
    
    
    
(2)本来想整理成一个Demo的，后来简单看来下，该有的几乎都贴出来了，有需要的可以按需复制就可以。


    
    
    
    
(3)写完这篇博客之后，感觉博客干货还是不多，所以定位这篇文章算是总结性质加上实际案例性质的博客。


    
    
    
    
(4)Android软键盘的总结就差不多到这里，希望各位看官，如果看到这里有收获，就点点赞，灌灌水，顶一波，这样博主才有写下去的动力。

    
    
    
    
(5)感谢小辉同学的校验，调整了文章中不通顺的地方。

    
    
    
    


    
    
    
    
参考文档

    
    
    
    
1.彻底搞定Android开发中软键盘的常见问题
http://blog.csdn.net/mynameishuangshuai/article/details/51567357
2.Android UI(EditText)详解
http://blog.csdn.net/qq_28057577/article/details/51919965?locationNum=12&fps=1
3.微信软键盘布局闪动问题
https://blog.dreamtobe.cn/2015/09/01/keyboard-panel-switch/