Pular para o conteúdo principal

Lint API Check e Biblioteca de Compatiblidade: Armas contra a Fragmentação no Android



Um dos problemas mais falados sobre a plataforma Android é sua fragmentação, que envolve as diferenças entre hardwares, resolução e densidades de displays e, versões do sistema operacional. Bem, tenho uma boa e uma má notícia para você que está lendo este texto e é desenvolvedor Android:

Notícia ruim: realmente a fragmentação existe e não temos como fugir dela;
Noticia boa: a plataforma Android é inteligente o suficiente para fornecer diversos mecanismos para atacar e minimizar este problema. Temos a especialização dos recursos, com isso, podemos fornecer menus, conteúdos textuais e, principalmente, Views específicas para cada aparelho, ou família de aparelhos. Quanto ao problema de diferenças de hardware, a plataforma também fornece APIs agnósticas, que só impedem uma distribuição global de seu aplicativo se o código não for bom.

Porém, neste pequeno artigo vamos focar na resolução do problema de fragmentação em relação à diferença de versões do sistema operacional. No momento da escrita deste texto (Junho de 2013), o market share do Android 2.3.x supera as outras versões, tendo cerca de 44,1%. Porém, as versões acima da 4.0 também estão bem no mercado, com 28,6% e 16,5% para o Android 4.0.x e 4.1.x/4.2.x, respectivamente. O problema disso é que temos APIs que só funcionam em algumas versões. Um dos casos mais famosos são os Fragments, introduzidos na versão 3.0. Como resolver este problema todo?

Existem duas soluções principais e com um alto poder de auxílio para nós, desenvolvedores Android:

Biblioteca de Compatibilidade: esta biblioteca permitiu que recursos criados para versões mais recentes do Android possam ter retro compatibilidade. Um exemplo bem conhecido são os Fragments.

Nas versões mais novas do ADT, ao criar um projeto no Eclipse já podemos perceber que dentro da pasta libs tem um jar com o nome iniciando em android-support-<versão>. Com ela podemos utilizar Fragment, GridLayout e outras classes criadas em versões mais recentes.

E o melhor dessa história é o fato de, geralmente, utilizarmos as classes exatamente da mesma forma como utilizaríamos em seu pacote normal. Veja o trecho de código abaixo:

FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
transaction.setCustomAnimations(R.anim.enter, R.anim.exit);
            
drugFragDetail = new DrugFragmentDetail();
drugFragDetail.setArguments(b);
transaction.add(R.id.detailFragment, drugFragDetail);

O único indício de uso da biblioteca de compatibilidade (sem olhar os imports) é o getSupportFragmentManager. Na API do Android 3.0 o método seria o getFragmentManager. Por isso utilizei a expressão “geralmente” há poucos parágrafos acima. Os imports das classes também alteram de android.app.* para android.support.v4.app.*. Mas mesmo assim perceba que é um trabalho pequeno comparado aos benefícios que temos como retorno.

Claro que neste pequeno artigo não podemos mostrar todas as possibilidades desta biblioteca de compatibilidade. Mas não se esqueça dela, em breve estará utilizando-a massivamente em seus projetos.

Lint API Check: a outra fórmula milagrosa que podemos utilizar se chama Lint API Check. Surgiu a partir de mudanças feitas no ADT 17 e, permitiu que um código Android possa ser feito com condicionais referentes a versão do sistema operacional. Mas claro que não vamos fazer isso via código if-else por exemplo, mas sim, utilizando Java Annotations.

Para exemplificar este conceito através de código vamos utilizar a PreferenceActivity. Esta era uma classe filha de Activity especializada para o uso de persistência de dados com SharedPreferences. Acontece que depois da versão 3.0 do Android, o método que associa os campos a serem persistidos mudou, ficando depreciado para versões pré 3.0. Podemos deixar o código depreciado mesmo? Sim, mas não é o ideal. O Google tem boas razões para indicar isso e sempre que possível, devemos remover este warning do código.

Veja a listagem abaixo:

import android.annotation.TargetApi;
import

public class PreferenciaActivity extends PreferenceActivity {

    public static int prefs_xml= R.layout.preferencias;

