====== Colocviu 1 ======

===== Model de Subiect =====

<HTML>
<center>
</HTML>

{{url>http://eim2016.andreirosucojocaru.ro/_media/colocvii/colocviu01/eim2016-tp01-varsim.pdf 90%,800px}}

<HTML>
</center>
</HTML>

{{ :colocvii:colocviu01:eim2016-tp01-varsim.pdf }}

===== 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.

<hidden>În situația în care lucrați pe calculatoarele din laboratorul Ixia (EG106) este recomandat să folosiți:
  * fluxbox ca utilitar pentru gestiunea ferestrelor (se alege din interfața de autentificare); 
  * epiphany pentru navigare Internet.
Este de preferat să nu se depășească memoria disponibilă, întrucât comportamentul acestor mașini este imprevizibil în momentul în care se folosește swap-ul (se blochează, fără posibilitatea de recuperare din eroare).</hidden>

===== Rezolvări =====

Proiectele Eclipse / Android Studio corespunzătoare aplicației Android ce conține rezolvările complete ale cerințelor colocviului sunt disponibile pe [[https://github.com/eim2016/PracticalTest01|contul de Github al disciplinei]].

**A.1.** Se accesează [[https://www.github.com|Github]] și se realizează autentificarea în contul personal, prin intermediul butonului //Sign in//.

{{ :colocvii:colocviu01:github_authentication.png?nolink&700 }}

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

{{ :colocvii:colocviu01:github_new_repository.png?nolink }}

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ă.

{{ :colocvii:colocviu01:github_repository_configuration.png?nolink }}

**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ță).

<note>Î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.</note>

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

**A.3.** Se urmăresc indicațiile disponibile în secțiunea [[:laboratoare:laborator01#crearea_unei_aplicatii_android_in_eclipse_mars_1_451_-_obligatoriu|Crearea unei aplicații Android în Eclipse Mars 1 (4.5.1)]] sau [[:laboratoare:laborator01#crearea_unei_aplicatii_android_in_android_studio_151_-_obligatoriu|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''
<note tip>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). </note> <file xml 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>
</file>

  * Varianta 2 - mai multe containere de tip ''LinearLayout'' imbricate
<note tip>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''.</note>

<file xml 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>
</file>

  * 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ă

<file xml 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>
</file>

Î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'').

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

<file java 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);
  }
}
</file>

Î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.

<note>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.</note>

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

<note tip>Î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.</note>

<code java>
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);       
  }
  
  // ...
  
}
</code>

**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''.

<code xml>
<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>
</code>

**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()''.

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

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ă).

<note tip>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.</note>

<code java>
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));
    }
  }
  
  // ...
}  
</code>

**c)** Pentru a simula faptul că sistemul de operare Android distruge activitatea pentru asigurarea necesarului de resurse, se poate proceda astfel:
  - 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()'';
  - în Eclipse, se deschide Dalvik Debug Monitor System (DDMS), se identifică procesul corespunzător activății respective și se oprește forțat (prin intermediul butonului //Stop//);\\ {{ :colocvii:colocviu01:dalvik_debug_monitor_system.png?nolink&700 }}
  - în Android Studio, în secțiunea //AndroidMonitor//, se oprește aplicația Android prin intermediul butonului //Terminate Application//: \\ {{ :colocvii:colocviu01:android_monitor.png?nolink&900 }}
  - se (re)pornește activitatea din meniul dispozitivului mobil, astfel încât să  se apeleze metodele ''onCreate()'', respectiv ''onStart()'' și ''onResume()'' (și, implicit, ''onRestoreInstanceState()'').

<note tip>
În mediul integrat de dezvoltare Eclipse, DDMS (Dalvik Debug Monitor System) este pornit din //Window// → //Open Perspective// → //Other// → //DDMS//.

În mediul integrat de dezvoltare Android Studio, AMS (Android Device Monitor) este pornit din //Tools// → //Android// → //Android Device Monitor//.
</note>

**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.

În mediul integrat de dezvoltare Eclipse, crearea acestor resurse este realizată în mod automat în momentul în care se solicită definirea unei resurse de tip //Android Activity// (//File// → //New// → //Other// → //Android// → //Android Activity//).

{{ :colocvii:colocviu01:eclipse_activity01.png?nolink&500 }}

{{ :colocvii:colocviu01:eclipse_activity02.png?nolink&500 }}

{{ :colocvii:colocviu01:eclipse_activity03.png?nolink&500 }}

{{ :colocvii:colocviu01:eclipse_activity04.png?nolink&500 }}

În mediul integrat de dezvoltare Android Studio, crearea acestor resurse este realizată în mod automat în momentul în care se solicită definirea unei resurse de tip //Android Activity// (//File// → //New// → //Activity// → //Blank Activity//).

{{ :colocvii:colocviu01:androidstudio_activity.png?nolink&600 }}

**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.

<note tip>Î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.</note>

<file xml 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>
</file>

**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.

<file xml 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>
</file>

**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).

