This is an old revision of the document!


Colocviu 1

Model de Subiect

Observații Generale

Pentru rezolvarea subiectelor propuse în cadrul colocviului 1, sunt necesare:

  • un cont Github personal, pe care să existe drepturi de citire și de scriere;
  • SDK-ul de Android (cu o imagine pentru nivelul de API 16 - Jelly Bean 4.1);
  • mediul de dezvoltare integrat (Eclipse împreună cu plugin-ul Android Developer Tools sau Android Studio);
  • un dispozitiv mobil:
    • fizic (bring your own device);
    • virtual: Genymotion, AVD.

Rezolvări

Proiectul Eclipse corespunzător aplicației Android ce conține rezolvările complete ale cerințelor colocviului este disponibil pe contul de Github al disciplinei.

A.1. Se accesează Github și se realizează autentificarea în contul personal, prin intermediul butonului Sign in.

Se creează o zonă de lucru corespunzătoare unui proiect prin intermediului butonului New Repository.

Configurarea depozitului la distanță presupune specificarea:

  • unei denumiri;
  • unei descrieri (opțional);
  • tipului de director (public sau privat - doar contra cost!!!);
  • modului de inițializare:
    • local, prin git init;
    • la distanță, prin git clone - depozitul la distanță nu trebuie să fie vid, în această situațoe
  • unui fișier README (opțional);
  • extensiilor ignorate (corespunzătoare limbajului de programare folosit, în cazul de față - Android) - incluse în fișierul .gitignore;
  • tipului de licență sub care este publicat codul sursă.

A.2. Prin intermediul comenzii git clone se poate descărca întregul conținut în directorul curent (de pe discul local), inclusiv istoricul complet al versiunilor anterioare (care poate fi ulterior reconstituit după această copie, în cazul coruperii informațiilor stocate pe serverul la distanță).

În situația în care se dorește clonarea conținutului din depozitul la distanță în alt director decât cel curent, acesta poate fi transmis ca parametru al comenzii, după URL-ul la care poate fi accesat proiectul în Github.

student@eim2016:~$ git clone https://www.github.com/perfectstudent/PracticalTest01

A.3. Se urmăresc indicațiile disponibile în secțiunea Crearea unei aplicații Android în Eclipse Mars 1 (4.5.1) sau Crearea unei aplicații Android în Android Studio 1.5.1.

A.4. Implementarea interfeței grafice va fi realizată prin intermediul unui fișier .xml care va fi plasat în directorul /res/layout al proiectului.

De cele mai multe ori, interfața grafică poate fi realizată în două moduri:

  • prin folosirea unui singur container de tip RelativeLayout în care vor fi plasate toate controalele, având poziția definită relativ unele la celelalte sau la marginile părintelui în care sunt incluse;
  • prin folosirea mai multor containere de tip LinearLayout, imbricate, având orientări diferite (orizontal - implicit, sau vertical).
  • Varianta 1 - un singur container de tip RelativeLayout

Dacă se dorește ca un anumit control să fie aliniat cu un control care se găsește deasupra sa (aliniere pe orizontală), acesta va fi indicat ca valoare pentru proprietățile android:layout_alignLeft și android:layout_alignRight (proprietatea android:layout_width fiind ignorată în acest caz). În mod similar, dacă se dorește alinierea cu un control aflat la stânga (aliniere pe verticală), acesta va fi precizat ca valoare pentru proprietățile android:layout_alignTop și android:layout_alignBottom (proprietatea android:layout_height fiind ignorată în acest caz).

