🌟 SWipeBack

Android侧滑返回方案，实现沉浸式状态栏，支持SDK19(Android4.4)及以上。

目录

• 示例demo
• 实现原理
• 集成方式
• 使用方式
• 注意事项
• 版本记录
• 关于作者

示例demo

• Demo下载(1.5MB)

  点此下载 或扫描下方二维码

  

• 示例效果

  侧滑	屏幕旋转	窗口模式

实现原理

侧滑时利用反射将窗口转为透明，结束后再利用反射将窗口还原为不透明。

注：在Android9.0中禁止使用非SDK接口，但是窗口透明转换均属于浅灰名单，目前不受限制。

详细分析

集成方式

在module的build.gradle中添加如下代码

    dependencies {
        implementation 'cn.simonlee.widget:swipeback:1.1.0'
    }

使用方式

• Step.1

  在styles中配置如下属性

  <item name="android:windowBackground">@android:color/transparent</item>

• Step.2

  在Activity的onCreate方法中获取SwipeBackHelper实例

  @Override
  public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
          mSwipeBackHelper = new SwipeBackHelper(this);
      }
  }

• Step.3

  在Activity的dispatchTouchEvent和onTouchEvent中分发触摸事件，如果仅希望侧边触发，可不用onTouchEvent

  @Override
  public boolean dispatchTouchEvent(MotionEvent event) {
      if (mSwipeBackHelper != null && mSwipeBackHelper.dispatchTouchEvent(event)) {
          return true;
      }
      return super.dispatchTouchEvent(event);
  }
  
  @Override
  public boolean onTouchEvent(MotionEvent event) {
      if (mSwipeBackHelper != null) {
          mSwipeBackHelper.onTouchEvent(event);
      }
      return super.onTouchEvent(event);
  }

• Step.4

  仔细阅读注意事项。

注意事项

• Tips.1

  如需要适配SDK21(Android5.0)以下，必须在styles中配置如下属性。SDK21及以上无需此属性

  <item name="android:windowIsTranslucent">true</item>

• Tips.2

  侧滑会导致"android:windowBackground"属性失效，因为需要透视到下层Activity。

• Tips.3

  侧滑的核心原理是利用反射转换窗口透明，这会影响到下层Activity的生命周期。如果你的Activity代码逻辑比较混乱，使用之前务必注意优化。

• Tips.4

  当顶层Activity方向与下层Activity方向不一致时侧滑会失效（下层方向未锁定除外），请关闭该层Activity侧滑功能。 示例场景：强制竖屏界面A，跳转进入横屏播放界面B，此时侧滑会失败，应关闭界面B的侧滑功能。

版本记录

• V1.1.0 2020/03/19

  1. 对功能解耦，移除状态栏相关操作，仅保留侧滑实现。
  2. 逻辑优化。

• V1.0.15 2019/04/15

  1. targetSdkVersion 27 -> 28.
  2. 解决setSwipeBackEnabled(...)中未做非空判断的问题。

关于作者

限于个人能力有限，些许疏忽失误，欢迎指正。如果提Issue回复不及时可以微信联系我。 如果您觉得有用，请不吝点Star😊

Author	E-mail	博客	WeChat
Simon Lee	jmlixiaomeng@163.com	简书 · 掘金

最后感谢以下博文，让我受益匪浅（有所疏漏，敬请谅解）

永远即等待 | Android滑动返回（SlideBack for Android）

HolenZhou | Android版与微信Activity侧滑后退效果完全相同的SwipeBackLayout

Ziv_xiao | Android右滑退出+沉浸式(透明)状态栏

挂云帆love | 仿微信滑动返回，实现背景联动（一、原理）