PDM UD1 Bibliotecas de compatibilidade - Historial de revisiones

Wiki: /* Versión actual */

2020-08-18T14:20:36Z

Versión actual

Wiki en 13:39 18 ago 2020

2020-08-18T13:39:39Z

Wiki: /* Exemplo de uso */

2019-09-24T14:23:07Z

Exemplo de uso

Wiki: /* Exemplo de uso */

2019-09-23T22:27:17Z

Exemplo de uso

Wiki: /* Exemplo de uso */

2019-09-23T22:22:26Z

Exemplo de uso

Wiki: /* Introdución */

2019-09-23T20:53:44Z

Introdución

Wiki: /* Exemplo de uso */

2019-09-23T20:39:55Z

Exemplo de uso

Wiki: /* Exemplo de uso */

2019-09-23T20:35:53Z

Exemplo de uso

Wiki: /* Exemplo de uso */

2018-09-27T21:55:07Z

Exemplo de uso

Wiki: /* Introdución */

2018-09-27T21:52:48Z

Introdución

@@ Línea 10: / Línea 10: @@
 :* Todas as bibliotecas de compatibilidade están aloxadas nun paquete que comeza polo nome '''androidx'''.
-:* A diferenza das bibliotecas de compatibilidade empregadas anteriormente, éstas se manteñen e actualizan por separado (non fai falla actualizar a biblioteca enteira como pasaba anteriormente).
+:* A diferenza das bibliotecas de compatibilidade empregadas anteriormente, éstas se manteñen e actualizan por separado e non é necesario actualizar todo o S.O. como pasaba antes coas bibliotecas de compatibilidade amdroid.compact.
@@ Línea 19: / Línea 19: @@
 Image:PDM_Artifacts_1.jpg| Cando creamos un novo proxecto debemos marcar a opción '''use androidx.*.artifacts'''. Para que isto aparece debemos ter a lo menos a API 28 ou posterior instalada.
 Image:PDM_Artifacts_2.jpg| Ao facelo, no arquivo '''gradle.properties''' aparecerán dúas propiedades có valor a true (isto teríamos que facelo manualmente se non configuramos o proxecto dende o inicio para facer uso destas bibliotecas): android.useAndroidX e android.enableJetifier.
 </gallery>
 <br />
 ===Exemplo de uso===
