修正悬浮窗无法移动到沉浸式状态栏上

优化代码逻辑及处理泛型使用警告
补充 Kotlin 语法使用文档
补充应用内全局显示悬浮窗的文档

Author: getActivity

.gitignore

@@ -4,8 +4,10 @@
 */build
 /captures
 /.cxx
+*/.cxx
 /.externalNativeBuild
 
+._*
 *.iml
 .DS_Store
 local.properties

README.md

@@ -15,26 +15,29 @@
 ```groovy
 dependencies {
     // 悬浮窗框架：https://github.com/getActivity/XToast
-    implementation 'com.hjq:xtoast:6.5'
+    implementation 'com.hjq:xtoast:6.6'
 }
 ```
 
 #### 使用案例
 
+* Java 用法
+
 ```java
-// 传入 Application 对象表示设置成全局的
-new XToast(XToastActivity.this)
+// 传入 Activity 对象表示设置成局部的，不需要有悬浮窗权限
+// 传入 Application 对象表示设置成全局的，但需要有悬浮窗权限
+new XToast<>(XToastActivity.this)
         .setView(R.layout.toast_hint)
         // 设置成可拖拽的
         //.setDraggable()
         // 设置显示时长
         .setDuration(1000)
         // 设置动画样式
-        .setAnimStyle(android.R.style.Animation_Translucent)
-        // 设置外层不能被触摸
-        .setOutsideTouchable(false)
+        //.setAnimStyle(android.R.style.Animation_Translucent)
+        // 设置外层是否能被触摸
+        //.setOutsideTouchable(false)
         // 设置窗口背景阴影强度
-        .setBackgroundDimAmount(0.5f)
+        //.setBackgroundDimAmount(0.5f)
         .setImageDrawable(android.R.id.icon, R.mipmap.ic_dialog_tip_finish)
         .setText(android.R.id.message, "点我消失")
         .setOnClickListener(android.R.id.message, new OnClickListener<TextView>() {
@@ -50,6 +53,76 @@ new XToast(XToastActivity.this)
         .show();
 ```
 
+* Kotlin 用法
+
+```kotlin
+XToast<XToast<*>>(activity)
+        .setView(R.layout.toast_hint)
+        // 设置成可拖拽的
+        //.setDraggable()
+        // 设置显示时长
+        .setDuration(1000)
+        // 设置动画样式
+        //.setAnimStyle(android.R.style.Animation_Translucent)
+        // 设置外层是否能被触摸
+        //.setOutsideTouchable(false)
+        // 设置窗口背景阴影强度
+        //.setBackgroundDimAmount(0.5f)
+        .setImageDrawable(android.R.id.icon, R.mipmap.ic_dialog_tip_finish)
+        .setText(android.R.id.message, "点我消失")
+        .setOnClickListener(android.R.id.message, object : OnClickListener<TextView?> {
+            override fun onClick(toast: XToast<XToast<*>>, view: TextView?) {
+                // 点击这个 View 后消失
+                toast.cancel()
+                // 跳转到某个Activity
+                // toast.startActivity(intent);
+            }
+        })
+        .show()
+```
+
+#### 没有悬浮窗权限如何全局显示？
+
+* 没有悬浮窗权限是不能全局显示在其他应用上的，但是全局显示在自己的应用上是可以实现的
+
+* 但是当前 Activity 创建的悬浮窗只能在当前 Activity 上面显示，如果想在所有的 Activity 都显示需要做特殊处理
+
+* 我们可以通过 Application 来监听所有 Activity 的生命周期方法，然后在每个 Activity.onCreate 时创建悬浮窗
+
+```java
+public final class FloatingLifecycle implements Application.ActivityLifecycleCallbacks {
+
+    static void with(Application application) {
+        application.registerActivityLifecycleCallbacks(new FloatingLifecycle());
+    }
+
+    @Override
+    public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
+        new XToast<>(activity)
+                .setXXXX()
+                .show();
+    }
+
+    @Override
+    public void onActivityStarted(Activity activity) {}
+
+    @Override
+    public void onActivityResumed(Activity activity) {}
+
+    @Override
+    public void onActivityPaused(Activity activity) {}
+
+    @Override
+    public void onActivityStopped(Activity activity) {}
+
+    @Override
+    public void onActivitySaveInstanceState(Activity activity, Bundle outState) {}
+
+    @Override
+    public void onActivityDestroyed(Activity activity) {}
+}
+```
+
 #### 框架亮点（原生 Toast 无法实现的功能）
 
 * 支持自定义 Toast 动画样式
@@ -62,16 +135,14 @@ new XToast(XToastActivity.this)
 
 * 支持一键开启 Toast 拖拽功能
 