activity_practical_test01_main.xml
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  tools:context="ro.pub.cs.systems.eim.practicaltest01.PracticalTest01MainActivity" >
 
  <Button
    android:id="@+id/navigate_to_secondary_activity_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_alignParentTop="true"
    android:layout_alignParentRight="true"
    android:text="@string/navigate_to_secondary_activity" />
 
  <EditText
    android:id="@+id/left_edit_text"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:saveEnabled="false"
    android:enabled="false"
    android:inputType="number"
    android:ems="7"
    android:layout_alignParentLeft="true"
    android:layout_below="@id/navigate_to_secondary_activity_button"
    android:gravity="center" />
 
  <EditText
    android:id="@+id/right_edit_text"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:saveEnabled="false"
    android:enabled="false"   
    android:inputType="number"
    android:ems="7"
    android:layout_alignParentRight="true"
    android:layout_below="@id/navigate_to_secondary_activity_button"	        
    android:gravity="center" />
 
  <Button
    android:id="@+id/left_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_alignLeft="@id/left_edit_text"
    android:layout_below="@id/left_edit_text"
    android:layout_alignRight="@id/left_edit_text"
    android:text="@string/press_me" />
 
  <Button
    android:id="@+id/right_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_alignLeft="@id/right_edit_text"
    android:layout_alignRight="@id/right_edit_text"
    android:layout_below="@id/right_edit_text"		      
    android:text="@string/press_me_too" />
 
</RelativeLayout>
  • Varianta 2 - mai multe containere de tip LinearLayout imbricate

Dacă se dorește ca un anumit control să ocupe o anumită proporție în cadrul continerului, se va utiliza proprietatea android:layout_weight, însă pentru a fi luată în considerare, atributul android:layout_width, respectiv android:layout_height (în funcție de coordonata pe care se dorește obținerea unei astfel de funcționalități) trebuie să aibă valoarea 0dp.

activity_practical_test01_main.xml
<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="wrap_content"
  android:orientation="vertical"
  tools:context="ro.pub.cs.systems.eim.practicaltest01.PracticalTest01MainActivity" >
 
  <LinearLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content" >
 
    <EditText
      android:id="@+id/left_edit_text"
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1"
      android:enabled="false"
      android:inputType="number"
      android:gravity="center" />
 
    <EditText
      android:id="@+id/right_edit_text"
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1"
      android:enabled="false"  
      android:inputType="number"
      android:gravity="center" />
 
  </LinearLayout>
 
  <LinearLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:baselineAligned="false" >
 
    <ScrollView
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1">
 
      <Button
        android:id="@+id/left_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="@string/press_me" />
 
    </ScrollView>
 
    <ScrollView
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1">
 
      <Button
        android:id="@+id/right_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="@string/press_me_too" />
 
    </ScrollView>
 
  </LinearLayout>
 
</LinearLayout>
  • Varianta 3 - un container de tip LinearLayout vertical care include un control grafic de tip Button și un container GridLayout, cu 2 linii și 2 coloane; pe linia 0 se vor găsi cele 2 câmpuri text editabile, a căror lungime trebuie să fie specificată explicit iar pe linia 1 cele două butoane, a căror aliniere (centrată pe orizontală raportat la celula din care fac parte) trebuie să fie precizată
activity_practical_test01_main.xml
<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:paddingBottom="@dimen/activity_vertical_margin"
  android:paddingLeft="@dimen/activity_horizontal_margin"
  android:paddingRight="@dimen/activity_horizontal_margin"
  android:paddingTop="@dimen/activity_vertical_margin"
  android:orientation="vertical"
  tools:context="ro.pub.cs.systems.eim.practicaltest01.PracticalTest01MainActivity" >
 
  <Button
    android:id="@+id/navigate_to_secondary_activity_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@string/navigate_to_secondary_activity"/>
 
    <GridLayout
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:rowCount="2"
      android:columnCount="2">
 
      <EditText
        android:id="@+id/left_edit_text"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:saveEnabled="false"
	android:enabled="false"
	android:inputType="number"
	android:ems="6"
	android:layout_row="0"
	android:layout_column="0"
	android:layout_gravity="center"
	android:gravity="center"/>
 
      <EditText
	android:id="@+id/right_edit_text"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:saveEnabled="false"
	android:enabled="false"
	android:inputType="number"
	android:ems="6"
	android:layout_row="0"
	android:layout_column="1"
	android:layout_gravity="center"
	android:gravity="center" />
 
      <Button
	android:id="@+id/left_button"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:layout_row="1"
	android:layout_column="0"
	android:layout_gravity="center"
	android:text="@string/press_me" />
 
      <Button
	android:id="@+id/right_button"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:layout_row="1"
	android:layout_column="1"
	android:layout_gravity="center"
	android:text="@string/press_me_too" />
 
  </GridLayout>
 
</LinearLayout>

