Lastnosti android:label in android:icon značke <intent-filter> določata napis in ikono, ki se bosta prikazala ob kliku na sliko. @string/view_image kaže na napis »Poglej sliko« v strings.xml, @drawable/ic_view_image pa na ustrezno ikono v mapah res/drawable-*.
Podznačke <action>, <category> in <data> pa določajo, kdaj se bo aktivnost prikazala.

Akcija

Značka <action> je obvezna in določa osnovno zvrst akcije, na primer poglej, uredi itd. Zvrst določimo v lastnosti značke android:name. Nekaj osnovnih lastnosti je:

● android.intent.action.MAIN – to označuje osnovno aktivnost, namenjeno zagonu aplikacije in se bo prikazala v zagonskem predalu sistema (App drawer),
● android.intent.action.VIEW – odpri datoteko, kontakt, podatek ipd.,
● android.intent.action.EDIT – odpri datoteko, kontakt, podatek ipd. in omogoči uporabniku urejanje tega,
● android.intent.action.SEND – pošlji datoteko, kontakt, podatek ipd. prek drugih programov (na primer deli na Facebooku, pošlji po e-pošti itd.),
● android.intent.action.SEND_MULTIPLE – podobno kot SEND, le da pošlje več podatkov hkrati,
● android.intent.action.PICK – v drugi aktivnosti izberi datoteko, kontakt, podatek ipd. in ga vrni nazaj (na primer izberi svojo profilno sliko iz galerije),
● android.intent.action.SEARCH – določa aktivnost, ki omogoča iskanje znotraj aplikacije.

Vnaprej definiranih akcij je še veliko več, lahko pa definiramo tudi svoje, na primer com.comtrade.intent.BE_AWESOME, vendar je to uporabno zgolj znotraj naše aplikacije ali pa znotraj skupine aplikacij, saj tuje aplikacije ne bodo vedele, katero akcijo klicati. Za povezovanje z drugimi aplikacijami torej uporabljajmo vnaprej definirane androidne akcije, za interno uporabo pa lahko uporabimo tudi lastne.

Podatek

Značka <data> predstavlja podatek, ki ga želimo odpreti z aplikacijo. Ta značka ni obvezna, je pa zelo pogosta. Z njo lahko na primer določim, da naša aplikacija odpira le slike, le kontakte ali pa zgolj datoteke iz določene mape.