-* 支持 Toast 全局显示（需要悬浮窗权限）
+* 支持 Toast 全局显示
 
 #### 作者的其他开源项目
 
 * 安卓技术中台：[AndroidProject](https://github.com/getActivity/AndroidProject)
 
 * 网络框架：[EasyHttp](https://github.com/getActivity/EasyHttp)
 
-* 日志框架：[Logcat](https://github.com/getActivity/Logcat)
-
 * 权限框架：[XXPermissions](https://github.com/getActivity/XXPermissions)
 
 * 吐司框架：[ToastUtils](https://github.com/getActivity/ToastUtils)
@@ -82,8 +153,14 @@ new XToast(XToastActivity.this)
 
 * Gson 解析容错：[GsonFactory](https://github.com/getActivity/GsonFactory)
 
+* 日志查看框架：[Logcat](https://github.com/getActivity/Logcat)
+
 #### Android技术讨论Q群：78797078
 
+#### 微信公众号：Android轮子哥
+
+![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/official_ccount.png)
+
 #### 如果您觉得我的开源库帮你节省了大量的开发时间，请扫描下方的二维码随意打赏，要是能打赏个 10.24 :monkey_face:就太:thumbsup:了。您的支持将鼓励我继续创作:octocat:
 
 ![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/pay_ali.png) ![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/pay_wechat.png)

XToast.apk

@@ -1,14 +1,14 @@
 apply plugin: 'com.android.application'
 
 android {
-    compileSdkVersion 28
+    compileSdkVersion 30
 
     defaultConfig {
         applicationId "com.hjq.xtoast.demo"
         minSdkVersion 16
-        targetSdkVersion 28
-        versionCode 65
-        versionName "6.5"
+        targetSdkVersion 30
+        versionCode 66
+        versionName "6.6"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
     buildTypes {
@@ -17,18 +17,25 @@ android {
             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
         }
     }
+
+    // 支持 Java JDK 8
+    compileOptions {
+        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_1_8
+    }
 }
 
 dependencies {
     implementation fileTree(include: ['*.jar'], dir: 'libs')
     implementation fileTree(include: ['*.aar'], dir: 'libs')
     implementation project(':library')
 
-    implementation 'com.android.support:appcompat-v7:28.0.0'
-    implementation 'com.android.support:design:28.0.0'
+    // 谷歌兼容库：https://developer.android.google.cn/jetpack/androidx/releases/appcompat?hl=zh-cn
+    implementation 'androidx.appcompat:appcompat:1.2.0'
+    implementation 'com.google.android.material:material:1.2.1'
 
     // 权限请求框架：https://github.com/getActivity/XXPermissions
-    implementation 'com.hjq:xxpermissions:9.5'
+    implementation 'com.hjq:xxpermissions:9.8'
     // 标题栏框架：https://github.com/getActivity/TitleBar
     implementation 'com.hjq:titlebar:8.2'
     // 吐司工具类：https://github.com/getActivity/ToastUtils

app/build.gradle

@@ -5,6 +5,7 @@
     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
 
     <application
+        android:name=".AppApplication"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"

app/src/main/AndroidManifest.xml

@@ -0,0 +1,20 @@
+package com.hjq.xtoast.demo;
+
+import android.app.Application;
+
+import com.hjq.toast.ToastUtils;
+
+/**
+ *    author : Android 轮子哥
+ *    github : https://github.com/getActivity/XToast
+ *    time   : 2021/01/24
+ *    desc   : 应用入口
+ */
+public class AppApplication extends Application {
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        ToastUtils.init(this);
+    }
+}

app/src/main/java/com/hjq/xtoast/demo/AppApplication.java

@@ -15,7 +15,7 @@ public class IOSToast {
     private static final int TIME = 3000;
 
     public static void showSucceed(Activity activity, CharSequence text) {
-        new XToast(activity)
+        new XToast<>(activity)
                 .setDuration(TIME)
                 .setView(R.layout.toast_hint)
                 .setAnimStyle(android.R.style.Animation_Translucent)
@@ -25,7 +25,7 @@ public static void showSucceed(Activity activity, CharSequence text) {
     }
 
     public static void showFail(Activity activity, CharSequence text) {
-        new XToast(activity)
+        new XToast<>(activity)
                 .setDuration(TIME)
                 .setView(R.layout.toast_hint)
                 .setAnimStyle(android.R.style.Animation_Activity)
@@ -35,7 +35,7 @@ public static void showFail(Activity activity, CharSequence text) {
     }
 
     public static void showWarn(Activity activity, CharSequence text) {
-        new XToast(activity)
+        new XToast<>(activity)
                 .setDuration(TIME)
                 .setView(R.layout.toast_hint)
                 .setAnimStyle(android.R.style.Animation_Dialog)