Yesterday I started a tutorial I found on the youtube channel of androiddevelopers. The intent of this tutorial is to create an application that shows all contacts by name. You also should be able to click on the name and the phone will start a call to this contact.

The tutorial itself is more than a year old, has some failures and some stuff isn’t available in the same way the tutorial shows. I will show you what you have to do to be successfully program this little android application and I will show you some useful layout improvements.

The first thing you should do is creating a new project in Eclipse (or in your IDE). I chose “de.warrenfaith.android.contacts” as package and “ListContacts” as activity name.
After you have done this, you should open the main.xml to modify the layout.

The first XML node is responsible for the entire applications. Every UI element you want to display should be setup here.

1
2
3
4
5
6

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
</LinearLayout>

Line 1 is the normal XML DocType.
Line 2 defines the LinearLayout node.
Line 3 defines the orientation which is horizontal, so that every child element will be displayed from left to right.
Line 4-5 defines that this layout will fill the whole parent which is the screen because it is the first defined element.
Line 6 closes the layout element.

Now lets add a static image for our list. We will use the default icon which every new project has in his res/drawable directory.
We need to add this to our main.xml this way:

1
2
3
4
5
6
7
8
9

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <ImageView android:src="@drawable/icon"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

New are the lines 6 to 8.
Line 6 creates a new node for ImageView and defines the source of the image. @drawable is the “link” to the res/drawable directory to look for a image named icon
Line 7-8 defines the layout which is here set to wrap the content so it just use the space the image really needs.

The next step is to setup the TextViews for the contact name and the TextViews for the phone number.
The contact name should stay above the phone number, so we need to define the next LinearLayout with the orientation as a child node of the first LinearLayout. The main.xml should now look like this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <ImageView android:src="@drawable/icon"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
    <LinearLayout
        android:orientation="vertical"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent">
    </LinearLayout>
</LinearLayout>

Now we want to fill this child node with another LinearLayout with horizontal orientation to have the label “Name:” and the contact name in one line.
First the contact name, so lets cut and paste the following XML snippet below:

1
2
3
4
5
6
7
8
9
10
11
12
13

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    android:orientation="horizontal"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Name: " />
    <TextView android:id="@+id/contact_name"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

Now the phone number:

1
2
3
4
5
6
7
8
9
10
11
12
13

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    android:orientation="horizontal"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Phone: " />
    <TextView android:id="@+id/phone_number"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

Confused? I don’t hope so, but here is an image to realize what is what:

ListView Schema

And here is the final main.xml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <ImageView
        android:src="@drawable/icon"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
    />
    <LinearLayout
        android:orientation="vertical"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent">
        <LinearLayout
            android:orientation="horizontal"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content">
            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Name: "
            />
            <TextView android:id="@+id/contact_name"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
            />
        </LinearLayout>
        <LinearLayout
            android:orientation="horizontal"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content">
            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Phone: "
            />
            <TextView android:id="@+id/phone_number"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
            />
        </LinearLayout>
    </LinearLayout>
</LinearLayout>

Everybody who is thinking about webdesign and div-layout is understanding the android user interface layout.

Now it is time to create the Activity, in our case, the ListActivity.
My activity class is named ListContacts and looks like this:

1
2
3
4
5
6
7
8
9
10
11
12
13

package de.warrenfaith.android.contacts;
 
import android.app.Activity;
import android.os.Bundle;
 
public class ListContacts extends ListActivity {
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }
}

First of all we can delete the line 11 because its just not needed in our application.
The next step is to create a cursor which can iterate over our contacts on the phone. To get the cursor we use the ContentResolver and start a query.

1
2

Cursor cursor = getContentResolver().query(People.CONTENT_URI, null, null, null, null);
startManagingCursor(cursor);

The next step is to create a mapping. First we define the colums we want to use from the query.

1

String[] columns = new String[] {People.NAME, People.NUMBER};

The next step is to define the destination on which the values from the query are mapped.

1