În activitatea corespunzătoare, interfața grafică definită în fișierul .xml trebuie încărcată pe metoda onCreate() prin intermediul setContentView(), căreia i se transmite ca parametru identificatorul (referința) către această resursă (așa cum a fost generată în clasa abstractă R.layout). În situația în care este necesar să se realizeze anumite operații pe controalele grafice componente (spre exemplu, să se încarce conținutul acestora), trebuie inițial să se obțină o referință către aceasta printr-un apel al metodei findViewById(), care primește de asemenea ca parametru identificatorul (referința) către această resursă (așa cum a fost generată în clasa abstractă R.id).

Nu este necesar să se implementeze metodele onCreateOptionsMenu(), respectiv onOptionsItemSelected(), acestea fiind de regulă generate în mod automat de mediul integrat de dezvoltare Eclipse.

PracticalTest01Activity.java
package ro.pub.cs.systems.eim.practicaltest01;
 
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
 
public class PracticalTest01MainActivity extends Activity {
 
  private EditText leftEditText = null;
  private EditText rightEditText = null;
  private Button leftButton = null;
  private Button rightButton = null;
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_practical_test01_main);
 
    leftEditText = (EditText)findViewById(R.id.left_edit_text);
    rightEditText = (EditText)findViewById(R.id.right_edit_text);
    leftEditText.setText(String.valueOf(0));
    rightEditText.setText(String.valueOf(0));
 
    leftButton = (Button)findViewById(R.id.left_button);
    rightButton = (Button)findViewById(R.id.right_button);
  }
 
  @Override
  public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.practical_test01, menu);
    return true;
  }
 
  @Override
  public boolean onOptionsItemSelected(MenuItem item) {
    int id = item.getItemId();
    if (id == R.id.action_settings) {
      return true;
    }
    return super.onOptionsItemSelected(item);
  }
}

În mediul integrat de dezvoltare Eclipse, completarea automată a import-urilor necesare este realizată prin Ctrl+Shift+O.

În mediul integrat de dezvoltare Android Studio, completarea automată a import-urilor necesare este realizată prin Alt+Enter.

B.1. Pentru procesarea evenimentelor legate de interacțiunea de utilizator este necesară:

  • implementarea unei clase ascultător pentru tipul de eveniment respectiv (se recomandă se se folosească o clasă internă - în cadrul activității -, cu nume);
  • înregistrarea unui obiect - instanță a clasei - ca ascultător al controlului grafic, pentru tipul de eveniment respectiv.

Se recomandă să se utilizeze aceeași clasă / același obiect pentru tratarea evenimentelor de același tip, chiar dacă acestea vor fi asociate unor controale grafice diferite. În cazul în care este necesar să se realizeze procesări specifice pentru obiecte de același tip, se va realiza distincția dintre acestea prin intermediul identificatorului controlului grafic care le este asociat.

Pe metoda onCreate() a activității se obțin referințe ale controlului grafic (prin metoda findViewById()) și se înregistrează obiectul ascultător respectiv.

În situația în care în interfața grafică există mai multe obiecte de același tip, având în vedere că operațiile ce trebuie realizate pentru fiecare în parte sunt aceleași, acestea se pot grupa prin procesarea iterativă unui tablou de identificatori (referințe) ale controalelor grafice respective.

public class PracticalTest01MainActivity extends Activity {
 
  private ButtonClickListener buttonClickListener = new ButtonClickListener();
  private class ButtonClickListener implements View.OnClickListener {
    @Override
    public void onClick(View view) {
      switch(view.getId()) {
        case R.id.left_button:
          int leftNumberOfClicks = Integer.parseInt(leftEditText.getText().toString());
          leftNumberOfClicks++;
          leftEditText.setText(String.valueOf(leftNumberOfClicks));
          break;
        case R.id.right_button:
          int rightNumberOfClicks = Integer.parseInt(rightEditText.getText().toString());
          rightNumberOfClicks++;
          rightEditText.setText(String.valueOf(rightNumberOfClicks));
          break;
      }
    }
  }
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
 
    // ...
 
    leftButton.setOnClickListener(buttonClickListener);
    rightButton.setOnClickListener(buttonClickListener);       
  }
 
  // ...
 
}

B.2.

