在Android应用的开发过程中,难免会有一些潜在的bug,造成用户手机出现Crash或者ANR,因此收集用户的崩溃日志是非常必要的。一般大一点的公司会自己搭建一套Crash日志上传系统,创业公司因为资源有限,会更倾向于引入第三方工具进行收集。
Crash日志的捕捉是非常容易的,接管默认的异常处理器,实现UncaughtExceptionHandler接口即可,但本文重点不在于分析如何捕捉Crash日志以及上传,也不是介绍第三方的一些平台,而是讲解如何使用ACRA(Application Crash Reporting on Android),一个可以自动上传崩溃日志到我们的服务器上的库文件。
一、安装服务器
自从ACRA被设计出来就一直非常流行,它允许开发人员开发自己的服务器系统,但我认为最好的,还是ACRA团队自己开发的Acralyzer系统,Acralyzer系统工作在Apache CouchDB上,因此,我们只需要安装CouchDB就可以了。
可以直接从官网(http://couchdb.apache.org)下载:
下载安装完成后,可以可以在浏览器里面看到couchdb的控制台。
开始配置服务器端,首先,我们需要安装一个acro-storage(Acralyzer服务器的存储终端),从右边的菜单区域点击Replicator进入,然后像下面这样填好from Remote Database 和 to Local Database:
from Remote Database: http://get.acralyzer.com/distrib-acra-storage
to Local Database: acra-myapp
点击右边的Replicate按钮完成数据库的导入。
接下来,我们以相同的方式安装Acralyzer。
from Remote Database: http://get.acralyzer.com/distrib-acralyzer
to Local Database: acralyzer
如果没有出错的话,我们可以在主页看到刚导入的数据库:
我们大部分内容已经完成了,接下来为客户端创建一个用户,打开浏览器进入下面的地址:
http://127.0.0.1:5984/acralyzer/_design/acralyzer/index.html
点击Admin,再切换到Users界面:
根据提示创建一个新的账号,创建成功后会有以下提示:
现在我们已经有了账号,可以开始在客户端进行设置。
二、客户端引入ACRA库文件
在客户端设置ACRA非常的简单,首先在build.gradle文件里添加如下依赖:
compile 'ch.acra:acra:4.6.1'
自定义Application,添加@ReportCrashes注解:
mport android.app.Application;
import org.acra.ACRA;
import org.acra.annotation.ReportsCrashes;
import org.acra.sender.HttpSender;
/**
* Created by stefanli on 16/3/16.
*/
@ReportsCrashes(
httpMethod = HttpSender.Method.PUT,
reportType = HttpSender.Type.JSON,
formUri = "http://127.0.0.1:5984/acra-myapp/_design/acra-storage/_update/report",
formUriBasicAuthLogin = "stefanli",
formUriBasicAuthPassword = "123456"
)
public class CustomApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
ACRA.init(this);
}
}
最后,在AndroidManifest.xml文件里面添加网络访问权限即可:
<uses-permission android:name="android.permission.INTERNET"/>
三、配置服务器地址
前面用到的127.0.0.1是默认使用的IP地址,在我们正式使用的时候应该替换为服务器的IP地址。
打开配置文件,路径为:/Users/stefanli/Library/Application Support/CouchDB/etc/couchdb/local.ini
修改以下配置:
port = 5984
bind_address = 0.0.0.0
到了这一步,我们基本的配置都完成了,可以写一个简单的例子运行一下,其他还有一些关于安全方面的配置,大家如果感兴趣的话可以继续完善一下。
系统的使用是非常简单的,其中包含了bug的详细信息以及用户手机的详细信息,具体的使用大家可以自己摸索一下。