<file java 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);
  }
}
</file>

**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'');

<code 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" >
 
  <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>
</code>

  * în codul sursă corespunzător clasei care gestionează activitatea respectivă:
    - pe metoda ''onCreate()'':
      - să obțină o referință către controlul grafic prin intermediul căruia va fi lansată în execuție o altă activitate;
      - să înregistreze un obiect ascultător care va trata evenimentul legat de controlul grafic respectiv;
    - 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:
      - se va instanția un obiect de tip ''Intent'', care poate primi ca parametru:
        - 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ă;
        - 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ă;
      - 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;
      - 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.
    - să implementeze metoda ''onActivityResult()'', apelată în mod automat la revenirea din activitatea invocată, aceasta primind ca parametrii:
      - codul de cerere trimis în momentul în care activitatea a fost lansată în execuție;
      - rezultatul furnizat de activitatea invocată;
      - intenția generată de activitatea invocată.

<code java>
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();
    }
  }
  
  // ...
      
}
</code>

**D.1.** **a)** Pentru a putea fi utilizat, serviciul trebuie să fie declarat în fișierul ''AndroidManifest.xml''. Este obligatoriu să se definească proprietatea ''android:name'' care desemnează clasa care gestionează serviciul.

Opțional, pot fi precizate și atributele:
  * ''android:enabled'', care indică posibilitatea ca sistemul de operare Android să instanțieze serviciul;
  * ''android:exported'', prin care se oferă posibilitatea ca serviciul să poată fi invocat și din contextul altei aplicații Android decât cea din care face parte acesta;
  * ''android:permission'', care limitează posibilitatea ca serviciul respectiv să fie lansat în execuție exclusiv de componentele care dețin permisiunea specificată.

<file xml AndroidManifest.xml>
<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
  <application ...>
    <!-- other components -->
    <service 
      android:name="ro.pub.cs.systems.eim.PracticalTest01Service"
      android:enabled="true"
      android:exported="false" />
  </application>
</manifest>
</file>

Clasa Java care gestionează serviciul trebuie să fie derivată din clasa ''android.app.Service''.

Fiind un serviciu de tip started, trebuie supraîncărcate metodele de callback:
  * ''onStartCommand(intent, flags, id)'', apelat în mod automat în momentul în care componenta Android lansează serviciul în execuție printr-o invocare a metodei ''startService()'';
  * ''onBind(intent)'' care va furniza un rezultat ''null'', întrucât nu este necesară o interfață prin care componenta Android să interacționeze cu serviciul.

<file java PracticalTest01Service.java>
import android.app.Service;
import android.content.Intent;
import android.os.IBinder;

public class PracticalTest01Service extends Service {

  private ProcessingThread processingThread = null;

  @Override
  public int onStartCommand(Intent intent, int flags, int startId) {
    int firstNumber = intent.getIntExtra("firstNumber", -1);
    int secondNumber = intent.getIntExtra("secondNumber", -1);
    processingThread = new ProcessingThread(this, firstNumber, secondNumber);
    processingThread.start();
    return Service.START_REDELIVER_INTENT;
  }
  
  @Override
  public IBinder onBind(Intent intent) {
    return null;
  }
  
  @Override
  public void onDestroy() {
    processingThread.stopThread();
  }

}
</file>

Întrucât procesarea realizată în cadrul serviciului ar ocupa timp de procesor, putând avea un impact asupra responsivității aplicației Android în privința interacțiunii cu utilizatorul, operațiile respective vor fi realizate pe un fir de execuție dedicat. Argumentele care vor fi transmise firului de execuție dedicat sunt **contextul**, întrucât pe baza acestuia se vor transmite intențiile cu difuzare, precum și cele două numere din cadrul interfeței grafice, transmise prin intermediul intenției, ca valori asociate cheilor ''firstNumber'', respectiv ''secondNumber''. Valoarea pe care o furnizează metoda ''onStartCommand()'' este ''Service.START_REDELIVER_INTENT'', ceea ce indică sistemului de operare Android faptul că serviciul trebuie repornit în situația în care este distrus pentru a se recupera resursele pe care acesta le utilizează, în caz de nevoie. De asemenea, va fi retransmisă și intenția utilizată pentru a invoca serviciul respectiv.

