Skip to content

Latest commit

 

History

History
188 lines (137 loc) · 6.66 KB

README.md

File metadata and controls

188 lines (137 loc) · 6.66 KB

SpiderMan

MIT

SpiderMan能为您做的事:

  • 在Android手机上自动显示闪退崩溃信息,直接分享给相关开发人员!
  • 再也不用担心测试妹妹给你重现怎样操作才能触发闪退崩溃的尴尬!
  • 再也不用担心产品给你说哪儿哪儿会闪退崩溃,但是又不能场景还原的无奈!
  • 再也不用担心某些国产Rom禁止异常log输出!
  • 再也不用担心开发工具异常log信息输出时灵时不灵!
Debug环境 Share
crash_info crash_info_share

引入依赖

v1.1.8开始使用jitpack仓库,记得添加jitpack仓库的引用。

maven { url 'https://jitpack.io' }

appbuild.gradle引入依赖:

def spider_man = "v1.2.0"

方式一

debugImplementation "com.github.simplepeng.SpiderMan:spiderman:${spider_man}"
releaseImplementation "com.github.simplepeng.SpiderMan:spiderman-no-op:${spider_man}"

方式二

implementation "com.github.simplepeng.SpiderMan:spiderman:${spider_man}"

上面方式一debug环境有奔溃信息提示,release环境则没有,方式二都有,但是记得添加混淆。

直接显示错误页面

有时候可能因为一些特殊环境下才会发生的崩溃很难复现,所以我们不得以会将一些代码放到try/catch中运行,这样虽然保证了可以不崩溃,但是当发生崩溃时又会很容易忽略掉错误信息。现在我们可以直接在catch代码块中调用SpiderMan.show(Throwable e)方法,这样就可以直接显示崩溃提示页面。

try {
      String text = null;
      text.toUpperCase();
    } catch (Exception e) {
      SpiderMan.show(e);
}

Crash回调

发生crash时,如果你希望能拿到异常信息,保存到本地或者其他自定义操作,那么你可以使用下面的回调方法。

//回调crash
SpiderMan.setOnCrashListener(new SpiderMan.OnCrashListener() {
    @Override
    public void onCrash(Thread t, Throwable ex) {
        saveCrash(t, ex);
    }
});

SpiderManUtils提供了一些封装好的方法,例如saveTextToFileparseCrash,自行按需使用。

如果release也需要回调,请使用release回调库,从1.1.9开始提供。

releaseImplementation "com.github.simplepeng.SpiderMan:spiderman-callback:${spider_man}"

冲突

androidx

项目已经依赖了androidx.appcompat:appcompat包,如果产生冲突请使用下面的方式依赖。

debugImplementation("com.github.simplepeng.SpiderMan:spiderman:${spider_man}") {
    exclude group: "androidx.appcompat"
}
releaseImplementation("com.github.simplepeng.SpiderMan:spiderman-no-op:${spider_man}") {
    exclude group: "androidx.appcompat"
}

support

项目已经依赖了com.android.support:appcompat-v7包,如果产生冲突请使用下面的方式依赖。

debugImplementation("com.github.simplepeng.SpiderMan:spiderman:${spider_man}") {
    exclude group: "com.android.support"
}

releaseImplementation("com.github.simplepeng.SpiderMan:spiderman-no-op:${spider_man}") {
    exclude group: "com.android.support"
}

混淆

-keep class com.simple.spiderman.** { *; }
-keepnames class com.simple.spiderman.** { *; }
-keep public class * extends android.app.Activity
-keep class * implements Android.os.Parcelable {
    public static final Android.os.Parcelable$Creator *;
}
# support
-keep public class * extends android.support.annotation.** { *; }
-keep public class * extends android.support.v4.content.FileProvider
# androidx
-keep public class * extends androidx.annotation.** { *; }
-keep public class * extends androidx.core.content.FileProvider

自定义界面样式

SpiderMan.setTheme(R.style.SpiderManTheme_Dark);

SpiderMan内置了两种主题样式lightdark

light dark custom

所有自定义属性定义在attrs.xml

  • smToolbar:toolbar的背景色
  • smToolbarText:toolb title的颜色
  • smToolbarShareText:分享文字按钮的颜色
  • smContentBackground:toolb下方内容的背景色
  • smIdentText:标签名字的颜色
  • smDescText:标签描述的颜色

具体可以参考app中的用法。

赞助

如果您觉得SpideMan帮助了您,可选择精准扶贫🙇🙇🙇

您的支持是作者继续努力创作的动力😁😁😁

萌戳下方链接精准扶贫⤵️⤵️⤵️

扶贫方式

技术支持Q群:1078185041

版本迭代

  • v1.2.0:解决协程Crash异常信息不对的问题
  • v1.1.9:增加crash-callbackmodule,升级gradle版本
  • v1.1.8:使用jitpack仓库
  • v1.1.7: 自动初始化
  • v1.1.6: 解决view id重名引发的bug
  • v1.1.5: 增加cpu-abiversionCodeversionName输出
  • v1.1.4: 切换到androidx
  • v1.1.3: change minSdkVersion to 14
  • v1.1.2: 解决FileProvider file_path重名bug(bug来源LuckSiege/PictureSelector)
  • v1.1.1: 新增直接显示错误页面的方法SpiderMan.show(Throwable e),优化错误类型
  • v1.1.0: 增加自定义界面主题和国际化
  • v1.0.9: 增加appcompat包冲突解决方案
  • v1.0.8: 发现很多小伙伴不会代理异常收集,所以删除了异常回调
  • v1.0.7: 删除spiderman-no-op never-crash,优化报错类型显示
  • v1.0.6: 增加spiderman-no-op
  • v1.0.5: 奔溃文本分享美化排版
  • v1.0.4: 崩溃输出改为error级别
  • v1.0.3: 增加 拷贝/分享 崩溃文字/图片信息
  • v1.0.2: 重构,新增设备信息
  • v1.0.1: 去除 allowBackup,label
  • v1.0.0: 首次上传