    @Override
    protected void onCreate(final Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        try {
            getClass().getMethod("getFragmentManager");
            addResources11();
        } catch (NoSuchMethodException e) {
            addResourcesPre11 ();
        }
    }

    @SuppressWarnings("deprecation")
    protected void addResourcePre11()
    {
        addPreferencesFromResource(prefs_xml);
    }

    @TargetApi(11)
    protected void addResource11 ()
    {       
getFragmentManager().beginTransaction().replace(android.R.id.content, new PF()).commit();
    }

    @TargetApi(11)
    public static class PF extends PreferenceFragment
    {      
        @Override
        public void onCreate(final Bundle savedInstanceState)
        {
          super.onCreate(savedInstanceState);
          addPreferencesFromResource(PreferenciaActivity.prefs_xml);
        }
    }

}

No onCreate da PreferenceActivity estamos verificando se existe o método getFragmentManager. Caso afirmativo o bloco try irá trabalhar sem problemas e, isso nos diz que o aplicativo estará sendo executado em uma versão 3.0, ou superior, do Android. Caso negativo, versão 2.3 ou inferior.

Se estivermos em 3.0 ou superior, chamamos o método addResources11, específico para estes API Level ´s. Mas sem a annotation @TargetApi(11) e o import android.annotation.Target, o código irá apresentar problemas ainda na compilação.

No método addResources11 estamos fazendo uma instância da classe PF, que também está marcada com a anotação. A regra aqui é: a annotation sempre deve existir em método e classe que desejarmos especificar em qual API Level ela trabalha, logicamente com exclusividade.

Com isso o código irá rodar perfeitamente em qualquer versão do Android, utilizando as últimas técnicas e as classes indicas pela competente equipe que cria a plataforma.

Apesar de ser um artigo curto, espero ter indicado o caminho das pedras para dizimarmos o fantasma da fragmentação de api level dentro do Android. Use e abuse da biblioteca de compatibilidade e da Lint API Check.

Att.
Ricardo Ogliari

Comentários

Postagens mais visitadas deste blog

PrimeFaces com JSF2 no ScrumToys

O JSF traz um grupo de componentes visuais prontos, a partir da versão 2.0 com suporte a Ajax nativo! Melhor que isso é a possibilidade de customizar ou utilizar uma suíte de componentes prontos para "turbinar" o projeto com o minimo de esforço. PrimeFaces é uma suite de componentes JSF customizados, a maioria com suporte a ajax, conta com um Kit para desenvolvimento mobile, é open source, a documentação é razoável, facíl de instalar e usar. Nesse exemplo utilizo o PrimeFaces 2.0.0, versão com suporte a JSF 2, no ScrumToys. Conheçe o ScrumToys ? ScrumToys é um Projeto Exemplo para JavaServer Faces 2.0 dentro do NetBeans 6.8, criado e mantido pelo time da Globalcode. É interessante que você tenha o NetBeans 6.8 para fazer esse exemplo, senão tiver baixe aqui . Baixe também, aqui , o PrimeFaces e o configure no NetBeans como biblioteca para o ScrumToys. Inicialmente o PrimeFaces requer a runtime JSF, mas isso pode variar dependendo de quais componentes você utilize, mai

Seja um Palestrante do TDC Connections 2022

A Equipe TDC está muito feliz e orgulhosa em começar mais uma jornada de eventos em 2022 e criar muitas oportunidades! Agora, chegou o momento para você que sempre quis ser palestrante mas não teve oportunidade, e também de quem já é palestrante experiente, e está ansioso para compartilhar aquela nova prática ou caso de sucesso fresquinho, submeter sua palestra para o TDC Connections e co-criar conosco o maior evento de desenvolvedores do Brasil.  Link de inscrição: https://cfp-conn.thedevconf.com.br/?_ga=2.103579840.1386204218.1643036190-1988609034.1631800014 Confira aqui o calendário do TDC 2022. Nesta edição teremos muitas novidades e você poderá palestrar de forma Online ou Presencial! Entenda como vai funcionar o TDC CONNECTIONS: Nesta edição, além de todo o conteúdo dividido em Trilhas transmitidas ao vivo (13 trilhas simultâneas) também teremos dois eventos híbridos em Recife e Belo Horizonte, que terão uma trilha por dia, ao vivo, para um público limitado, seguindo protocolo