<file java ProcessingThread.java>
import java.util.Date;
import java.util.Random;

import android.content.Context;
import android.content.Intent;
import android.util.Log;

public class ProcessingThread extends Thread {

  private Context context = null;
  private boolean isRunning = true;
	
  private Random random = new Random();
	
  private double arithmeticMean;
  private double geometricMean;
	
  public ProcessingThread(Context context, int firstNumber, int secondNumber) {
    this.context = context;
    
    arithmeticMean = (firstNumber + secondNumber) / 2;
    geometricMean = Math.sqrt(firstNumber * secondNumber);
  }
  
  @Override
  public void run() {
    Log.d("[ProcessingThread]", "Thread has started!");
    while (isRunning) {
      sendMessage();
      sleep();
    }
    Log.d("[ProcessingThread]", "Thread has stopped!");
  }
  
  private void sendMessage() {
    Intent intent = new Intent();
    intent.setAction(Constants.actionTypes[random.nextInt(Constants.actionTypes.length)]);
    intent.putExtra("message", new Date(System.currentTimeMillis()) + " " + arithmeticMean + " " + geometricMean);
    context.sendBroadcast(intent);
  }
  
  private void sleep() {
    try {
      Thread.sleep(10000);
    } catch (InterruptedException interruptedException) {
      interruptedException.printStackTrace();
    }
  }

  public void stopThread() {
    isRunning = false;
  }
}
</file>

În contextul firului de execuție dedicat, se calculează inițial valorile necesare (media aritmetică și media geometrică).

Rutina asociată firului de execuție implică următoarele operații:
  - propagarea unei intenții cu difuzare la nivelul sistemului de operare Android;
    - se creează un obiect de tip ''Intent'' care reprezintă intenția cu difuzare care va fi propagată;
      - acțiunea asociată intenției este aleasă în mod aleator dintr-o colecție de tipuri de intenții definite de utilizator;
      - informația conținută de intenția cu difuzare este plasată în câmpul ''extra'', valoarea (șirul de caractere obținut prin concatenarea datei și orei curente cu media aritmetică și cu media geometrică) fiind asociată cheii ''message'';
    - se transmite intenția cu difuzare la nivelul sistemului de operare Android prin invocarea metodei ''sendBroadcast()'' (definită în clasa ''Context'');
  - așteptarea unui interval de timp (10.000 ms) până la următoarea iterație, prin intermediul unui apel ''Thread.sleep()''.
Trebuie implementată și o metodă pentru oprirea rulării firului de execuție în situația în care serviciul asociat este distrus.

**b)** În clasa ''PracticalTest01Acivity'', sunt plasate operațiile de pornire și de oprire a serviciului.

Verificarea momentului în care trebuie pornit serviciul este realizată pe metoda ascultător a evenimentului de apăsare a unui buton. Se realizează suma dintre valorile conținute în cele două câmpuri text editabile și, în situația în care aceasta depășește pragul minim stabilit și dacă serviciul se găsește în starea oprit, atunci poate fi invocată metoda ''startService()''. Aceasta primește ca argument un obiect de tip ''Intent'' (explicit, instanțiat cu contextul și cu clasa aferentă serviciului) în care sunt plasate, în câmpul ''extra'', valorile din câmpurile text editabile sub cheile ''firstNumber'' și ''secondNumber''.

<code java>
private class ButtonClickListener implements View.OnClickListener {	
  @Override
  public void onClick(View view) {
    int leftNumberOfClicks = Integer.parseInt(leftEditText.getText().toString());
    int rightNumberOfClicks = Integer.parseInt(rightEditText.getText().toString());

    // ...
    
    if (leftNumberOfClicks + rightNumberOfClicks > Constants.NUMBER_OF_CLICKS_THRESHOLD
        && serviceStatus == Constants.SERVICE_STOPPED) {
      Intent intent = new Intent(getApplicationContext(), PracticalTest01Service.class);
      intent.putExtra("firstNumber", leftNumberOfClicks);
      intent.putExtra("secondNumber", rightNumberOfClicks);
      getApplicationContext().startService(intent);
      serviceStatus = Constants.SERVICE_STARTED;
    }
  }
}
</code>