Znački lahko nastavimo:
● mimeType – tip datoteke, na primer »text/plain« (navaden tekst), »text/html« (html datoteke), »image/*« (vse slike), »*/*« (vse datoteke) itd.,
● scheme – vir podatka, na primer »file« (datoteka), »mailto« (e-poštno sporočilo), »content« (vsebina), »geo« (geografske koordinate) itd.
● path in pathPattern – natančno določena pot do datoteke oziroma vzorec poti, na primer »/DCIM/*« (zgolj slike s kamere),
● host in port – na primer www.google.com za host in 8080 za vrata.

Kategorija

Značka <category> predstavlja kategorijo in dodatno omeji zvrst aktivnosti. Ta značka ni obvezna in dostikrat tudi ni podana. Najbolj uporabne so:
● android.intent.category.DEFAULT – privzeta aktivnost za določeno vrsto namena; če ima vsaj ena od ustreznih aktivnosti nastavljeno to kategorijo, potem tiste brez nje niso prikazane,
● android.intent.category.LAUNCHER – ta kategorija določa aktivnosti, ki se bodo prikazale v androidovem osnovnem meniju za zagon aplikacij,
● android.intent.category.PREFERENCE – določa aktivnost, ki vsebuje nastavitve aplikacije,
● android.intent.category.BROWSABLE – aktivnosti, ki bodo pognane iz spletnega brskalnika, bodo imele to kategorijo.

Zagon aktivnosti

Aktivnosti zaženemo tako, da ustvarimo nov namen in ga posredujemo. Kot smo že omenili, poznamo dve vrsti namena: eksplicitni in implicitni. Z drugega vidika pa obstajajo aktivnosti, ki zgolj sprejmejo podatke, in takšne, ki kaj tudi vrnejo. Poglejmo si, kako poganjamo vse te tipe aktivnosti.

Eksplicitni namen

Pri eksplicitnem namenu natančno vemo, katero aktivnost ali storitev želimo odpreti (in ji morda posredovati podatke). Za to moramo ustvariti nov namen (Intent) in ga posredovati v metodo startActivity(Intent intent) ali pa startService(Intent intent). To sta metodi v razredu Context, katerega podrazred je Activity, od koder bomo večinoma tudi izvajali klice teh dveh metod.

Primeri eksplicitnih namenov:

1. Intent intent = new Intent(context, SettingsActivity.class);
startActivity(intent);
To bo odprlo aktivnost z nastavitvami aplikacije (SettingsActivity).
2. Intent intent = new Intent(context, OpenImageActivity.class);
intent.setData(Uri.parse("content://media/external/images/media/5374"));
startActivity(intent);
Ta koda bo zagnala aktivnost za prikaz slik (OpenImageActivity), v kateri bo vidna slika na podanem naslovu »content://media/…«.
3. Intent intent = new Intent(context, UploadDataService.class);
startService(intent);
Ta koda pa bo pognala storitev za nalaganje podatkov na strežnik (UploadDataService).

Implicitni namen

Implicitni namen pomeni, da nas ne zanima, s katero aplikacijo ali aktivnostjo bo sistem oziroma uporabnik odprl naš podatek. Hočemo le, da ga zna. Prav tako kot pri eksplicitnih namenih tudi tu ustvarimo nov namen, le da mu namesto razreda podamo zgolj opis aktivnosti in podatkov. Tudi tu namen posredujemo v metodo startActivity(Intent intent). Storitve ni priporočljivo zaganjati implicitno, zato metode startService(Intent intent) tu ne uporabljamo.

Poglejmo si nekaj primerov implicitnih namenov:
1. Intent intent = new Intent(Intent.ACTION_VIEW,
Uri.parse("content://media/external/images/media/5374"));
startActivity(intent);

Ta koda odpre sliko, ki je na napravi zapisana na naslovu »content://media/…«. Android sam prepozna, da gre za sliko, ki jo želimo samo videti (ne pa nujno tudi urejati), in nam ponudi vse aplikacije, ki znajo prikazati sliko.

2. Intent intent = new Intent(Intent.ACTION_VIEW);
intent.addCategory(Intent.CATEGORY_BROWSABLE);
intent.setData(Uri.parse("http://www.comtrade.si"));
startActivity(intent);

To je namen, ki odpre izbrano spletno stran v brskalniku.

3. Intent intent = new Intent(Intent.ACTION_SEND);
intent.putExtra(Intent.EXTRA_STREAM,
Uri.parse("content://media/external/images/media/5374"));
intent.setType("image/jpeg");
startActivity(intent);

Ta namen pa omogoča pošiljanje slike. Tokrat se bodo odprle aplikacije, ki znajo to sliko posredovati naprej, na primer Gmail, Facebook, Dropbox itd. Tu moramo paziti, saj podatka ne dodamo prek metode setData, ampak prek putExtra.

Vračanje podatkov

Včasih želimo odpreti aktivnost zgolj zato, da dobimo iz nje nekakšen odgovor, kot je recimo iskanje določenega kontakta, slike, zvoka, videa ali drugih datotek. Načelo delovanja je tako, da ustvarimo nov namen in ga posredujemo v metodo startActivityForResult(Intent intent, int requestCode) – prvi parameter je naš namen, drugi pa unikatna številka, s katero ločimo rezultate. Primer:

1. private static final int REQUEST_SELECT_FILE = 1;
…
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
intent.setType("file/*");
startActivityForResult(intent, REQUEST_SELECT_FILE);
Ta namen nam bo pokazal aktivnost za izbiro datoteke s pomnilnika.
2. private static final int REQUEST_SELECT_CONTACT = 2;
…
Intent intent = new Intent(Intent.ACTION_PICK);
intent.setDataAndType(Uri.parse("content://contacts"),
ContactsContract.CommonDataKinds.Phone.CONTENT_TYPE);
startActivityForResult(intent, REQUEST_SELECT_CONTACT);
Ta namen pa bo pokazal aktivnost, v kateri bomo lahko izbrali kontakt od vseh, ki vsebujejo telefonske številke.

Ko se aktivnost, ki smo jo klicali, zaključi, nam vrne odgovor prek metode onActivityResult(int requestCode, int resultCode, Intent intent) – prvi parameter je številka, ki smo jo podali v metodo startActivityForResult, drugi parameter nam pove, ali je uporabnik izbral podatek ali preklical izbiranje, tretji pa vsebuje vrnjen podatek. Metodo onActivityResult moramo v našem razredu *Activity povoziti in se odločiti, kaj napraviti z rezultatom:

@Override
protected void onActivityResult(int requestCode,
int resultCode, Intent data) {
if (resultCode == RESULT_OK) {
if (requestCode == REQUEST_SELECT_FILE) {
String file = data.getData().toString();
Toast.makeText(this, "Datoteka: " + file,
Toast.LENGTH_LONG).show();
} else if (requestCode == REQUEST_SELECT_CONTACT) {
String phone = getPhoneNumber(data.getData());
Toast.makeText(this, "Telefon: " + phone,
Toast.LENGTH_LONG).show();
}
}
}
Če je izbral datoteko, mu izpišemo tekst »Datoteka: <ime datoteke>«, če je izbiral kontakt, pa mu izpišemo »Telefon: <tel. št.>«.

Zaključek

Aktivnosti in nameni so temelji vsake androidne aplikacije. Z dobro zastavljenim zaporedjem aktivnosti preprečimo marsikatero nevšečnost in uporabniku ponudimo znani delovni tok (workflow), ki je prisoten v vseh drugih aplikacijah. Zato si je že pred začetkom razvijanja dobro vzeti čas in narediti natančen načrt aktivnosti ter si s tem olajšati nadaljnji razvoj.

Kodo, uporabljeno v tem članku, najdete na GitHubu: http://goo.gl/6UFjgJ. Če pa imate še kakšno vprašanje, mi lahko pošljete e-pošto.

In na koncu ne pozabite, da je dobra aktivnost zdrava tako za telo kot tudi za aplikacijo.