SlideBack

无需继承的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'
    }

• 代码简单使用，详见下方 API

    // 在需要滑动返回的Activity中注册，最好但非必须在onCreate中
    SlideBack.with(this)
            .callBack(new SlideBackCallBack() {
                @Override
                public void onSlideBack() {
                    finish();
                }
            })
            .register();

    // onDestroy时解绑
    // 内部使用WeakHashMap，理论上不解绑也行，但最好还是手动解绑一下
    SlideBack.unregister(this);

OJBK！So easy！

• Fragment 支持，详见 issues#2
  1. 在Fragment的父级Activity中注册SlideBack
  2. 在SlideBackCallBack中remove栈顶的Fragment

旧方法仍然可用，点击展开查看

// 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
        .edgeMode(edgeMode) // 边缘侧滑模式 默认左
        .callBack(new SlideBackCallBack() { // 回调
            @Override
            public void onSlideBack() {
                // TODO 回调事件
            }
        })
        .callBack(new SlideCallBack() { // 回调2 适用于设置左右模式 *两种回调同时写，后者会覆盖前者
            @Override
            public void onSlide(int edgeFrom) {
                // TODO edgeFrom(滑动来源): EDGE_LEFT(左侧) EDGE_RIGHT(右侧)
            }
        })
        .viewHeight(viewHeightDP) // 控件高度 默认屏高/4
        .arrowSize(arrowSizeDP) // 箭头大小 默认5dp
        .maxSlideLength(maxSlideLengthDP) // 最大拉动距离（控件最大宽度） 默认屏宽/12
        .sideSlideLength(sideSlideLengthDP) // 侧滑响应距离 默认控件最大宽度/2
        .dragRate(dragRate) // 阻尼系数 默认3（越小越灵敏）
        .register();

性能

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

分析

源码分析MD：Analysis.md & Analysis_v2.md

感谢

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

更新

1. 包含滑动控件的页面设置EDGE_BOTH时右侧滑动失效的Bug修复 issues#6 - 1.0.6
2. 支持设置屏幕左右侧侧滑 issues#4 - 1.0.5
3. 提供新的可配置更多参数的注册方法（旧方法仍然可用） - 1.0.4
4. 滑动事件冲突问题，修复 issues#1 - 1.0.3
5. 删除无用依赖，添加Java引用示例 - 1.0.2
6. 检查警告，修改类名，更新README.md - 1.0.1
7. 初版发布 - 1.0.0

计划

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

支持

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

其他

已使用996 License，为程序员发声，为自己发声。