├── .gitignore
├── .idea
├── .name
├── codeStyles
│ ├── Project.xml
│ └── codeStyleConfig.xml
├── gradle.xml
├── misc.xml
├── runConfigurations.xml
└── vcs.xml
├── app
├── .gitignore
├── build.gradle
├── proguard-rules.pro
└── src
│ ├── androidTest
│ └── java
│ │ └── com
│ │ └── example
│ │ └── myapplication
│ │ └── ExampleInstrumentedTest.kt
│ ├── main
│ ├── AndroidManifest.xml
│ ├── java
│ │ └── com
│ │ │ └── example
│ │ │ └── myapplication
│ │ │ └── MainActivity.kt
│ └── res
│ │ ├── drawable-v24
│ │ └── ic_launcher_foreground.xml
│ │ ├── drawable
│ │ └── ic_launcher_background.xml
│ │ ├── layout
│ │ └── activity_main.xml
│ │ ├── mipmap-anydpi-v26
│ │ ├── ic_launcher.xml
│ │ └── ic_launcher_round.xml
│ │ ├── mipmap-hdpi
│ │ ├── ic_launcher.png
│ │ └── ic_launcher_round.png
│ │ ├── mipmap-mdpi
│ │ ├── ic_launcher.png
│ │ └── ic_launcher_round.png
│ │ ├── mipmap-xhdpi
│ │ ├── ic_launcher.png
│ │ └── ic_launcher_round.png
│ │ ├── mipmap-xxhdpi
│ │ ├── ic_launcher.png
│ │ └── ic_launcher_round.png
│ │ ├── mipmap-xxxhdpi
│ │ ├── ic_launcher.png
│ │ └── ic_launcher_round.png
│ │ └── values
│ │ ├── colors.xml
│ │ ├── strings.xml
│ │ └── styles.xml
│ └── test
│ └── java
│ └── com
│ └── example
│ └── myapplication
│ └── ExampleUnitTest.kt
├── build.gradle
├── gradle.properties
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── image1.jpeg
├── image2.gif
├── image3.gif
├── image4.gif
├── readme.md
└── settings.gradle
/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | .gradle
3 | /local.properties
4 | /.idea/caches
5 | /.idea/libraries
6 | /.idea/modules.xml
7 | /.idea/workspace.xml
8 | /.idea/navEditor.xml
9 | /.idea/assetWizardSettings.xml
10 | .DS_Store
11 | /build
12 | /captures
13 | .externalNativeBuild
14 | .cxx
15 |
--------------------------------------------------------------------------------
/.idea/.name:
--------------------------------------------------------------------------------
1 | My Application
--------------------------------------------------------------------------------
/.idea/codeStyles/Project.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 | xmlns:android
17 |
18 | ^$
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 | xmlns:.*
28 |
29 | ^$
30 |
31 |
32 | BY_NAME
33 |
34 |
35 |
36 |
37 |
38 |
39 | .*:id
40 |
41 | http://schemas.android.com/apk/res/android
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 | .*:name
51 |
52 | http://schemas.android.com/apk/res/android
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 | name
62 |
63 | ^$
64 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 | style
73 |
74 | ^$
75 |
76 |
77 |
78 |
79 |
80 |
81 |
82 |
83 | .*
84 |
85 | ^$
86 |
87 |
88 | BY_NAME
89 |
90 |
91 |
92 |
93 |
94 |
95 | .*
96 |
97 | http://schemas.android.com/apk/res/android
98 |
99 |
100 | ANDROID_ATTRIBUTE_ORDER
101 |
102 |
103 |
104 |
105 |
106 |
107 | .*
108 |
109 | .*
110 |
111 |
112 | BY_NAME
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
--------------------------------------------------------------------------------
/.idea/codeStyles/codeStyleConfig.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/.idea/gradle.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
19 |
20 |
--------------------------------------------------------------------------------
/.idea/misc.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/.idea/runConfigurations.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
11 |
12 |
--------------------------------------------------------------------------------
/.idea/vcs.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/app/build.gradle:
--------------------------------------------------------------------------------
1 | apply plugin: 'com.android.application'
2 | apply plugin: 'kotlin-android'
3 | apply plugin: 'kotlin-android-extensions'
4 |
5 | android {
6 | compileSdkVersion 'android-R'
7 | buildToolsVersion "29.0.2"
8 |
9 | defaultConfig {
10 | applicationId "com.example.myapplication"
11 | minSdkVersion 'R'
12 | targetSdkVersion 'R'
13 | versionCode 1
14 | versionName "1.0"
15 |
16 | testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
17 | }
18 |
19 | buildTypes {
20 | release {
21 | minifyEnabled false
22 | proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
23 | }
24 | }
25 | compileOptions {
26 | sourceCompatibility = 1.8
27 | targetCompatibility = 1.8
28 | }
29 |
30 | }
31 |
32 | dependencies {
33 | implementation fileTree(dir: 'libs', include: ['*.jar'])
34 | implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
35 | implementation 'androidx.appcompat:appcompat:1.1.0'
36 | implementation 'androidx.core:core-ktx:1.2.0'
37 | implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
38 | testImplementation 'junit:junit:4.12'
39 | androidTestImplementation 'androidx.test.ext:junit:1.1.1'
40 | androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
41 | }
42 |
--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # You can control the set of applied configuration files using the
3 | # proguardFiles setting in build.gradle.
4 | #
5 | # For more details, see
6 | # http://developer.android.com/guide/developing/tools/proguard.html
7 |
8 | # If your project uses WebView with JS, uncomment the following
9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | # public *;
13 | #}
14 |
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 |
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
22 |
--------------------------------------------------------------------------------
/app/src/androidTest/java/com/example/myapplication/ExampleInstrumentedTest.kt:
--------------------------------------------------------------------------------
1 | package com.example.myapplication
2 |
3 | import androidx.test.platform.app.InstrumentationRegistry
4 | import androidx.test.ext.junit.runners.AndroidJUnit4
5 |
6 | import org.junit.Test
7 | import org.junit.runner.RunWith
8 |
9 | import org.junit.Assert.*
10 |
11 | /**
12 | * Instrumented test, which will execute on an Android device.
13 | *
14 | * See [testing documentation](http://d.android.com/tools/testing).
15 | */
16 | @RunWith(AndroidJUnit4::class)
17 | class ExampleInstrumentedTest {
18 | @Test
19 | fun useAppContext() {
20 | // Context of the app under test.
21 | val appContext = InstrumentationRegistry.getInstrumentation().targetContext
22 | assertEquals("com.example.myapplication", appContext.packageName)
23 | }
24 | }
25 |
--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
12 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
--------------------------------------------------------------------------------
/app/src/main/java/com/example/myapplication/MainActivity.kt:
--------------------------------------------------------------------------------
1 | package com.example.myapplication
2 |
3 | import android.os.Bundle
4 | import android.os.Looper
5 | import android.util.Log
6 | import android.view.View
7 | import android.view.ViewGroup
8 | import android.view.WindowInsets
9 | import android.view.WindowInsetsAnimation
10 | import androidx.appcompat.app.AppCompatActivity
11 | import androidx.core.view.updateLayoutParams
12 | import androidx.core.view.updateMargins
13 | import kotlinx.android.synthetic.main.activity_main.*
14 |
15 |
16 | class MainActivity : AppCompatActivity() {
17 | private val TAG = "MainActivity"
18 | override fun onCreate(savedInstanceState: Bundle?) {
19 | super.onCreate(savedInstanceState)
20 | window.setDecorFitsSystemWindows(false)
21 | setContentView(R.layout.activity_main)
22 | content.postDelayed({
23 | content.windowInsetsController?.hide(WindowInsets.Type.navigationBars())
24 | },5000)
25 | content.setOnApplyWindowInsetsListener { view, windowInsets ->
26 | val statusBars = windowInsets.getInsets(WindowInsets.Type.statusBars())
27 | // It's also possible to use multiple types
28 | val insets = windowInsets.getInsets(WindowInsets.Type.navigationBars())
29 | val insets2 = windowInsets.getInsets(WindowInsets.Type.ime())
30 | Log.e(
31 | TAG, "navigationBars:" + insets.top + " " + insets.bottom +
32 | " " + windowInsets.isVisible(WindowInsets.Type.navigationBars())
33 | )
34 | Log.e(TAG, "statusBars:" + statusBars.top + " " + statusBars.bottom)
35 | Log.e(TAG, "insets2:" + insets2.top + " " + insets2.bottom)
36 | findViewById(android.R.id.content).setPadding(0, 0, 0, insets.bottom)
37 | windowInsets
38 | }
39 | val callback = object : WindowInsetsAnimation.Callback(DISPATCH_MODE_CONTINUE_ON_SUBTREE) {
40 | override fun onProgress(
41 | insets: WindowInsets,
42 | animations: MutableList
43 | ): WindowInsets {
44 | val navigationBars = insets.getInsets(WindowInsets.Type.navigationBars())
45 | val ime = insets.getInsets(WindowInsets.Type.ime())
46 | Log.e(
47 | TAG, "ime:" + ime.top +
48 | " " + ime.bottom
49 | )
50 | val parmas = (content.layoutParams as ViewGroup.MarginLayoutParams)
51 | parmas.bottomMargin = ime.bottom - navigationBars.bottom
52 | content.layoutParams = parmas
53 | return insets
54 | }
55 |
56 | override fun onStart(
57 | animation: WindowInsetsAnimation,
58 | bounds: WindowInsetsAnimation.Bounds
59 | ): WindowInsetsAnimation.Bounds {
60 | Log.e(
61 | TAG,
62 | "start lowerBound:" + bounds.lowerBound.top + " " + bounds.lowerBound.bottom
63 | )
64 | Log.e(
65 | TAG,
66 | "start upperBound:" + bounds.upperBound.top + " " + bounds.upperBound.bottom
67 | )
68 | Log.e(TAG, "start time:" + animation.durationMillis)
69 | return super.onStart(animation, bounds)
70 | }
71 |
72 | override fun onEnd(animation: WindowInsetsAnimation) {
73 | Log.e(TAG, "end:" + animation.durationMillis)
74 | super.onEnd(animation)
75 | }
76 |
77 | override fun onPrepare(animation: WindowInsetsAnimation) {
78 | Log.e(TAG, "onPrepare:" + animation.durationMillis)
79 | super.onPrepare(animation)
80 | }
81 |
82 | }
83 | content.setWindowInsetsAnimationCallback(callback)
84 | }
85 | }
86 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable-v24/ic_launcher_foreground.xml:
--------------------------------------------------------------------------------
1 |
7 |
8 |
9 |
15 |
凡是搞过键盘的同学都知道，监听 Android 键盘的高度非常复杂，网上的一些黑科技也只对某些场景，有些场景就是无法处理。
10 |
而且有一个非常关键的点：键盘只有完全弹出来了才知道高度，当我们想根据键盘的上升做一个动画时，就很难做到-无法知道键盘动画的时间和最终高度
11 |
12 | 我们来看看官方给的效果图：
13 |
14 | 
15 |
16 | 话不多说，我们来测试一下
17 |
18 | ## 测试
19 | ### 引入
20 | 1. 前期准备
21 |
先将 Android Studio 和 Gradle， Android SDK 更新到最新, 我的版本分别是：
22 | Android Studio 3.6.1， Gradle 5.6.4, Android SDK R
23 |
24 |
有 Pixel 手机的直接更新到最新版本 Q ，没有的可以下载最新的 Q 镜像
25 |
26 | 2. 更新 gradle 配置
27 |
28 | ```groovy
29 | android {
30 | compileSdkVersion 'android-R'
31 | buildToolsVersion "29.0.2"
32 |
33 | defaultConfig {
34 | applicationId "com.example.myapplication"
35 | minSdkVersion 'R'
36 | targetSdkVersion 'R'
37 | versionCode 1
38 | versionName "1.0"
39 |
40 | testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
41 | }
42 |
43 | //....
44 |
45 | }
46 | ```
47 |
48 | ### 使用
49 | 1. 先设置 FitSystemWindows 为 false：
50 |
51 | ```kotlin
52 | //非常重要，没有这句话监听无法生效
53 | window.setDecorFitsSystemWindows(false)
54 | ```
55 |
56 | 2. 再对 view 设置监听：
57 |
58 | ```kotlin
59 | class MainActivity : AppCompatActivity() {
60 |
61 | override fun onCreate(savedInstanceState: Bundle?) {
62 | super.onCreate(savedInstanceState)
63 | //非常重要，没有这句话监听无法生效
64 | window.setDecorFitsSystemWindows(false)
65 | setContentView(R.layout.activity_main)
66 | val callback = object : WindowInsetsAnimation.Callback(DISPATCH_MODE_CONTINUE_ON_SUBTREE) {
67 | override fun onProgress(
68 | insets: WindowInsets,
69 | animations: MutableList
70 | ): WindowInsets {
71 | Log.e("MainActivity", "ime:" + insets.getInsets(WindowInsets.Type.ime()).top +
72 | " " + insets.getInsets(WindowInsets.Type.ime()).bottom)
73 | return insets
74 | }
75 | }
76 | content.setWindowInsetsAnimationCallback(callback)
77 | }
78 | }
79 | ```
80 |
81 | 运行结果：
82 |
83 | ```
84 | MainActivity: ime:0 0
85 | MainActivity: ime:0 0
86 | MainActivity: ime:0 9
87 | MainActivity: ime:0 37
88 | MainActivity: ime:0 98
89 | MainActivity: ime:0 207
90 | MainActivity: ime:0 351
91 | MainActivity: ime:0 526
92 | MainActivity: ime:0 684
93 | MainActivity: ime:0 799
94 | MainActivity: ime:0 895
95 | MainActivity: ime:0 1020
96 | MainActivity: ime:0 1062
97 | MainActivity: ime:0 1095
98 | MainActivity: ime:0 1117
99 | MainActivity: ime:0 1134
100 | MainActivity: ime:0 1146
101 | MainActivity: ime:0 1152
102 | MainActivity: ime:0 1155
103 | ```
104 |
105 | 可以看到很清晰的打印出了键盘的每一帧高度，这样我们就可以根据高度回调，实现文章开头的效果
106 |
107 | 对比微信键盘弹出和 Android Q 的键盘弹出，可以看到微信的上升和下降，都不是完全吻合，但是 Android Q 一直是稳稳的贴着：
108 |
109 | 
110 |
111 | ### 详细代码
112 |
113 |
114 | ```kotlin
115 | class MainActivity : AppCompatActivity() {
116 | override fun onCreate(savedInstanceState: Bundle?) {
117 | super.onCreate(savedInstanceState)
118 | //非常重要，没有这句话监听无法生效
119 | window.setDecorFitsSystemWindows(false)
120 | setContentView(R.layout.activity_main)
121 | val callback = object : WindowInsetsAnimation.Callback(DISPATCH_MODE_CONTINUE_ON_SUBTREE) {
122 | override fun onProgress(
123 | insets: WindowInsets,
124 | animations: MutableList
125 | ): WindowInsets {
126 | val navigationBars = insets.getInsets(WindowInsets.Type.navigationBars())
127 | val ime = insets.getInsets(WindowInsets.Type.ime())
128 | Log.e(
129 | TAG, "ime:" + ime.top +
130 | " " + ime.bottom
131 | )
132 | val parmas = (content.layoutParams as ViewGroup.MarginLayoutParams)
133 | parmas.bottomMargin = ime.bottom - navigationBars.bottom
134 | content.layoutParams = parmas
135 | return insets
136 | return insets
137 | }
138 | }
139 | content.setWindowInsetsAnimationCallback(callback)
140 | }
141 | }
142 | ```
143 |
144 | ## 分析
145 |
146 | 除了上面例子用到的 onProgress() 方法，WindowInsetsAnimation.Callback 还有其他的属性和方法值得关注：
147 |
148 | 1. 分发方式
149 |
150 | 构造 WindowInsetsAnimation.Callback(int) 传入一个int 值表示分发方式，目前有两个值：
151 |
152 | * DISPATCH_MODE_CONTINUE_ON_SUBTREE ：继续分发动画事件
153 | * DISPATCH_MODE_STOP ：不再分发
154 |
155 | 这两个值和 view 的事件分发很类似，这里就不多解释了。
156 |
157 | 2. 键盘弹出的开始和结束
158 |
159 | 假设需求仅仅是想获取键盘的高度，不需要实时获取高度变化，可以重写 start() 方法
160 |
161 | ```kotlin
162 | val callback = object : WindowInsetsAnimation.Callback(DISPATCH_MODE_CONTINUE_ON_SUBTREE) {
163 | override fun onStart(
164 | animation: WindowInsetsAnimation,
165 | bounds: WindowInsetsAnimation.Bounds
166 | ): WindowInsetsAnimation.Bounds {
167 | Log.e(TAG,"start lowerBound:" + bounds.lowerBound.top + " " + bounds.lowerBound.bottom)
168 | Log.e( TAG,"start upperBound:" + bounds.upperBound.top + " " + bounds.upperBound.bottom)
169 | Log.e(TAG, "start time:" + animation.durationMillis)
170 | return super.onStart(animation, bounds)
171 | }
172 | }
173 | ```
174 |
175 | 其中 bounds 表示目标对象，从里面可以拿到动画结束后键盘有多高。
176 |
animation 中可以获取动画的执行时间，透明度等等。
177 |
178 | ## 导航栏，状态栏高度和状态
179 |
180 | 获取高度之前先来了解一下 WindowInsets.Type 有什么类型，上面我们用到了 ime() 是键盘，除了键盘，还有其他的类型，包括：
181 |
182 | ```
183 | android.view.WindowInsets.Type.STATUS_BARS, //状态栏
184 | android.view.WindowInsets.Type.NAVIGATION_BARS, //导航栏
185 | android.view.WindowInsets.Type.CAPTION_BAR,
186 | android.view.WindowInsets.Type.IME, //键盘
187 | android.view.WindowInsets.Type.WINDOW_DECOR,
188 | android.view.WindowInsets.Type.SYSTEM_GESTURES,
189 | android.view.WindowInsets.Type.MANDATORY_SYSTEM_GESTURES,
190 | and android.view.WindowInsets.Type.TAPPABLE_ELEMENT
191 | ```
192 |
193 | 类型很多，我们通常关心键盘，状态栏和导航栏
194 |
195 | ### 获取高度和状态
196 |
197 | 在 Android Q 之前，获取状态栏高度通常是通过反射获取。但是有了 WindowInsets 就不用这么麻烦了：
198 |
199 | ```kotlin
200 | content.setOnApplyWindowInsetsListener { view, windowInsets ->
201 | //状态栏
202 | val statusBars = windowInsets.getInsets(WindowInsets.Type.statusBars())
203 | //导航栏
204 | val navigationBars = windowInsets.getInsets(WindowInsets.Type.navigationBars())
205 | //键盘
206 | val ime = windowInsets.getInsets(WindowInsets.Type.ime())
207 | windowInsets
208 | }
209 | ```
210 |
211 | 上面代码可以获取导航栏和状态栏的高度，假设要获取隐藏和显示，可以通过：
212 |
213 | ```kotlin
214 | //注意：setOnApplyWindowInsetsListener 一设置监听就会回调，此时获取的 navigationBars 是否可见是 false
215 | //等绘制完成再去获取就是 true，这个稍微比较坑一点
216 | windowInsets.isVisible(WindowInsets.Type.navigationBars())
217 | ```
218 |
219 | ### 控制各种状态栏的显示和隐藏
220 |
221 | 在 Q 之前，控制导航栏和状态，需要用上各种谜之属性：
222 |
223 | ```kotlin
224 | view.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_STABLE or
225 | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or
226 | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
227 | ```
228 |
229 | 新版是这样的：
230 |
231 | ```kotlin
232 | //对状态栏和键盘也可以同样控制
233 | content.windowInsetsController?.show(WindowInsets.Type.navigationBars())
234 | content.windowInsetsController?.hide(WindowInsets.Type.navigationBars())
235 | ```
236 |
237 | ## 其他
238 |
239 | 一番测试下来，新版的 API 对于之前来说，可以说是非常好用了。
240 |
目前存在以下几个问题：
241 |
242 | 1. 不支持旧版
243 |
如果仅是在 Android Q 上使用，那这个工具就没这么香了，希望能通过 androidx 或 support 方式支持
244 |
245 | 2. FitSystemWindows
246 |
在有虚拟导航栏的手机上，FitSystemWindows 设置为 false，会强制改变 Activity 与导航栏的关系。
247 |
默认情况下, Activity 在导航栏的上面，它们处于同一层，但是设置为 false 之后，导航栏会直接覆盖在 Activity 的上面。
248 | 不过这可以通过给 Activity 的 parent 设置一个 padding 来解决。
249 |
250 | 3. 等 Q 发布后，还需要测试国产 ROM，以及第三方键盘的兼容性
251 |
252 | ## 总结
253 |
254 | 总的来说这个工具的出现，使获取,管理键盘等 APP 以外的装饰都变得非常友好。
255 |
由于 Android Q 现在还是预览版，还没有公布源码，暂时不知道其内部实现原理，等后期公布了源码再分析一下原理
256 |
257 |
258 |
259 |
260 |
261 |
262 |
263 |
264 |
265 |
266 |
267 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | rootProject.name='My Application'
2 | include ':app'
3 |
--------------------------------------------------------------------------------