a) Pentru majoritatea controalelor grafice, sistemul de operare Android realizează în mod automat salvarea / restaurarea stării în situația în care o activitate este distrusă pentru asigurarea necesarului de memorie. Dacă se dorește ca această operație să fie tratată în alt mod, dezactivarea acestui mecanism se realizează prin specificarea atributului android:saveEnabled corespunzător controlului grafic respectiv având valoarea false.

<LinearLayout ... >
  <EditText
    android:id="@+id/left_edit_text"
    android:saveEnabled="false"
    ... />
 
  <EditText
    android:id="@+id/right_edit_text"
    android:saveEnabled="false"
    ... />
 
  <!-- other nested layouts or widgets -->
 
</LinearLayout>

b) În situația în care sistemul de operare Android distruge activitatea pentru asigurarea resurselor necesare, este necesară asigurarea unui comportament consistent / persistenței aplicației:

  • salvarea stării se realizează pe metoda onSaveInstanceState() care primește un parametru de tip Bundle în care vor fi stocate informațiile respective, identificarea lor realizându-se prin intermediul unei chei de tip șir de caractere; metoda este invocată înainte de onStop() deși pot exista situații în care aceasta este apelată chiar înainte de onPause();
  • restaurarea stării se realizează:
    • pe metoda onCreate() pentru care parametrul de tip Bundle este nenul în situația în care există o stare anterioară;
    • pe metoda onRestoreInstanceState() care este invocată în mod automat - primind un parametru de tip Bundle numai în situația în care există o stare anterioară; metoda se apelează între metodele onStart() și onRestore().

În parametrul de tip Bundle nu pot fi stocate decât obiecte care implementează android.os.Parcelable.

Salvarea stării implică plasarea în obiectul de tip Bundle a unei valori, prin metode de tip put<type>(), folosind un șir de caractere definit de utilizator (o convenție de nume).

Restaurarea stării implică preluarea în obiectul de tip Bundle a valorii, prin metode de tip get<type>(), folosind șirul de caractere corespunzător (convenția de nume). Se recomandă să se verifice faptul că valoarea respectivă este nenulă (respectiv nu a fost furnizată valoarea implicită).

Se recomandă ca restaurarea stării să fie realizată pe metoda onRestoreInstanceState() în detrimentul metodei onCreate() pentru că în acest fel nu trebuie să se verifice starea obiectului de tip Bundle, iar procesările în urma cărora este creată o instanță a activității sunt mai rapide.

public class PracticalTest01MainActivity extends Activity {
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
 
    // ...
 
    if (savedInstanceState != null) {
      if (savedInstanceState.containsKey("leftCount")) {
        leftEditText.setText(savedInstanceState.getString("leftCount"));
      } else {
        leftEditText.setText(String.valueOf(0));
      }
      if (savedInstanceState.containsKey("rightCount")) {
        rightEditText.setText(savedInstanceState.getString("rightCount"));
      } else {
        rightEditText.setText(String.valueOf(0));
      }
    } else {
      leftEditText.setText(String.valueOf(0));
      rightEditText.setText(String.valueOf(0));
    }
  }
 
  @Override
  protected void onSaveInstanceState(Bundle savedInstanceState) {
    savedInstanceState.putString("leftCount", leftEditText.getText().toString());
    savedInstanceState.putString("rightCount", rightEditText.getText().toString());
  }
 
  @Override
  protected void onRestoreInstanceState(Bundle savedInstanceState) {
    if (savedInstanceState.containsKey("leftCount")) {
      leftEditText.setText(savedInstanceState.getString("leftCount"));
    } else {
      leftEditText.setText(String.valueOf(0));
    }
    if (savedInstanceState.containsKey("rightCount")) {
      rightEditText.setText(savedInstanceState.getString("rightCount"));
    } else {
      rightEditText.setText(String.valueOf(0));
    }
  }
 
  // ...
}  

