SlideBack

Introduction: 无需继承的 Activity 侧滑返回库 类全面屏返回手势效果 仿“即刻”侧滑返回
More: Author   ReportBugs   
Tags:

无需继承的 Activity 侧滑返回库 类全面屏返回手势效果 仿“即刻”侧滑返回


前情

最近一直在研究侧滑返回效果的实现,目前比较多的方案如下:

  1. 背景透明主题。问题是性能与神坑"Only fullscreen activities can request orientation"。
  2. 将上页 ContentView 绘制到当前页,侧滑时动画推入推出。(也许挺不错?)
  3. 类全面屏返回手势。即刻 App的效果(下图)。

本库这里选择了方案 3。

预览

即刻 App 本库 Demo 下载


Demo 下载

使用

  • 引用类库 *请将 last-version 替换为最新版本号

     // 1.添加 jitpack 仓库
     allprojects {
         repositories {
             ...
             maven { url 'https://jitpack.io' }
         }
     }
     // 2.添加项目依赖(last-version 替换为最新版本号)
     dependencies {
         implementation 'com.github.parfoismeng:slideback:last-version'
     }
    
    • 代码使用

      // 在需要滑动返回的 Activity 中注册,最好但非必须在 onCreate 中
      SlideBack.with(this)
             .callBack(new SlideBackCallBack() {
                 @Override
                 public void onSlideBack() {
                     finish();
                 }
             })
             .register();
      
      // onDestroy 时解绑
      // 内部使用 WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下
      SlideBack.unregister(this);
      

      OJBK!So easy!

  • 旧方法仍然可用
    点击展开查看 // Kotlin class SecondActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // 在需要滑动返回的 Activity 中注册 SlideBack.register(this) { Toast.makeText(this, "SlideBack", Toast.LENGTH_SHORT).show() } } override fun onDestroy() { super.onDestroy() // onDestroy 时记得解绑 // 内部使用 WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下 SlideBack.unregister(this) } } // Java public class SecondActivity extends AppCompatActivity { @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 在需要滑动返回的 Activity 中注册 SlideBack.register(this, new SlideBackCallBack() { @Override public void onSlideBack() { Toast.makeText(SecondActivity.this, "SlideBack", Toast.LENGTH_SHORT).show(); } }); } @Override protected void onDestroy() { super.onDestroy(); // onDestroy 时记得解绑 // 内部使用 WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下 SlideBack.unregister(this); } } // ... // 如果需要在有可滑动 View(RecycleView/ScrollView 等)的 Activity 中使用,请使用此注册方法。 // haveScroll:页面是否有滑动 SlideBack.register(Activity activity, boolean haveScroll, SlideBackCallBack callBack)
  • API
    SlideBack.with(this) // 新 构建侧滑管理器 - 用于更丰富的自定义配置
          .haveScroll(false) // 是否包含滑动控件 默认 false
          .callBack(SlideBackCallBack) // 回调
          .viewHeight(viewHeightDP) // 控件高度 默认屏高/4
          .arrowSize(arrowSizeDP) // 箭头大小 默认 5dp
          .maxSlideLength(maxSlideLengthDP) // 最大拉动距离(控件最大宽度) 默认屏宽/12
          .sideSlideLength(sideSlideLengthDP) // 侧滑响应距离 默认控件最大宽度/2
          .dragRate(dragRate) // 阻尼系数 默认 3(越小越灵敏)
          .register();
    
  • Fragment 支持,详见 issues#2
    1. 在 Fragment 的父级 Activity 中注册 SlideBack
    2. 在 SlideBackCallBack 中 remove 栈顶的 Fragment

性能

附一张性能截图。可以看出来中间进行了很多次 onCreate & onDestory,最后内存和开始时一致: 
MEMORY

分析

源码分析 MD:Analysis.md

感谢

感谢 ChenTianSaber 的开源库 SlideBack掘金)提供的思路与源码

更新

  1. 提供新的可配置更多参数的注册方法(旧方法仍然可用) - 1.0.4
  2. 滑动事件冲突问题,修复 issues#1 - 1.0.3
  3. 删除无用依赖,添加 Java 引用示例 - 1.0.2
  4. 检查警告,修改类名,更新 README.md - 1.0.1
  5. 初版发布 - 1.0.0

计划

  1. 给郭婶投稿,源码分析 MD 没通过。准备抽时间重写一下。
  2. 目前滑动事件冲突的解决方案(1.0.3)不是很理想,但市面上好像都是这么解决的,如果您有更好的方案,请与我沟通,十分欢迎 PR。
  3. 看情况吧......

支持

劳烦各位大佬给个 Star 让我出去好装 B 行嘛!

其他

<!--

  • 加我好友(请注明来意)
QQ WeChat Email
757479544

youshi520000

youshi520000@163.com

yi520000@vip.qq.com

youshi.meng@gmail.com

parfois.meng@icloud.com

parfois.meng@outlook.com

-->

  • 赏杯咖啡
Alipay WeChat Pay
Support Me
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea