Android爬坑之旅：软键盘挡住输入框问题的终极解决方式

阅读量：5229 次

发布时间：2019-06-14

本文共 6895 字，大约阅读时间需要 22 分钟。

本文由原创，同一时候首发于diycode.cc、barryzhang.com 、github.com/barryhappy。非商业转载请注明作者和原文链接。

前言

开发做得久了。总免不了会遇到各种坑。

而在Android开发的路上，『软键盘挡住了输入框』这个坑。可谓是一个旷日持久的巨坑——来来来。我们慢慢看。

入门篇

Base

最主要的情况，如图所看到的：在页面底部有一个EditText。假设不做不论什么处理，那么在软键盘弹出的时候，就有可能会挡住EditText。

对于这样的情况的处理事实上非常easy。仅仅须要在AndroidManifest文件里对activity设置：android:windowSoftInputMode的值adjustPan或者adjustResize就可以。像这样：

...

一般来说，他们都能够解决这个问题。当然。adjustPan跟adjustResize的效果略有差别。

adjustPan是把整个界面向上平移。使输入框露出。不会改变界面的布局；

adjustResize则是又一次计算弹出软键盘之后的界面大小，相当于是用更少的界面区域去显示内容。输入框一般自然也就在内了。

↑↑↑ OK，这仅仅是入门，基本上地球上全部的Androidproject师都能搞定。

别急，看以下~

加上WebView试试看？坑来了……

上面的入门篇中，软键盘是由原生的EditText触发弹出的。

而在H5、Hybrid差点儿已经成为App标配的时候。我们经常还会碰到的情况是：软键盘是由WebView中的网页元素所触发弹出的。

情况描写叙述

这时候，情况就会变得复杂了:

首先，页面是非全屏模式的情况下，给activity设置adjustPan会失效。

其次，页面是全屏模式的情况，adjustPan跟adjustResize都会失效。

——解释一下。这里的全屏模式即是页面是全屏的，包含Application或activity使用了Fullscreen主题、使用了『状态色着色』、『沉浸式状态栏』、『Immersive Mode』等等——总之，基本上仅仅要是App自己接管了状态栏的控制。就会产生这样的问题。

以下这个表格能够简单列举了详细的情况。

为什么说它是个坑？”issue 5497”

上面表格的这样的情况并非是Google所期望的，理想的情况当然是它们都能正常生效才对——所以这事实上是Android系统本身的一个BUG。

为什么文章开头说这是个坑呢？

——由于这个BUG从Android1.x时代（2009年）就被报告了，而一直到了现在的Android7.0（2016年）还是没有修复……/(ㄒoㄒ)/

能够说这不仅是个坑，并且还是个官方挖的坑~

“issue 5497”，详情传送门 ☞

当然了，无论坑是谁挖的，终于还是要开发人员来解决。

遇到坑之后。有两种方法能够过去：躲。或者填。

躲坑姿势

如前文所看到的。出现坑的条件是：带有WebView的activity使用了全屏模式或者adjustPan模式。

那么躲坑的姿势就非常easy了——

假设activity中有WebView，就不要使用全屏模式，并且把它的windowSoftInputMode值设为adjustResize就好了嘛

怎么样。是不是非常easy？��

填坑姿势

但总有些时候，是须要全屏模式跟WebView兼得的，这时候，躲坑就不行了，我们须要一个新的填坑的姿势。

幸好，开发人员的智慧是无穷的。这个坑出现了这么多年，还是有人找到了一些解决方式的。

AndroidBug5497Workaround

我个人觉得最好的解决方式是这个：，仅仅须要一个奇妙的AndroidBug5497Workaround类。

看名字就知道，它是专门用来对付”5497”问题的，使用步骤也是超级简单：

把AndroidBug5497Workaround类拷贝到项目中

在须要填坑的activity的onCreate方法中加入一句AndroidBug5497Workaround.assistActivity(this)就可以。

经过測试。基本在各个Android版本号上都可用。效果基本与设置了adjustResize相当。

看一个对照图：

来自我厂App的某个使用WebView的全屏模式Activity页面。从左到右各自是：没有软键盘的样式、软键盘挡住输入框的效果、以及使用AndroidBug5497Workaround之后的终于效果。

它的原理是什么？

这个炫酷AndroidBug5497Workaround类。事实上并非非常复杂，仅仅有几十行代码。先贴在这里：