c) Pentru a simula faptul că sistemul de operare Android distruge activitatea pentru asigurarea necesarului de resurse, se poate proceda astfel:

  1. se oprește activitatea prin accesarea butonului Menu, astfel încât activitatea să rămână în memorie, fără a fi însă vizibilă, asigurându-se totodată apelarea metodelor onPause() și onStop() și implicit a metodei onSaveInstanceState();
  2. în DDMS, se identifică procesul corespunzător activății respective și se oprește forțat (prin intermediul butonului Stop);
  3. se (re)pornește activitatea din meniul dispozitivului mobil, astfel încât să se apeleze metodele onCreate(), respectiv onStart() și onResume() (și, implicit, onRestoreInstanceState()).

În mediul integrat de dezvoltare Eclipse, DDMS (Dalvik Debug Monitor System) este pornit din WindowOpen PerspectiveOtherDDMS.

În mediul integrat de dezvoltare Android Studio, DDMS (Dalvik Debug Monitor System) este pornit din ToolsAndroidAndroid Device Monitor.

d) În situația în care utilizatorul apasă butonul Back, se apelează metodele onPause(), onStop() și onDestroy(), fără a se invoca însă și metoda onSaveInstanceState() întrucât se consideră că în această situație utilizatorul nu își dorește să revină la starea curentă a activității. Din acest motiv, starea nu este salvată în obiectul de tip Bundle și acesta nu va conține informațiile respective care să poată fi astfel restaurate.

Dacă se dorește salvarea / restaurarea stării în situația în care utilizatorul apasă tasta Back, se recomandă să se utilizeze un alt mecanism pentru asigurarea persistenței, cum ar fi baza de date SQLite sau un obiect de tipul android.content.SharedPreferences.

C.1. Într-o aplicație Android, o activitate trebuie să fie precizată prin următoarele elemente:

  • o etichetă de tip <activity> în fișiserul AndroidManifest.xml, având asociată și un filtru de intenții (etichetă de tip <intent-filter>);
  • o interfață grafică, definită în cadrul unui fișier .xml în directorul /res/layout;
  • o clasă derivată din Activity, în care să se implementeze cel puțin metoda onCreate(), pe care să se încarce interfața grafică definită anterior.

Crearea acestor resurse este realizată în mod automat în mediul integrat de dezvoltare Eclipse în momentul în care se solicită definirea unei resurse de tip Android Activity (FileNewOtherAndroidAndroid Activity).

a) În fișierul AndroidManifest.xml se specifică activitatea printr-o element de tip <activity> în cadrul etichetei <application> pentru care se definesc:

  • atributul android:name în care se indică denumirea clasei de tip Activity care va gestiona activitatea (afișarea interfeței grafice și tratarea interacțiunii cu utilizatorul);
  • atributul android:label precizează o etichetă care va fi asociată activității;
  • un filtru de intenții, prin care se controlează modul în care va putea fi lansată în execuție prin intermediul unei alte intenții:
    • eticheta <action> stabilește acțiunea pe care o poate realiza activitatea; va avea o valoare definită de utilizator, reprezentând o convenție;
    • eticheta <category> clasifică activitatea, impunându-se să fie folosită valoarea android.intent.category.DEFAULT pentru ca activitatea să poată fi invocată prin intermediul unei intenții.

În cazul în care activitatea este generată folosind mediul integrat de dezvoltare Eclipse, în fișierul AndroidManifest.xml nu se completează în mod automat și filtrul de intenții, fiind necesar ca acesta să fie menționat de utilizator, manual.

AndroidManifest.xml
<manifest ... >
  <application ... >
    <activity
      android:name=".PracticalTest01SecondaryActivity"
      android:label="@string/title_activity_practical_test01_secondary" >
      <intent-filter>
        <action android:name="ro.pub.cs.systems.eim.intent.action.PracticalTest01SecondaryActivity" />
        <category android:name="android.intent.category.DEFAULT" />
      </intent-filter>
    </activity>
  </application>
</manifest>

b) O interfață grafică este definită în mod obișnuit, prin intermediul unui fișier .xml plasat în directorul /res/layout în care sunt precizate controalele grafice cu atributele și valorile lor, sub formă de componente în cadrul unor mecanisme de dispunere.

activity_practical_test01_secondary.xml
<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"
  tools:context="ro.pub.cs.systems.eim.practicaltest01.PracticalTest01SecondaryActivity" >
 
  <TextView
    android:id="@+id/number_of_clicks_text_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center" />
 
  <LinearLayout
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="center" >
 
    <Button
      android:id="@+id/ok_button"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="@string/ok" />
 
    <Button
      android:id="@+id/cancel_button"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="@string/cancel" />
 
  </LinearLayout>
 