int[] names = new int[] {R.id.contact_name, R.id.phone_number};

Now we create a SimpleCursorAdapter and use it.

1
2

myAdapter = new SimpleCursorAdapter(this, R.layout.main, cursor, columns, names);
setListAdapter(myAdapter);

The variable myAdapter is a class variable so we can later access it easily.

1

private SimpleCursorAdapter myAdapter;

The actual Activity should look like this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

package de.warrenfaith.android.contacts;
 
import android.app.ListActivity;
import android.database.Cursor;
import android.os.Bundle;
import android.provider.Contacts.People;
import android.widget.SimpleCursorAdapter;
 
public class ListContacts extends ListActivity {
 
    private SimpleCursorAdapter myAdapter;
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Cursor cursor = getContentResolver().query(People.CONTENT_URI, null, null, null, null);
        startManagingCursor(cursor);
 
        String[] columns = new String[] {People.NAME, People.NUMBER};
        int[] names = new int[] {R.id.contact_name, R.id.phone_number};
 
        myAdapter = new SimpleCursorAdapter(this, R.layout.main, cursor, columns, names);
        setListAdapter(myAdapter);
    }
}

Now we can implement the click and call feature.
Lets override the onListItemClick() method from the super class ListActivity.

1
2
3
4

@Override
protected void onListItemClick(ListView listView, View view, int position, long id) {
    super.onListItemClick(listView, view, position, id);
}

First lets create an Intent object to make a call.

1

Intent intent = new Intent(Intent.ACTION_CALL);

Now lets determine on which element we have clicked:

1
2

Cursor cursor = (Cursor) myAdapter.getItem(position);
long phoneId = cursor.getLong(cursor.getColumnIndex(People.PRIMARY_PHONE_ID));

Line 1 set the cursor to the correct element using the parameter “position”.
Line 2 gets the phone id, which seems to be the primary key of each contact.

Now we can set the data for the intent and start the activity.

1
2

intent.setData(ContentUris.withAppendedId(Phones.CONTENT_URI, phoneId));
startActivity(intent);

Finally you should have this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

package de.warrenfaith.android.contacts;
 
import android.app.ListActivity;
import android.content.ContentUris;
import android.content.Intent;
import android.database.Cursor;
import android.os.Bundle;
import android.provider.Contacts.People;
import android.provider.Contacts.Phones;
import android.view.View;
import android.widget.ListView;
import android.widget.SimpleCursorAdapter;
 
public class ListContacts extends ListActivity {
 
    private SimpleCursorAdapter myAdapter;
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Cursor cursor = getContentResolver().query(People.CONTENT_URI, null, null, null, null);
        startManagingCursor(cursor);
 
        // start mappings
        String[] columns = new String[] {People.NAME, People.NUMBER};
        int[] names = new int[] {R.id.contact_name, R.id.phone_number};
 
        myAdapter = new SimpleCursorAdapter(this, R.layout.main, cursor, columns, names);
        setListAdapter(myAdapter);
    }
 
    @Override
    protected void onListItemClick(ListView listView, View view, int position, long id) {
        super.onListItemClick(listView, view, position, id);
 
        Intent intent = new Intent(Intent.ACTION_CALL);
        Cursor cursor = (Cursor) myAdapter.getItem(position);
        long phoneId = cursor.getLong(cursor.getColumnIndex(People.PRIMARY_PHONE_ID));
        intent.setData(ContentUris.withAppendedId(Phones.CONTENT_URI, phoneId));
 
        startActivity(intent);
    }
}

The last thing you have to do is to grant your application the permission to start the calls and to read the contacts of your phone.
You can do this by add some snippets to your AndroidManifest.xml

1
2

<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.CALL_PHONE" />

The file itself should now look like this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="de.warrenfaith.android.contacts"
      android:versionCode="1"
      android:versionName="1.0.0">
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="android.permission.CALL_PHONE" />
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".ListContacts"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

Now you can compile and run the application on your emulator or device.

The next step will be to use the contact picture you once added in the contact.