-* Podedes atopar [https://developer.android.com/reference/androidx/packages?hl=es-419 neste enlace a lista de paquetes] que se atopan dentro do espazo de nomes androidx.
+* Podedes atopar [https://developer.android.com/jetpack/androidx/versions?hl=es-419 neste enlace] a lista de bibliotecas coas versións actuais que se atopan dentro do espazo de nomes androidx.
@@ Línea 32: / Línea 51: @@
 <br />
 ==Versión antiga==

@@ Línea 4: / Línea 4: @@
 * Podedes consultar as melloras a nivel xeral que ofrecen ditas bibliotecas [https://developer.android.com/topic/libraries/support-library/?hl=es-419 neste enlace].
@@ Línea 16: / Línea 48: @@
 <br />
-=Exemplo de uso=
+===Exemplo de uso===
 * Un exemplo de uso sería o uso do ActionBar:

@@ Línea 25: / Línea 25: @@
 * 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 [https://developer.android.com/design/material/?hl=es-419 Material Design].
+: 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 [https://developer.android.com/design/material/?hl=es-419 Material Design]. De feito a ActionBar pasou a denominarse ToolBar.
 : 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 (Action Bar) que a partires de Android 5 denomínase '''Tool Bar''' ('''App Bar''' está formada por Tool Bar, Status Bar e Tab Bar) dito método é [https://developer.android.com/reference/android/app/ActionBar.html#setElevation(float) 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:
+* Se creamos un novo proxecto cun target_SDK a partires da API 21 e un min_SDK tamén a partires do 21, poderemos facer uso de dito método:
 <gallery caption="Proxecto creado cunha API 28" widths="350" heights="300px" perrow="2">
 Image:PDM_Biblioteca_compat_2.jpg| Proxecto compilado coa API 28

@@ Línea 124: / Línea 124: @@
 Image:PDM_Biblioteca_compat_9.jpg| As API´s que aparecen no 'Conpile Sdk' son as que están descargadas dende o SDK Manager.
 Image:PDM_Biblioteca_compat_10.jpg| Para incorporar unha biblioteca de compatibilidade só temos que escribir <b>implementation 'nome_biblioteca:version'</b> no arquivo '''build.gradle''' do módulo. No noso exemplo é: <b>implementation 'com.android.support:appcompat-v7:27.0.0'</b> Non debemos empregar a API 28 xa que cambia o funcionamento.
-Image:PDM_Biblioteca_compat_11.jpg| 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: <b>Theme.AppCompat.Light.DarkActionBar</b>
+Image:PDM_Biblioteca_compat_11.jpg| 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: <b>Theme.AppCompat.Light.DarkActionBar</b> Eliminamos por tanto no layout da Activity o Toolbar que tiñamos posto.
 Image:PDM_Biblioteca_compat_12.jpg| 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.
 Image:PDM_Biblioteca_compat_13.jpg| Resultado da execución.

@@ Línea 33: / Línea 33: @@
 <gallery caption="Proxecto creado cunha API 28" widths="350" heights="300px" perrow="2">
 Image:PDM_Biblioteca_compat_2.jpg| Proxecto compilado coa API 28
-Image:PDM_Biblioteca_compat_3.jpg| MinSDK e TargetSDK coa API 28
+Image:PDM_Biblioteca_compat_3.jpg| MinSDK 21 (na imaxe aparece 28, pero se pode poñer 21) e TargetSDK coa API 28
 Image:PDM_Biblioteca_compat_4.jpg| Podemos comprobar como podemos facer uso do método '''setElevetion'''.
 Image:PDM_Biblioteca_compat_5.jpg| Resultado da execución.
 </gallery>
 <br />
-* Agora fagamos un proxecto para unha API 19.
+'''Código do layout:'''
 <gallery caption="Proxecto creado cunha min_SDK API 19" widths="350" heights="300px" perrow="2">
 Image:PDM_Biblioteca_compat_6.jpg| Poñemos un minSDK de API 19.

@@ Línea 7: / Línea 7: @@
 * Podedes consultar as melloras a nivel xeral que ofrecen ditas bibliotecas [https://developer.android.com/topic/libraries/support-library/?hl=es-419 neste enlace].
-* Podedes consultar as funcións que incorporan cada unha das bibliotecas de compatibilidade [https://developer.android.com/topic/libraries/support-library/features?hl=es-419 neste enlace].
+* Podedes consultar as funcións que incorporan cada unha das bibliotecas de compatibilidade [https://developer.android.com/topic/libraries/support-library/packages?hl=es-419 neste enlace].
@@ Línea 15: / Línea 15: @@
 <br />
 =Exemplo de uso=

← Revisión anterior	Revisión del 21:52 27 sep 2018
Línea 14:	Línea 14:


	+	<br />
	+	=Exemplo de uso=
	+
	+	* Un exemplo de uso sería o uso do ActionBar:
	+
	+	[[Imagen:PDM_Biblioteca_compat_1.jpg\|500px\|center]]
	+	<small><center>Imaxe obtida [http://www.hermosaprogramacion.com/2014/09/android-action-bar/ desta web]</center></small>
	+
	+
	+	* 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 [https://developer.android.com/design/material/?hl=es-419 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 é [https://developer.android.com/reference/android/app/ActionBar.html#setElevation(float) 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:
	+	<gallery caption="Proxecto creado cunha API 28" widths="350" heights="300px" perrow="2">
	+	Image:PDM_Biblioteca_compat_2.jpg\| Proxecto compilado coa API 28
	+	Image:PDM_Biblioteca_compat_3.jpg\| MinSDK e TargetSDK coa API 28
	+	Image:PDM_Biblioteca_compat_4.jpg\| Podemos comprobar como podemos facer uso do método '''setElevetion'''.
	+	Image:PDM_Biblioteca_compat_5.jpg\| Resultado da execución.
	+	</gallery>
	+
	+
	+
	+	<br />
	+	* Agora fagamos un proxecto para unha API 19.
	+	<gallery caption="Proxecto creado cunha min_SDK API 19" widths="350" heights="300px" perrow="2">
	+	Image:PDM_Biblioteca_compat_6.jpg\| Poñemos un minSDK de API 19.
	+	Image:PDM_Biblioteca_compat_7.jpg\| Comprobamos como a chamada ao método provoca un erro xa que dito método foi incorporado na versión API 21.
	+	Image:PDM_Biblioteca_compat_8.jpg\| 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 <u>versión 24.2.0</u>. Este número ten que corresponder coa versión do '''Compile Sdk'''.
	+	Image:PDM_Biblioteca_compat_9.jpg\| As API´s que aparecen no 'Conpile Sdk' son as que están descargadas dende o SDK Manager.
	+	Image:PDM_Biblioteca_compat_10.jpg\| Para incorporar unha biblioteca de compatibilidade só temos que escribir <b>implementation 'nome_biblioteca:version'</b> 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.
	+	Image:PDM_Biblioteca_compat_11.jpg\| 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
	+	Image:PDM_Biblioteca_compat_12.jpg\| 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.
	+	</gallery>