</LinearLayout>

c) În clasa care gestionează comportamentul activității, pe metoda onCreate(), în mod obișnuit, se încarcă interfața grafică (prin metoda setContentView()), se obțin referințe către controalele grafice (printr-un apel al metodei findViewById()) și se stabilește conținutul acestora, respectiv se înregistrează obiecte ascultător pentru anumite tipuri de evenimente (după ce în prealabil a fost implementată și clasa corespunzătoare).

Pentru activitățile care sunt invocate prin intermediul unei intenții:

  • se poate obține o referință către intenție, din contextul căruia pot fi obținute informațiile atașate în secțiunea extra prin intermediul metodelor getExtras() sau get<type>Extra() care primesc ca parametru cheia sub care au fost stocate datele respective;
  • se poate transmite un rezultat înapoi către activitatea din care au fost invocate prin intermediul metodei setResult() care primește ca parametri:
    • un cod de rezultat întreg (frecvent, sunt folosite valorile RESULT_OK și RESULT_CANCELED, dar poate fi folosită și o valoare definită de utilizator);
    • o intenție, în care pot fi plasate informații suplimentare.

Metoda finish() poate fi folosită pentru a finaliza activitatea în mod forțat (semnalând faptul că procesările corespunzătoare activității au fost terminate).

PracticalTest01SecondaryActivity.java
package ro.pub.cs.systems.eim.practicaltest01;
 
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
 
public class PracticalTest01SecondaryActivity extends Activity {
 
  private TextView numberOfClicksTextView = null;
  private Button okButton = null;
  private Button cancelButton = null;
 
  private ButtonClickListener buttonClickListener = new ButtonClickListener();
  private class ButtonClickListener implements View.OnClickListener {
    @Override
    public void onClick(View view) {
      switch(view.getId()) {
        case R.id.ok_button:
          setResult(RESULT_OK, null);
          break;
        case R.id.cancel_button:
          setResult(RESULT_CANCELED, null);
          break;
      }
      finish();
    }
  }
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_practical_test01_secondary);
 
    numberOfClicksTextView = (TextView)findViewById(R.id.number_of_clicks_text_view);
    Intent intent = getIntent();
    if (intent != null && intent.getExtras().containsKey("numberOfClicks")) {
      int numberOfClicks = intent.getIntExtra("numberOfClicks", -1);
      numberOfClicksTextView.setText(String.valueOf(numberOfClicks));
    }
 
    okButton = (Button)findViewById(R.id.ok_button);
    okButton.setOnClickListener(buttonClickListener);
    cancelButton = (Button)findViewById(R.id.cancel_button);
    cancelButton.setOnClickListener(buttonClickListener);
  }
 
  @Override
  public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.practical_test01_secondary, menu);
    return true;
  }
 
  @Override
  public boolean onOptionsItemSelected(MenuItem item) {
    int id = item.getItemId();
    if (id == R.id.action_settings) {
      return true;
    }
    return super.onOptionsItemSelected(item);
  }
}

C.2. Pentru a invoca o altă activitate prin intermediul unei intenții, o activitate trebuie:

  • să definească în interfața grafică un control prin intermediul căruia va fi lansată în execuție activitatea respectivă (în fișierul .xml din directorul /res/layout);
<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="wrap_content"
  android:orientation="vertical"
  tools:context="ro.pub.cs.systems.eim.practicaltest01.PracticalTest01MainActivity" >
 
  <Button
    android:id="@+id/navigate_to_secondary_activity_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="right"
    android:text="@string/navigate_to_secondary_activity" />
 
  <!-- other nested layouts or widgets -->
 