Entendendo como funciona a programação de computadores: linguagens de programação, lógica, banco de dados

Nesse post, diferente dos últimos que foram mais enfáticos nas experiências com tecnologias, vou focar um pouco mais nos profissionais que estão começando, ou pretendem ingressar na área de desenvolvimento de software, falando sobre conceitos fundamentais relacionados a programação em geral . Mercado de trabalho para programação Conforme já sabemos, o mercado de desenvolvimento de software, especialmente no Brasil, continua em franca expansão, sendo que cada vez mais as empresas buscam desenvolver seus próprios sistemas usando as mais diferentes e novas tecnologias. Algumas matérias interessantes: As seis profissões mais valorizadas em 2010 no IDG Now! Muitas vagas e sensação de reaquecimento da economia Por isso, a área de desenvolvimento de software tem despertado interesse em muitos profissionais de outras áreas que desejam mudar de profissão, já que as oportunidades de trabalho tendem a ser maiores. Esse é um perfil presente em muitos dos clientes da Globalcode que acabou m

JSON fácil em Java com GSon !

Ola pessoal ! O formato JSON ( J ava S cript O bject N otation) vem se consagrando cada vez mais na comunicação de dados, principalmente nos dispositivos móveis devido a esse formato ser mais leve que o XML e também mais legível. Uma prova disso são as inúmeras bibliotecas que existem para manipular esse formato, e no caso do Android, o suporte ao JSON é nativo. Mas apesar de ter esse suporte nativo, algumas operações devem ser feitas manualmente e o código acaba ficando um pouco verboso e repetitivo, já que para cada objeto que se deseja transmitir é necessário fazer um método que lê as propriedades do JSON e faz as devidas atribuições no seu objeto Java. Vamos supor o seguinte objeto sendo transmitido em JSON: {   user: {     id: 123456,     name: "Neto Marin",     username: "netomarin",     email: "netomarin@globalcode.com.br"   } } Se você fosse tratar um Webservice que envia esse JSON para o seu aplicativo Android, além de criar a o

Top 4 desafios do gestor de TI e como superá-los

  O setor de TI se apresenta como uma área essencial ao desenvolvimento e expansão da empresa, em especial, aquelas que têm a criação de soluções tecnológicas como core business. O mercado dinâmico da atualidade, com mudanças constantes e concorrência elevada, exige aperfeiçoamento do gestor de TI para se destacar em suas atividades. Pensando em te ajudar nesse processo, separamos 4 desafios do gestor de TI e como superá-los. Acompanhe! Transformação digital na atualidade A transformação digital é constante e define os caminhos futuros da nossa sociedade. Por isso, o setor de TI vem se tornando mais estratégico em empresas de todos os segmentos. O home office é um bom exemplo de como a revolução digital está se processando. Vamos falar sobre ele e outros pontos nos tópicos a seguir. Confira! Desafios do gestor de TI Para se manter atualizado sobre o tema e permanecer competitivo no mercado, é  necessário acompanhar as tendências de TI . Confira, abaixo, alguns dos principais desafios d

Segurança da informação no alvo: o que esperar do futuro?

A segurança da informação não se trata apenas de proteger os dados contra acesso não autorizado. Na prática, refere-se aos recursos que impedem: uso; registro; inspeção; divulgação; interrupção; modificação; destruição de dados. O uso de dados pode abranger desde um perfil nas redes sociais a detalhes financeiros, biometrias ou novos projetos. Por isso, a preocupação com a proteção dos dados é crescente, tanto para empresas quanto clientes. Para muitas pessoas, a coleta de dados é considerada invasão de privacidade, criando desconfiança do titular dos dados, pois o uso dos dados pode ser facilmente corrompido, utilizado para fins não declarados. Apesar de o uso dos dados terem impulsionado os avanços tecnológicos na última década, as organizações lidam com o desafio de distinguir dados de informações pessoais de modo a proteger a privacidade e as preferências dos clientes. Neste artigo, abordaremos o impacto da segurança da informação e o que esperar do futuro. Confira casos conhecido