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

TDC BUSINESS, chega a São Paulo com novas trilhas de Inteligência Artificial e Inovação

Maior conferência de profissionais de tecnologia do Brasil abordará temas em alta no momento como, por exemplo, Inteligência Artificial, Segurança, Ciência de Dados e Inovação O TDC BUSINESS, a 17° edição do The Developer's Conference na cidade de São Paulo, que acontece entre os dias 19 e 21 de Setembro, reunirá profissionais e especialistas da área para troca de experiência, compartilhamento de conteúdos e networking. Com o tema central: “Tecnologia para negócios transformadores”, o evento será totalmente híbrido, ocorrendo presencialmente no espaço Pro Magno, e com transmissão simultânea e atividades de network pela internet. A expectativa é reunir mais de 14.000 pessoas, somando a participação presencial e online.   Segundo Yara Mascarenhas, Fundadora e Host do Evento, “nosso objetivo com o TDC é inspirar a colaboração entre os profissionais e empresas para construir uma nova realidade para o mercado de TI.  Vamos juntar tecnologia e negócios com as trilhas técnicas...

JavaOne Brasil, dicas para submissão de palestras

Não quero parecer pretensiosa dando dicas para submissão de palestras para o JavaOne Brasil, mas sim repassar os tantos conselhos e sugestões recebidas pelos vetaranos do JavaOne: Bruno Souza e Leonardo Galvão que revisaram dezenas de submissões para o JavaOne e ajudaram a aprovar tantas palestras, e também misturar um pouco da minha experiência na seleção de palestras nos eventos realizados pela Globalcode e SouJava . 10 anos de JavaOne: http://www.globalcode.com.br/noticias/Globalcode10AnosNoJavaOne Os palestrantes ganham a entrada! A submissão pode ser feita em português! O passo mais importante para ser aprovado como palestrante no JavaOne é sem dúvida nenhuma submeter pelo menos uma palestra. Então, independente de qualquer coisa, participe, arrisque, divulgue.  Mas, se quiser aumentar as suas chances...   1) Leve a sério: peça para amigos fazerem uma leitura crítica do texto, e claro uma boa revisão ortográfica. 2) Submissão de várias palestras ou variações do ...

Devo fazer um curso ou ler um livro?

Acredito que todos os instrutores ou professores, independentemente da área, escola ou centro de treinamento, já devam ter recebido essa pergunta alguma vez na vida: devo fazer um curso ou ler um livro? Para responder a essa pergunta, precisamos avaliar os prós e contras de cada opção. Trabalho com treinamento há algum tempo e, hoje, recebi essa pergunta de um aluno. Não adianta responder a ou b sem argumentar, demonstrando as opções conforme a situação do aluno. O conteúdo, a forma de transmissão e a capacidade de assimilação do indivíduo são chaves para haver benefício maior de aprendizado. Tanto em um bom curso quanto em um bom livro, o conteúdo é a premissa básica . Por conteúdo entendemos: se está organizado; se respeita pré-requisitos; se promove o aprendizado guiado e incremental; se aborda de forma satisfatória os principais pontos; se tem bom balanço entre teoria, exemplos e prática (favorecendo exemplos e prática); se tem como premissa a acessibilidade possível (e cabível) pa...

Seja palestrante no TDC!

Os interessados em palestrar na maior plataforma de Inovação Aberta para desenvolvimento do ecossistema de teologia, tem até 25 de setembro para se inscrever A última edição do ano do TDC (The Developer's Conference), maior conferência para profissionais de tecnologia do Brasil, já tem data confirmada. O TDC Future, que acontece nos dias 6 a 8 de dezembro, em formato híbrido, ocorrerá presencialmente na UniRitter de Porto Alegre, e com transmissão simultânea pela plataforma Hopin. O evento traz como tema central: “O papel da tecnologia na construção do amanhã”, e reúne gestores, especialistas e profissionais da área para debater sobre o futuro da tecnologia, o impacto na vida das pessoas e seu papel na transformação da sociedade. A seleção de palestras nacionais e internacionais, ainda está com o Call4Papers aberto até 25 de setembro, os interessados em participar poderão submeter uma proposta por meio do site do evento . O tema deve estar vinculado a uma trilha específica, que é...

O que é Lógica de programação?

Este é o segundo de uma série de posts voltados aos leitores do blog que estão dando início à carreira de desenvolvimento de software. O assunto de hoje é a lógica de programação. Para ler antes: Entendendo como funciona a programação de computadores: linguagens de programação, lógica, banco de dados A lógica de programação é um pré-requisito para quem quer se tornar um desenvolvedor de software, independente da linguagem de programação que se pretende utilizar. Mas o que é de fato a Lógica de Programação e como saber se eu tenho esse pré-requisito? A lógica de programação nada mais é do que a organização coerente das instruções do programa para que seu objetivo seja alcançado. Para criar essa organização, instruções simples do programa, como mudar o valor de uma variável ou desenhar uma imagem na tela do computador, são interconectadas a estruturas lógicas que guiam o fluxo da execução do programa. Isso é muito próximo ao que usamos em nosso cotidiano para realizar atividad...

Google TV: Unboxing e Hello World

Recentemente recebemos um "presente" do Google Brasil, um dispositivo Google TV, modelo Sony NSZ-GT1, e coube a mim a honra de receber esse gadget e fazer o unboxing e um hello world para começar a explorar mais essa aposta do Google ! Conhecendo o Google TV Em maio de 2010, durante o Google I/O, a empresa anunciou a criação em conjunto com a Intel, Sony e Logitech a criação de uma plataforma de "Smart TV". Coube ao Google integrar a TV com o Android e também uma versão baseada em Linux do navegador Chrome. Porém, devido a uma série de fatores, como por exemplo a escassez de conteúdo e a ausência de aplicativos, o Google TV teve seu início competitivo um pouco abalado, inclusive alguns analistas na época diziam que o dispositivo era muito "beta". Pois bem, o Google percebeu que a plataforma não ia muito bem, mas não deixou de apostar na idéia, e durante o Google I/O desse ano eles apresentaram o Google TV 2.0 ! O dispositivo agora recebia um update d...