</LinearLayout>
  • în codul sursă corespunzător clasei care gestionează activitatea respectivă:
    1. pe metoda onCreate():
      1. să obțină o referință către controlul grafic prin intermediul căruia va fi lansată în execuție o altă activitate;
      2. să înregistreze un obiect ascultător care va trata evenimentul legat de controlul grafic respectiv;
    2. să definească o clasă ascultător (internă, cu nume) pentru tipul de eveniment respectiv, iar pe metoda de tratare se vor realiza următoarele operații:
      1. se va instanția un obiect de tip Intent, care poate primi ca parametru:
        1. contextul curent (obiectul this) și clasa care deservește activitatea (obiect de tip .class) - adecvată situației în care activitatea invocată se găsește în aceeași aplicație ca și activitatea care invocă;
        2. acțiunea asociată activității în filtrul de intenții - adecvată situației în care activitatea invocată se găsește în altă aplicație decât activitatea care o invocă;
      2. se asociază un set de informații care vor fi transmise celeilalte activități (în secțiunea extra a intenției) prin intermediul metodei putExtra(), fiecare valoare (de tip android.os.Parcelable) având asociat un atribut prin care va fi identificat ulterior, de tip șir de caractere;
      3. se lansează în execuție activitatea prin intermediul metodei startActivityForResult() care primește ca parametru intenția și un cod de cerere, având rolul de a identifica ulterior instanța activității din care se revine.
    3. să implementeze metoda onActivityResult(), apelată în mod automat la revenirea din activitatea invocată, aceasta primind ca parametrii:
      1. codul de cerere trimis în momentul în care activitatea a fost lansată în execuție;
      2. rezultatul furnizat de activitatea invocată;
      3. intenția generată de activitatea invocată.
public class PracticalTest01MainActivity extends Activity {
 
  private final static int SECONDARY_ACTIVITY_REQUEST_CODE = 1;
 
  private Button navigateToSecondaryActivityButton = null;
 
  private ButtonClickListener buttonClickListener = new ButtonClickListener();
  private class ButtonClickListener implements Button.OnClickListener {
 
    @Override
    public void onClick(View view) {
      switch(view.getId()) {
        case R.id.navigate_to_secondary_activity_button:
          Intent intent = new Intent(getApplicationContext(), PracticalTest01SecondaryActivity.class);
	  int numberOfClicks = Integer.parseInt(leftEditText.getText().toString()) + 
                               Integer.parseInt(rightEditText.getText().toString());
          intent.putExtra("numberOfClicks", numberOfClicks);
          startActivityForResult(intent, SECONDARY_ACTIVITY_REQUEST_CODE);
          break;
        // ...
      }
    }
 
  }
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
 
    navigateToSecondaryActivityButton = (Button)findViewById(R.id.navigate_to_secondary_activity_button);
    navigateToSecondaryActivityButton.setOnClickListener(buttonClickListener);     
  }
 
  @Override
  protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
    if (requestCode == SECONDARY_ACTIVITY_REQUEST_CODE) {
      Toast.makeText(this, "The activity returned with result " + resultCode, Toast.LENGTH_LONG).show();
    }
  }
 
  // ...
 
}

D.3. Pentru încărcarea codului în contextul depozitului din cadrul contului Github personal:

  1. se transferă modificările din zona de lucru în zona de lucru în zona de așteptare prin intermediul comenzii git add, indicându-se și fișierele respective (pot fi folosite șabloane pentru a desemna mai multe fișiere);
  2. se consemnează modificările din zona de așteptare în directorul Git prin intermediul comenzii git commit -m, precizându-se și un mesaj sugestiv:
  3. se încarcă modificările la distanță, prin intermediul comenzii git push, care primește ca parametrii:
    1. sursa (prin eticheta origin se indică depozitul de unde au fost descărcat conținutul);
    2. destinația: ramificația curentă (implicit, aceasta poartă denumirea master).
student@eim2016:~/PracticalTest01$ git add *
student@eim2016:~/PracticalTest01$ git commit -m "finished tasks for PracticalTest01"
student@eim2016:~/PracticalTest01$ git push origin master

În cazul în care este necesar, vor fi configurați parametrii necesari operației de consemnare (numele de utilizator și adresa de poștă electronică):

student@eim2016:~/PracticalTest01$ git config --global user.name "Perfect Student"
student@eim2016:~/PracticalTest01$ git config --global user.email perfectstudent@cs.pub.ro
eim/colocvii/colocviu01.1459006356.txt.gz · Last modified: 2016/03/26 17:32 by tmp.andrei.cojocaru
CC Attribution-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0