O documento aborda a diversidade do sistema operacional Android e os desafios de lidar com erros ao desenvolver aplicativos. Um recurso destacado é o ACRA, uma biblioteca que permite enviar relatórios detalhados de erros para um formulário no Google Drive ou outros meios. Instruções para implementar o ACRA em um projeto Android são fornecidas, juntamente com referências para mais informações.

1. Gabriel Augusto Gomes
gabrielaugustodm@gmail.com
Lidando com Erros
Android
SANTOS
2° Semestre de 2012

2. 1. LIDANDO COM ERROS
A plataforma Android dentre os sistemas operacionais móveis rodando
atualmente é a mais diversificada. As diferenças entre os aparelhos podem ser
muitas, desde modificações feitas pelas montadoras e operadoras, o tamanho
de suas telas e, principalmente, a versão de seus sistemas operacionais.
O sistema possui mais de onze versões atualmente e dentre as mais
utilizadas estão Android 2.2 Froyo, 2.3 Gingerbread, 3.0 Honeycomb, 4.0 Ice
Cream e 4.1 Jelly Bean. Vale lembrar dentro dessas principais versões, ainda
existem outras “ramificações”. Todas essas são as originais, além delas ainda
existem as personalizadas, criadas pelas operadoras ou por qualquer
desenvolvedor, visto que o Android possui seu código fonte aberto.
Dessa forma, quando lançamos um aplicativo para os usuários, o
principal desafio é controlar os erros. Para auxiliar a equipe de
desenvolvimento, foram criadas APIs para lidar com esses erros. Uma delas é
o ACRA. O ACRA é uma biblioteca que fornece relatórios detalhados com
informações de cada erro. Assim que um erro é registrado, essas informações
são enviadas por padrão um formulário Google Drive (Spreadsheet). Porém, se
houver a necessidade, o relatório dos erros pode ser enviado via POST a uma
página ou até mesmo por e-mail. Existe também a opção de perguntar ao
usuário se ele deseja enviar o relatório dos erros, nessa opção, o usuário pode
oferecer uma descrição do erro. A partir de algumas versões do Android,
também é possível enviar os relatórios pelo Google Play.
Informações sobre um erro, enviadas a uma Spreadsheet do Google Drive.

3. Informações sobre um erro, enviadas a uma Spreadsheet do Google Drive.
Informações sobre um erro, enviadas a uma Spreadsheet do Google Drive.

4. 2. IMPLEMENTANDO O ACRA
Para começar a implementar o ACRA, baixe a versão mais atualizada no
site oficial, abra sua pasta no Google Drive e faça upload do arquivo
CrashReports-template.csv. Feito isso, navegue até a aba Tools > Form
> Create a form. Copie o valor formKey
Feito isso, adicione o arquivo .jar do ACRA que se encontra dentro do .zip.
Copie para a subpasta “libs” do seu projeto e adicione a biblioteca.
Em seguida, adicione uma classe que seja herança da classe
Application do Android. Segue exemplo:
import org.acra.*;
import org.acra.annotation.*;
@ReportsCrashes(formKey = "formKey")
public class MyApplication extends Application {
@Override
public void onCreate() {
ACRA.init(this);
super.onCreate();
}
}

5. No campo formKey deve ser inserida a chave obtida na criação do
formulário do Google Drive.
Pronto, essa é a forma mais simples para implementar o ACRA. De acordo
com a necessidade, são várias as ferramentas oferecidas para personalizar o
report. Para maiores informações, visite o site oficial.

6. REFERENCIAS BIBLIOGRÁFICAS
Android Developers – Data Storage. Disponível em:<
http://code.google.com/p/acra/> Acesso em: 23 out. 2012.
André Santee – Rastreando crashes de apps no Android. Disponível em:<
http://jera.com.br/2554/android/rastreando-crashes-de-apps-no-android>
Acesso em: 23 out. 2012.
Como lidar com erros. Disponível em:<
http://www.broculos.net/pt/artigo/android-101-como-lidar-com-erros> Acesso
em: 23 out. 2012.