Cactus: A Kotlin repository from ChenBabys

点我下载demo(密码：cactus)

注意！注意！注意！写在前面

如果你项目里使用了Thread.UncaughtExceptionHandler或者第三方异常捕获库，比如友盟，bugly等，Cactus请在Thread.UncaughtExceptionHandler或者第三方异常捕获库，比如友盟，bugly等之后注册使用，并且建议在Application里注册使用。为什么要这样操作？因为如果android 8.0以上设备隐藏了通知栏信息，当您的app崩溃重启后会出现invalid channel for service notification异常，而该异常属于系统级别的，没法捕获，所以Cactus对该异常进行了杀死app的操作，但是并不能保证第三方异常监控还是能捕获它。如果第三方后台还是有该异常信息，你又觉得该异常影响你的app崩溃率，请调用hideNotificationAfterO(false)方法，打开通知栏信息。

使用

android studio

androidx

implementation 'com.gyf.cactus:cactus:1.1.3-beta13'

android support

implementation 'com.gyf.cactus:cactus-support:1.1.3-beta13'

用法（具体api请参考api说明）

java用法

 Cactus.getInstance()
       .isDebug(true)
       .setPendingIntent(pendingIntent)
       .addCallback(new CactusCallback())
       ... //其他api等
       ...
       .register(this)

注销
```
  Cactus.getInstance().unregister(this)
```
重启
```
 Cactus.getInstance().restart(this)
```

kotlin用法

 cactus {
    setPendingIntent(pendingIntent)
    setMusicId(R.raw.main)
    isDebug(true)
    ... //其他api等
    ...
    addCallback({
       //onStop回调，可以省略
    }) { 
       //doWork回调
    }
 }

注销
```
 cactusUnregister()
```
重启
```
 cactusRestart()
```

混淆规则(proguard-rules.pro)

 -keep class com.gyf.cactus.entity.* {*;}

api说明，★ 标识的建议用户修改，而不是使用默认值

api	说明	api	说明
★ setChannelId	渠道Id，默认是Cactus，建议用户修改，非必传	★ setChannelName	渠道名，用于设置里通知渠道展示，默认是Cactus，建议用户修改，非必传
★ setTitle	通知栏标题，默认是Cactus，建议用户修改，非必传	★ setContent	通知栏内容，默认是Cactus is running，建议用户修改，非必传
★ setSmallIcon	通知栏小图标，默认是库里的图标，建议用户修改，非必传	setLargeIcon	通知栏大图标，默认没有大图标，非必传
★ setServiceId	服务Id，默认是1到Int.MAX_VALUE随机数，非必传	setPendingIntent	设置PendingIntent，用来处理通知栏点击事件，非必传
addCallback	增加回调，用于处理一些额外的工作，非必传	addBackgroundCallback	前后台切换回调，用于处理app前后台切换，非必传
setWorkerEnabled	是否可以使用WorkManager，默认可以使用，非必传	setCrashRestartUIEnabled	奔溃是否可以重启用户界面，默认为false，google原生rom android 10 以下可以正常重启，非必传
setRemoteViews	设置RemoteViews（自定义布局），非必传	setBigRemoteViews	设置BigRemoteViews（自定义布局），非必传
hideNotification	是否隐藏通知栏，经测试，除了android 7.1手机之外都可以隐藏，默认隐藏，非必传	hideNotificationAfterO	是否隐藏Android 8.0以上通知栏，默认隐藏
setMusicEnabled	是否可以播放音乐，默认可以播放音乐，非必传	setBackgroundMusicEnabled	后台是否可以播放音乐，默认不可以后台播放音乐，非必传
setMusicId	设置自定义音乐，默认是无声音乐，该api只要在isDebug为true才会有生效，非必传	★ setMusicInterval	设置音乐间隔时间，时间间隔越长，越省电，默认间隔时间是0，非必传
setOnePixEnabled	是否可以使用一像素，默认可以使用，只有在android p以下可以使用，非必传	isDebug	是否Debug模式，默认没有调试信息，非必传
setNotification	设置notification，非必传，如果不传，将使用用户根据其他api设置的信息构建Notification	setNotificationChannel	设置NotificationChannel，非必传，如果不传，将使用默认的NotificationChannel
register	必须调用，建议在Application里初始化，使用Kotlin扩展函数不需要调用此方法	unregister	注销，并不会立马停止，而是在1s之后停止，非必须调用，比如可以在app完全退出的时候可以调用，根据你的需求调用
restart	重启，与register区别在于不会重新配置CactusConfig信息，而是使用上一次配置的信息	isRunning	是否在运行

流程图

保活效果，仅供参考(数字代码oom_adj优先级，优先级数字越小越不容易被杀)

维度	android 6.0以下虚拟机	android 7.1虚拟机	android 7/8/8.1/9/10虚拟机	vovo x23 (android 9)	华为 mate20 /OnePlus (android 9)	华为 mate30 pro (android 10)
前台	0	0	0	0	0	0
后台（优化前）	6	立马死了	11	8	11	11
后台（优化后）	1	3	3	4	3	0
息屏（优化前）	6	立马死了	11	9	11	11
息屏（优化后）	0	3	3	4	3	0

说明：oom_adj优先级数字越小越不容易被杀

oom_adj	说明	oom_adj	说明
0	前台进程	1	可见进程
2	可感知的进程，比如那种播放音乐	3	正在备份的进程
4	高权重进程	5	有Service的进程
6	与Home交互的进程	7	切换进程
8	不活跃的进程	9	缓存进程，也就是空进程
11	缓存进程，也就是空进程	15	缓存进程，空进程，在内存不足的情况下就会优先被kill
16	预留的最低级别，一般对于缓存的进程才有可能设置成这个级别

更新说明

1.1.2

增加注销和重启功能
增加判断服务是否是在运行中
增加hideNotificationAfterO方法(是否隐藏Android 8.0以上通知栏)
优化代码

1.1.1

重点：修复1.1.0版本由于新增设置渠道api(setNotificationChannel)忘记做渠道判断，导致在8.0以下手机奔溃，1.0.8版本不受影响

1.1.0

除了android7.1手机都可以隐藏通知栏了
增加一些通知栏相关api，比如可以自定义view了
优化代码

1.0.8

解决设置后台可以播放音乐，奔溃重启后无法继续播放音乐的问题

1.0.7

增加前后台切换监听
增加设置后台是否可以播放音乐的api

联系我

QQ群 314360549（问题交流）

ChenBabys/Cactus