public class AndroidBug5497Workaround {
          // For more information, see https://code.google.com/p/android/issues/detail?id=5497    // To use this class, simply invoke assistActivity() on an Activity that already has its content view set.    public static void assistActivity (Activity activity) {        new AndroidBug5497Workaround(activity);    }    private View mChildOfContent;    private int usableHeightPrevious;    private FrameLayout.LayoutParams frameLayoutParams;    private AndroidBug5497Workaround(Activity activity) {        FrameLayout content = (FrameLayout) activity.findViewById(android.R.id.content);        mChildOfContent = content.getChildAt(0);        mChildOfContent.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {            public void onGlobalLayout() {                possiblyResizeChildOfContent();            }        });        frameLayoutParams = (FrameLayout.LayoutParams) mChildOfContent.getLayoutParams();    }    private void possiblyResizeChildOfContent() {        int usableHeightNow = computeUsableHeight();        if (usableHeightNow != usableHeightPrevious) {            int usableHeightSansKeyboard = mChildOfContent.getRootView().getHeight();            int heightDifference = usableHeightSansKeyboard - usableHeightNow;            if (heightDifference > (usableHeightSansKeyboard/4)) {                // keyboard probably just became visible                frameLayoutParams.height = usableHeightSansKeyboard - heightDifference;            } else {                // keyboard probably just became hidden                frameLayoutParams.height = usableHeightSansKeyboard;            }            mChildOfContent.requestLayout();            usableHeightPrevious = usableHeightNow;        }    }    private int computeUsableHeight() {        Rect r = new Rect();        mChildOfContent.getWindowVisibleDisplayFrame(r);        return (r.bottom - r.top);// 全屏模式下： return r.bottom    }}

代码大致是做了这么几件事：

1.找到activity的根View

看一下入口的代码：

FrameLayout content = (FrameLayout) activity.findViewById(android.R.id.content);mChildOfContent = content.getChildAt(0);

当中，第一行中的android.R.id.content所指的View，是Android全部Activity界面上开发人员所能控制的区域的根View。

假设Activity是全屏模式，那么android.R.id.content就是占满全部屏幕区域的。

假设Activity是普通的非全屏模式。那么android.R.id.content就是占满除状态栏之外的全部区域。

其它情况，如Activity是弹窗、或者7.0以后的分屏样式等，android.R.id.content也是弹窗的范围或者分屏所在的半个屏幕——这些情况较少，就暂且不考虑了。

我们经经常使用的setContentView(View view)/setContent(int layRes)事实上就是把我们指定的View或者layRes放到android.R.id.content里面，成为它的子View。

所以，然后，第二行content.getChildAt(0)获取到的mChildOfContent，事实上也就是用以获取到我们用setContentView放进去的View。

2.设置一个Listener监听View树变化

mChildOfContent.getViewTreeObserver().addOnGlobalLayoutListener({ //简化了写法        possiblyResizeChildOfContent();});

View.getViewTreeObserver()能够获取一个ViewTreeObserver对象——这个对象是一个观察者，专门用以监听当前View树所发生的一些变化。

这里所注冊的addOnGlobalLayoutListener。就是会在当前的View树的全局布局（GlobalLayout）发生变化、或者当中的View可视状态有变化时，进行通知回调。

——『软键盘弹出』，则是会触发这个事件的一个源。 (软键盘弹出会使GlobalLayout发生变化)

也就是说，现在能监听到『软键盘弹出』的事件了。

3.界面变化之后，获取”可用高度”

当软键盘弹出了之后，接下来的事情是获取改变之后的界面的可用高度（能够被开发人员用以显示内容的高度）。

直接看代码：

private int computeUsableHeight() {        Rect rect = new Rect();        mChildOfContent.getWindowVisibleDisplayFrame(rect);        // rect.top事实上是状态栏的高度，假设是全屏主题，直接 return rect.bottom就能够了        return (rect.bottom - rect.top);    }

View.getWindowVisibleDisplayFrame(Rect rect)，这行代码能够获取到的Rect——就是界面除去了标题栏、除去了被软键盘挡住的部分，所剩下的矩形区域——如图所看到的。红框中的区域。

↑也能够看出：

rect.top值。事实上就是标题栏的高度。（实际上，这也经常被用作为获取标题栏高度的方法）

屏幕高度-rect.bottom。是软键盘的高度。（获取软键盘高度的方法也出现了）

这时，就有：

全屏模式下，可用高度 = rect.bottom

非全屏模式。可用高度 = rect.bottom - rect.top

4.最后一步，重设高度

我们计算出的可用高度，是眼下在视觉效果上能看到的界面高度。但当前界面的实际高度是比可用高度要多出一个软键盘的距离的。

所以，最后一步，就是把界面高度置为可用高度——大功告成。

private void possiblyResizeChildOfContent() {        int usableHeightNow = computeUsableHeight();        if (usableHeightNow != usableHeightPrevious) {            int usableHeightSansKeyboard = mChildOfContent.getRootView().getHeight();            int heightDifference = usableHeightSansKeyboard - usableHeightNow;            if (heightDifference > (usableHeightSansKeyboard/4)) {                // keyboard probably just became visible                frameLayoutParams.height = usableHeightSansKeyboard - heightDifference;            } else {                // keyboard probably just became hidden                frameLayoutParams.height = usableHeightSansKeyboard;            }            mChildOfContent.requestLayout();            usableHeightPrevious = usableHeightNow;        }    }

上面的代码里加入了一个”heightDifference > (usableHeightSansKeyboard/4)”的推断，这是为了去除无谓的干扰。

由于能触发OnGlobalLayout事件的原因有非常多。不止是软键盘的弹出变化，还包含各种子View的隐藏显示变化等，它们对界面高度的影响有限。加上了这个推断之后，仅仅有界面的高度变化超过1/4的屏幕高度。才会进行又一次设置高度，基本能保证代码仅仅响应软键盘的弹出。