Angelfg en 08:12 28 jul 2015

2015-07-28T08:12:37Z

Página nueva

==Introdución==
*Tamén temos outras formas de ''personalizar'' as nosas aplicacións en base a unha serie de sufixos.
*Se queremos que as cadeas de constantes estean traducidas a varios idiomas, só temos que crear un cartafol novo de nome '''values-??''' onde ?? é o idioma.
*Para o inglés teriamos '''/res/values-en''', '''/res/values-es''' para o español,....
*O idioma por defecto será o que estea gardado en '''/res/values'''.
*So se deben cambiar os valores das contanstes, os identificadores deben ser os mesmos.

*'''Referencias''':
**Localización: http://developer.android.com/guide/topics/resources/localization.html

==Caso práctico==
*Crear un novo proxecto: '''U2_41_Internacional'''
*Imos en '''/res/values''' definimos as cadeas de texto en galego e esas mesmas cadeas as definimos en inglés en /res/values-en'''.
*Para probar a aplicación hai que cambiar o idioma do sistema como se viu na Unidade 1.
<gallery caption="TableLayout Dinánico" widths="350" heights="300px" perrow="2">
Image:Android_2013_U2_41_Internacional_01.jpg| Cartafois de recursos: values e values-en. cada un co seu ficheiro de strings.
Image:Android_2013_U2_41_Internacional_02.jpg| A aplicación está en galego, tanto no layout como no código (Toast).
Image:Android_2013_U2_41_Internacional_03.jpg| E o mesmo pasa en inglés. O layout e o código Java é o mesmo para os dous casos.
</gallery>

===strings.xml de /res/values===

<syntaxhighlight lang="xml" line enclose="div" highlight="1" >
<?xml version="1.0" encoding="utf-8"?>
<resources>

<string name="app_name">U2_41_Internacional</string>
<string name="action_settings">Settings</string>
<string name="idioma">Esta aplicación, por defecto, está en galego!</string>
<string name="boton">Preme aquí</string>
<string name="mensaxe_toast">Premeches o botón!</string>

</resources>

</syntaxhighlight>

===strings.xml de /res/values-en===

<syntaxhighlight lang="xml" line enclose="div" highlight="1" >
<?xml version="1.0" encoding="utf-8"?>
<resources>

<string name="app_name">U2_41_Internacional</string>
<string name="action_settings">Settings</string>
<string name="idioma">This app is by default in galician language!</string>
<string name="boton">Click here</string>
<string name="mensaxe_toast">You have clicked on the button!</string>

</resources>

</syntaxhighlight>

===O XML do layout===

<syntaxhighlight lang="xml" line enclose="div" highlight="10,15,16" >
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >

<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/idioma" />

<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/boton"
android:onClick="onBotonClick" />

</LinearLayout>

</syntaxhighlight>
*'''Liñas 10 e 15''': Agora temos que traballar con constantes, non podemos poñer o texto a ''lume''.

===O código Java===
<syntaxhighlight lang="java" line enclose="div" highlight="25" >
package com.example.u2_41_internacional;

import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.widget.Toast;

public class U2_41_Internacional extends Activity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_u2_41__internacional);
}

@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.u2_41__internacional, menu);
return true;
}

public void onBotonClick(View v) {
Toast.makeText(this, R.string.mensaxe_toast, Toast.LENGTH_SHORT).show();
}
}

</syntaxhighlight>
*'''Liña 25''' observar como o toast tamén colle a cadea de texto dos recursos tipo string.

==Consideracións a ter en conta==

Estes sufixos que estamos a utilizar (-land; -es) poden ser combinados entre eles e con outros moitos diferentes.

No seguinte [http://developer.android.com/guide/topics/resources/providing-resources.html#table2 enlace] aparece dita orde de prefixos.

Por exemplo:
*res/values-en-rUS/strings.xml
*res/values-en-rUK/strings.xml

Onde o segundo sufixo fai referencia a inglés ‘americano’ (en-rUS) ou ‘ inglés’ do Reino Unido (en-rUK).

<u>Nota</u>: a letra r fai referencia á rexión.

Para facilitarnos o traballo, Eclipse dispón dunha pantalla na que podemos indicar que 'características' queremos que teña o noso arquivo de recursos e automaticamente xa engade por nós os sufixos necesarios.

Cando creamos un arquivo de recursos aparece a seguinte pantalla:

[[Archivo:Android_2013_U2_41_Internacional_04.jpg|300px|thumb|left]]

<div style="clear:both;">

Se prememos o botón 'Next' pasamos á pantalla comentada anteriormente. Neste exemplo estamos a crear un recurso de tipo layout para pantallas de 7-10 pulgadas (tamaño x-large), entón teríamos que crear un layout nun cartafol ‘layout-xlarge’:

[[Archivo:Android_2013_U2_41_Internacional_05.jpg|300px|thumb|left]]

* Debemos pasar a 'propiedade' SIZE dende a lista da esquerda á dereita (premendo o botón coa dirección dereita). Unha vez pasada debemos darlle un valor, no noso caso x-large.
* Ó facelo, podedes observar como na parte baixa aparece o nome co sufixo correcto.

<div style="clear:both;">

Podemos combinar moitas máis 'propiedades'. Así, no seguinte exemplo, estamos a crear un arquivo de recursos de tipo 'Values' que se cargará cando utilicemos un dispositivo Android, co idioma Español, nunha pantalla de tipo Small e cunha densidade Media.

[[Archivo:Android_2013_U2_41_Internacional_06.jpg|300px|thumb|left]]

* O sufixo que crea neste caso será: -es-small-mdpi.

<div style="clear:both;">

*Na versión '''Lollipop''' (API 21, android 5.0) xa se inclúe o idioma galego.

<br> -- [[Usuario:angelfg|Ángel D. Fernández González]] e [[Usuario:Carrion|Carlos Carrión Álvarez]] -- (2015).

Internacionalización - Historial de revisiones

Angelfg en 08:12 28 jul 2015