Momentul la care este oprit serviciul coincide cu distrugerea activității, așadar pe metoda de callback ''onDestroy()''. Similar, această operație poate fi realizată și pe metoda de callback ''onStop()''. Metoda ''stopService()'' primește ca argument tot un obiect de tip ''Intent'' construit explicit, cu numele clasei care deservește serviciul.

<code java>
@Override
protected void onDestroy() {
  Intent intent = new Intent(this, PracticalTest01Service.class);
  stopService(intent);
  super.onDestroy();
}
</code>

Dacă serviciul este oprit, el va fi distrus de sistemul de operare Android (deși ''stopService()'' nu implică invocarea unei metode de callback la nivelul serviciului, totuși acesta va fi oprit și ulterior distrus). Pe metoda ''onDestroy()'' a serviciului, trebuie să se aibă grijă ca rutina din cadrul firului de execuție asociat să se termine.

**D.2.** Un ascultător pentru intenții cu difuzare este o clasă derivată din ''android.content.BroadcastReceiver''. Acesta poate fi declarat în fișierul ''AndroidManifest.xml'', dacă se dorește ca acesta să fie invocat în mod automat chiar dacă aplicația Android din care face parte nu este instanțiată sau poate fi înregistrat / deînregistrat pe metodele de callback ''onResume()'' / ''onPause()'' dacă se dorește ca funcționarea sa să fie limitată la perioada în care activitatea este disponibilă pe suprafața de afișare a dispozitivului mobil.

În momentul în care o intenție cu difuzare are aceeași acțiune ca cea indicată în filtrul de intenții asociat ascultătorului respectiv, este apelată în mod automat metoda de callback ''onReceive(context, intent)''. Aceasta va fi responsabilă exclusiv cu jurnalizarea valorii asociate cheii ''message'' din câmpul ''extra'' asociat intenției cu difuzare respective.

<code java>
private MessageBroadcastReceiver messageBroadcastReceiver = new MessageBroadcastReceiver();
private class MessageBroadcastReceiver extends BroadcastReceiver {
  @Override
  public void onReceive(Context context, Intent intent) {
    Log.d("[Message]", intent.getStringExtra("message"));
  }
}
</code>

Un ascultător pentru intenții cu difuzare trebuie să aibă asociat și un filtru de intenții. Acesta conține acțiunile asociate intențiilor cu difuzare, pe care ascultătorul respectiv trebuie să le proceseze.

<code java>
public class PracticalTest01MainActivity extends Activity {

  // ...
  
  private IntentFilter intentFilter = new IntentFilter();

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

    for (int index = 0; index < Constants.actionTypes.length; index++) {
      intentFilter.addAction(Constants.actionTypes[index]);
    }
  }
}
</code>

Operațiile de activare, respectiv de dezactivare a ascultătorului pentru intenții cu difuzare, sunt realizate pe metodele de callback ale activității ''onResume()'', respectiv ''onPause()''. În acest fel, se asigură faptul că ascultătorul pentru intenții cu difuzare nu va procesa decât mesajele transmise în perioada în care activitatea este afișată pe suprafața de afișare a dispozitivului mobil.

<code java>
public class PracticalTest01MainActivity extends Activity {

  // ...

  @Override
  protected void onResume() {
    super.onResume();
    registerReceiver(messageBroadcastReceiver, intentFilter);
  }
  
  @Override
  protected void onPause() {
    unregisterReceiver(messageBroadcastReceiver);
    super.onPause();
  }
}
</code>

**D.3.** Pentru încărcarea codului în contextul depozitului din cadrul contului Github personal:
  - 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);
  - 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:
  - se încarcă modificările la distanță, prin intermediul comenzii ''git push'', care primește ca parametrii:
    - sursa (prin eticheta ''origin'' se indică depozitul de unde au fost descărcat conținutul);
    - destinația: ramificația curentă (implicit, aceasta poartă denumirea ''master'').

<code>
student@eim2016:~/PracticalTest01$ git add *
student@eim2016:~/PracticalTest01$ git commit -m "finished tasks for PracticalTest01"
student@eim2016:~/PracticalTest01$ git push origin master
</code>

Î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ă):

<code>
student@eim2016:~/PracticalTest01$ git config --global user.name "Perfect Student"
student@eim2016:~/PracticalTest01$ git config --global user.email perfectstudent@cs.pub.ro
</code>