After reading a lot of blogs, tutorials, developer guides and miscellaneous stuff I started to wonder, if installing an application without the android market and without the sdk tools (ignore the emulator please ) is possible.

Some mailing list entries and blogs mentioned hacks to do so, but I couldn’t believe it. So whats the right thing to do in this case? Correct: lets try it!

The first thing I needed was an application to install so I took the one I created in my first tutorial: HelloAndroid.
I uploaded it on my web space, started the emulator and typed the URL of the apk in the browser. Android told me instantly that I need to install a SD card. Ok, never done that so far, so I looked and found a page about the emulator setup.
So I started creating a SD card image with the command line (could take some time…)
mksdcard 2048M sdcard.iso

Then I started the emulator with the parameter for the SD card image:
emulator -sdcard sdcard.iso

If you store your SD card image not in the same directory as the emulator start script, you need to add the path to the image like that:
emulator -sdcard /path/to/androidsdk/tools/sdcard.iso

Now I checked if the emulator has found my SD card. Done that with Menu -> Settings -> SD card & phone storage and read: 2040 MB total space on SD card was found.

After this setup I could easily download my apk-file from my websapce, install it and run it.

PS: A warning occurred as I tried it a second time but the warning was just to remind me this application was already installed and if I am sure to replace the existing with the new one.

During my first steps of Android programming, i want to know how much memory the device has or how much is really used.
In the Android API I found the ActivityManager class which has a inner class MemoryInfo. Simply instantiation of the ActivityManager failed because there is no visible constructor.
Searching the web gave no answers only open questions from other developer. So I looked further and I found a method of the Activity class called getSystemService(String name). With a constant from Context.ACTIVITY_SERVICE as parameter it returns me an Object I can cast to ActivityManager. With an instance from MemoryInfo I could now get the information I wanted.
At the moment I don’t know how to display the memory information in the UI, but I just started
Here is my short code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

package de.warrenfaith.android.memory;
 
import android.app.Activity;
import android.app.ActivityManager;
import android.app.ActivityManager.MemoryInfo;
import android.content.Context;
import android.os.Bundle;
 
public class MemoryTest extends Activity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityManager mgr = (ActivityManager) super.getSystemService(Context.ACTIVITY_SERVICE);
        MemoryInfo memInfo = new ActivityManager.MemoryInfo();
        mgr.getMemoryInfo(memInfo);
        setContentView(R.layout.main);
    }
}

Ansonsten hab ich KDE 4.2 installiert, meine Grafiktreiber geupdated und damit auch die Performanceprobleme behoben, die ich unter KDE hatte.
Dennoch ist die KDE Integration (egal ob 4.1 oder 4.2) unter Gentoo mehr schlecht als recht. Kopete z.B. kann nur Jabber, aber kein ICQ, IRC o.ä. Auch ist das Systemtray mit durchsichtigen Icons bestückt.

So macht das alles einfach keinen Spaß.

Ich werd also Gentoo runterhauen und mit dafür Debian oder Ubuntu draufhauen. Tendiere momentan eher zu Debian testing.

Wenn Ihr Vorschläge oder gar Ratschläge habt, sagt bescheid

Das mir Kopete abstürzte, liegt wohl an meinem KNetworkManager. Warum? Tja, das gute Ding braucht kde-libs-3.5. Ich hatte kurz alles von kde 3 runtergeschmissen, da ich ja kde4 hab und prompt ging kopete etc. Nur gibt es leider keinen KNetworkManager für KDE 4, also war ich gezwungen, wieder den für 3.5 zu installieren inklusive der kde-libs für 3.5. Nun hab ich die libs für KDE 3.5 und 4 drauf und kopete stürzt wieder ab… Konquerer übrigends auch!

Ich hab jetzt keine Lust mehr infos dazu zu suchen. Ich werde morgen wohl mal im Gentoo-Forum stöbern gehen.
Vorher wird das aber nochmal reproduziert, damit ich auch keinen Mist erzähle

