[翻译]如何安装ACRA-一个Android应用Crash跟踪系统
—在你自己的服务器上
How to setup ACRA, an Android Application Crash Tracking system, on your own host
原文地址:
http://inthecheesefactory.com/blog/how-to-install-and-use-acra-android/en
开发一个手机应用有如此多的限制,比如硬件限制(CPU,内存,电池等等)。如果你的代码不是足够合理,那就准备迎接世界上最严重的问题吧:Crash。根据研究所示:
应用崩溃是手机app用户抱怨最多的额问题
更严重的:
如果一个应用连续崩溃3次,大概一半的用户会卸载这个应用
崩溃追踪系统,让开发者能够从用户的设备上收集到每一个导致崩溃的细节,专门用来解决这种应用崩溃问题。目前最流行的2个流行崩溃追踪系统是 Crashlytics 和 Parse Crash Reporting,这两个服务都是免费的,开发者可以免费集成他们到你的app。当应用奔溃,整个跟踪报告就会发送到他们的后端,开发者可以及时快捷的修复这些严重的问题,这样,你就可以在很短的时间内奉上一个“无Crash”的应用。
然而,这些服务的提供商会收集这些数据,对于对用户隐私敏感的公司还是有些顾虑的。
那么。。。是否有那种允许我们在自己服务器部署的崩溃追踪系统?当然有!!并且会非常容易创建,下面有请Application Crash Reporting on Android (ACRA) 一个允许Android应用自动发送崩溃报告到自己服务器的库。
开始!
创建服务器
服务器端是客户端的一个先决条件。 因此,让我们从服务器端开始。
ACRA是精心设计的,是相当受欢迎的(ACRA是针对客户端应用的,服务端可以自己搭建)。 它允许开发者开发自己的服务器系统,我们找到网上有很多种ACRA服务端。我建议选择–也是最好的—Acralyzer,Acralyzer也是ACRA团队开发的,Acralyzer工作在Apache CouchDB之上,所以除了CouchDB之外,没有必要安装任何额外的软件。
Acralyzer是一个全功能的后端崩溃跟踪系统。 从不同设备反馈回的同一堆栈跟踪报告会被归类为一个问题。如果你已经修复了某个问题,你可以通过简单的点击一下来关闭这个问题。同时它也是实时工作的。 这个系统我找到的唯一一个缺点就是他的界面有点复杂,但是无所谓啦,本来就是为开发者设计的嘛 =P。
安装很简单,下面是一个如何在Ubuntu上安装Acralyzer的完整的指导。
首先从安装couchdb开始,打开终端,输入如下命令:
apt-get install couchdb
使用如下指令来验证是否安装成功
curl http://127.0.0.1:5984
如果安装成功,会返回如下信息
{"couchdb":"Welcome","version":"1.2.0"}
编辑/etc/couchdb/local.ini 文件来允许我们通过外部IP来访问CouchDB(默认只能通关127.0.0.1来访问)。只需要把下面两行的注释去掉即可。
;port = 5984
;bind_address = 127.0.0.1
然后修改为:
port = 5984
bind_address = 0.0.0.0
在这个文件里,你还应该添加一个用户名/密码来作为管理员账户,找到这一行(一般是在文件末尾):
[admins]
在它的下一行添加一个 username=password形式的内容。例如:
nuuneoi = 12345
不用担心在这里写明文密码会不会有问题,一旦CouchDB重启后,你的密码会被自动哈希加密,并且是不可读的
保存文件,通过下面的语句来重启CouchDB:
curl -X POST http://localhost:5984/_restart -H"Content-Type: application/json"
现在,你就可以通过浏览器来访问CouchDB了,网页服务被称为Futon—CouchDB的界面后端。通过以下地址来打开浏览器:
http://<YOUR_SERVER_IP>:5984/_utils
界面显示如下:
首先,你需要通过之前设定的管理员账户来登录系统
现在我们要安装一个acro-storage(Acralyzer的存储端)。通过右侧的菜单,点击Replicator(复制器),并填写表单的from Remote Database和from Remote 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
还是点击Replicate来安装
如果你上面做的都对的话,你会发现系统里多了2个数据库—-acra-myapp 和 acralyzer.
离成功很近了,下一步,我们要创建用户,打开浏览器,转到这个网址:
http://<YOUR_SERVER_IP>:5984/acralyzer/_design/acralyzer/index.html
进入 Admin 页并点击 Users
填写一个任意的用户名和密码(不一定非得是之前的那个管理员账户),点击Create User。然后会看到如下信息:
把这些信息都拷贝保存在文档里,我们会在后面的客户端里用到
最后一件事就是保护acra-myapp里的数据,可以设定仅开放权限给管理员或者某些用户,你可以进入acra-myapp,然后点击Securities。 填写Members段里的Roles字段。如下所示:
["reader"]
搞定!
之后,你就可以通过类似下面这样的网页来访问操作面板:
http://<YOUR_SERVER_IP>:5984/acralyzer/_design/acralyzer/index.html
请注意:arco-myapp是为一个应用创建的,如果你要为另外一个应用创建一个后端系统。那么重复上面的步骤,复制一个acro-storage,不过需要把本地的数据库改为*acra-<your_app_name>* 。 注意名字是以*acra-*开头的。
如果系统里不止一个app。Acralyzer的操作面板里会呈现一个下拉列表,让你选择哪一个应用来查看问题报告,有空可以自己试试。
在客户端安装ACRA
在手机客户端安装ACRA非常容易,首先需要在build.gradle中添加一个(dependency)依赖(使用Android Studio):
compile ‘ch.acra:acra:4.6.1‘
同步你的gradle文件,然后创建一个自定义的Application类—不要忘记在AndroidManifest.xml中定义它。(我认为每个Android开发者都会怎么做的),
在你的自定义Application类上面添加一个Annotation @ReportCrashes
import android.app.Application;
import org.acra.ACRA;
import org.acra.annotation.ReportsCrashes;
import org.acra.sender.HttpSender;
/**
* Created by nuuneoi on 2/19/2015.
*/
@ReportsCrashes(
)
public class MainApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
ACRA.init(this);
}
}
现在上面说到的保存的信息派上用场了,复制他们到@ReportsCrashes注释中。
@ReportsCrashes(
httpMethod = HttpSender.Method.PUT,
reportType = HttpSender.Type.JSON,
formUri = "http://YOUR_SERVER_IP:5984/acra-myapp/_design/acra-storage/_update/report",
formUriBasicAuthLogin = "tester",
formUriBasicAuthPassword = "12345"
)
最后一步,不要忘记在AndroidManifest.xml中添加网络权限
<uses-permission android:name="android.permission.INTERNET"/>
恭喜你!全都搞定!
测试
现在让我们测试一下,在Activity中添加一些认为的Crash。例如:
TextView tvHello;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
tvHello.setText("Test Crash");
}
运行你的应用,然后换一个Crash的方式,再次运行,然后在你的操作面板里可以看到这些bugs报告已经发送到后端系统中了。
每个bug条目都是一系列来自不同的应用用户,不同时间发送的。
点击一个报告,深入的查看一下,你会看到内容是一个完整的stacktrace。
还有一堆长长的信息,足够你翻7页之多。
如果你fix了某个bug。你可以通过点击“bug”图标来关闭该bug。(下图中高亮的部分)
希望大家觉得这篇文章有帮助,尤其对于那些对隐私比较关心的,需要一个应用崩溃追踪系统的大公司。
实际上ACRA还有很多特性,比如:当Crash发生时,通过Toast提示或者弹出Dialog。你可以在ACRA的网站找到这些选项。
Acralytics同样也有很多其他功能,比如,你可以设定服务器在收到Bug报告的时候给我们发邮件。查看更多信息,请访问Acralyzer .
原文作者:nuuneoi