PDM UD1 Bibliotecas de compatibilidade

Introdución

• Como xa comentamos anteriormente, as bibliotecas de compatibilidade son creados por Android para dar soporte a versións antigas do S.O. Android e que estas poidan executar novas funcionalidades que apareceron en versións posteriores.

• Podedes consultar as melloras a nivel xeral que ofrecen ditas bibliotecas neste enlace.

• Podedes consultar as funcións que incorporan cada unha das bibliotecas de compatibilidade neste enlace.

• Podedes consultar como configurar o Android Studio para descargar e utilizar ditas bibliotecas neste enlace

Exemplo de uso

• Un exemplo de uso sería o uso do ActionBar:

Imaxe obtida desta web

• Dende a versión 3.0 (API 11) todas as activity´s poden levar unha ActionBar (de feito ven no theme por defecto). Pero a medida que foron xurdindo novas versións da API, engadíronse novas funcionalidades.

Por exemplo, a partires da versión API 21 (Android 5) engadíronse novas opcións para modificar o deseño e adaptalo á filosofía do Material Design.

Unha destas propiedades novas é a elevación, que ven ser un efecto como se o compoñente estivera colocado 'por enriba' doutro. No caso da barra de acción (a partires de Android 5 denomínase App Bar) dito método é setElevation e a guía de Material Design indica que debe estar a 4dp.

• Se creamos un novo proxecto cun target_SDK por enriba do 21 e un min_SDK tamén por enriba do 21, poderemos facer uso de dito método:

• Proxecto creado cunha API 28
• 

  Proxecto compilado coa API 28

• 

  MinSDK e TargetSDK coa API 28

• 

  Podemos comprobar como podemos facer uso do método setElevetion.

• 

  Resultado da execución.

• Agora fagamos un proxecto para unha API 19.

• Proxecto creado cunha min_SDK API 19
• 

  Poñemos un minSDK de API 19.

• 

  Comprobamos como a chamada ao método provoca un erro xa que dito método foi incorporado na versión API 21.

• 

  Como se pode comprobar a biblioteca de compatibilidade appcompact-v7 permite facer uso das funcionalidades da ActionBar (ToolBar a partires da API 21). Importante: Na imaxe aparece a versión 24.2.0. Este número ten que corresponder coa versión do Compile Sdk.

• 

  As API´s que aparecen no 'Conpile Sdk' son as que están descargadas dende o SDK Manager.

• 

  Para incorporar unha biblioteca de compatibilidade só temos que escribir implementation 'nome_biblioteca:version' no arquivo build.gradle do módulo. No noso exemplo é: implementation 'com.android.support:appcompat-v7:27.0.0' Non debemos empregar a API 28 xa que cambia o funcionamento.

• 

  Agora existen varias formas de engadir un ToolBar-ActionBar. Unha delas é a de poñer un Theme que incorpore unha barra de acción. No noso exemplo: Theme.AppCompat.Light.DarkActionBar

• 

  Temos que modificar a activity e agora vai ser unha subclase da clase AppCompactActivity. O action bar a obtemos chamando ao método 'getSupportActionBar()'. Podemos ver como xa podemos facer uso de método 'setElevation()'. Indicar que esta forma sería a recomendada para facer uso do ActionBar en calquera versión de Android. Así nos aseguramos que todas van funcionar igual. Se non o facemos así e usamos as ActionBar que foron aparecendo en cada versión das Api´s estaremos limitados as método e propiedades da MinSDK indicada.

• 

  Resultado da execución.

-- Ángel D. Fernández González -- (2018).