Ansonsten ist mein KDE extrem langsam, wahrscheinlich weil meine Grafikkarte noch nicht installiert und konfiguriert ist. Aber auch “einfache” Programme wie Kopete wollen nicht so wie ich es will.
Als erstes scheiterte die Kompilierung von Kopete. In einem Bugreport wurde ich fündig. Dort wurde mir gesagt, dass ich qt4 brauche und das mit der USE-Flag “glib” kompilieren muss. Gesagt getan, danach ging die Kompilierung. Allerdings konnte ich zwar ICQ und Jabber-Accounts hinzufügen, sobald ich aber auf einen Kontakt geklickt hatte, stürzte es ab. Ebenso beim Klick auf “Settings->Configure”.

Nun sitze ich im Moment daran, ein paar updates zu kompilieren und eventuell zu schauen, welche Pakete mit meinen veränderten USE-Flags neukompiliert werden müssten.

Es wird sich also sicher noch ein paar Tage hinziehen, bis ich halbwegs zufrieden damit arbeiten kann.

Momentan auf meiner ToDo:
Grafikkarte, Soundkarte, Arbeitsumgebung (Java, Eclipse, Subversion etc), ACPI (Powermanagement), KDE selbst einrichten und konfigurieren, FireFox 3 (hab durch emerge nur FF2 bekommen)

Nun war es also soweit, ich hab angefangen.

Nachdem ich die Installations-CD gebrannt habe und davon gebootet habe, stellte ich fest, dass er beim erkennen der Festplatten, leider auch mein CD-ROM nicht mehr erkannte. Fazit war, dass natürlich das Installationsmedium selbst damit nicht mehr zur Verfügung stand.
Ein wenig gesucht und schon fand ich den Tipp, einfach die ISO der CD auf einen USB-Stick zu entpacken und schon fand er beim mounten den Stick und die Daten.

Als nächster Schritt kam die Partitionierung der Festplatte an die Reihe. Nach einigem Hin und Her, ich musste jede Partition außer meiner Windows Systemplatte löschen, konnte ich mit der Installation fortfahren.

Alles lief gut, ich brauchte auch nur 3 Versuche um Grub die richtige Linuxpartition zu geben

Nun fing das kompilieren von KDE und Co an. Ich hab das natürlich über Nacht laufen lassen und durfte dann am Morgen, wie immer, Fehler finden.
Ich hab also versucht die Fehler zu fixen und dabei dann irgendwie festgestellt, dass ich doch tatsächlich KDE 3.5.9 installiert habe, dabei wollte ich eigentlich mindestens auf KDE 4.1 einsteigen.

Nun gut, hab gesucht und nur irgendwelche How-Tos gefunden, die mindestens fast ein Jahr alt sind. Schien mir also nicht das richtige. Ich ließ dann einfach die KDE auf der 3.5.9 und wollte danach kdm installieren.
Mindestens 20 blockierte Pakete! Das entfernen der Pakete, die blockierten ging nicht, da sie, laut Fehlermeldung, gar nicht installiert waren.
Also wollte ich KDE selbst nochmal entfernen, aber auf der Platte selbst ist es immer noch.

Wenigstens hatte xorg-x11 funktioniert, denn ein startx hat mir eine grafische Oberfläche mit 3 Konsolen gezeigt. Ich hab aber keine Ahnung, welche Oberfläche das war?! XCFE vielleicht?

Nun gut, ich werde morgen erstmal einen mit Gentoo vertrauten Arbeitskollegen fragen. Der wird mir sicherlich Hilfestellung geben können!

Fortsetzung garantiert!

Wer mehr als einen bestellt, bekommt individuell berechnete Versandpreise.

Wer flink ist, hat vielleicht sogar schon zum Nikolaus das erste Exemplar in der Hand.

Ich hab das gefixt, ihr könnt also nun wieder kommentieren.

Sorry dafür.

Daher hab ich auch mein PagePeel erstmal deaktiviert.

Bin gespannt was golem oder heise dazu morgen melden…