学步园

本文来自http://blog.csdn.net/xjanker2 ，引用转载必须注明出处！

上一篇中使用了打电话发短信的功能，但号码联系人信息我们还不知道。本篇开始讲如何从Android中得到本机联系人的信息。

由于Android较快的版本升级，部分API已经发生了变化。本篇探究的通过ContentProvider机制获取联系人的API从Android2.0开始做了很大调整，原来的android.provider.Contacts类及其下相关类由android.provider.ContactsContract代替。原类体系标记为Deprecated（废弃），因为兼容的原因目前还存在，但不保证以后的更新版本中完全丢弃。

所以本文先从Android2.1以上平台的联系人读取开始说起，下面给出代码在Android2.1/2.2中运行的效果图,

首先，创建类ViewContacts继承ListActivity，并设为为应用的开始Activity。

ViewContacts.java 代码：

 package jtapp.contacts;</p> <p>import java.util.ArrayList;<br /> import java.util.HashMap;<br /> import java.util.List;</p> <p>import android.app.ListActivity;<br /> import android.database.Cursor;<br /> import android.os.Bundle;<br /> import android.provider.ContactsContract;<br /> import android.widget.SimpleAdapter;</p> <p>public class ViewContacts extends ListActivity {<br /> /** Called when the activity is first created. */<br /> @Override<br /> public void onCreate(Bundle savedInstanceState) {<br /> super.onCreate(savedInstanceState);<br /> setContentView(R.layout.main);</p> <p> List<HashMap<String, String>> items = fillMaps();<br /> SimpleAdapter adapter = new SimpleAdapter(<br /> this,items,R.layout.list_item,<br /> new String[]{"name","key"},<br /> new int[]{R.id.item,R.id.item2});<br /> this.setListAdapter(adapter);</p> <p> }</p> <p> private List<HashMap<String, String>> fillMaps() {<br /> List<HashMap<String, String>> items = new ArrayList<HashMap<String, String>>();</p> <p> Cursor cur = null;<br /> try {<br /> // Query using ContentResolver.query or Activity.managedQuery<br /> cur = getContentResolver().query(<br /> ContactsContract.Contacts.CONTENT_URI, null, null, null, null);<br /> if (cur.moveToFirst()) {<br /> int idColumn = cur.getColumnIndex(<br /> ContactsContract.Contacts._ID);<br /> int displayNameColumn = cur.getColumnIndex(<br /> ContactsContract.Contacts.DISPLAY_NAME);<br /> // Iterate all users<br /> do {<br /> String contactId;<br /> String displayName;<br /> String phoneNumber = "";<br /> // Get the field values<br /> contactId = cur.getString(idColumn);<br /> displayName = cur.getString(displayNameColumn);<br /> // Get number of user's phoneNumbers<br /> int numberCount = cur.getInt(cur.getColumnIndex(<br /> ContactsContract.Contacts.HAS_PHONE_NUMBER));<br /> if (numberCount>0) {<br /> Cursor phones = getContentResolver().query(<br /> ContactsContract.CommonDataKinds.Phone.CONTENT_URI,<br /> null,<br /> ContactsContract.CommonDataKinds.Phone.CONTACT_ID<br /> + " = " + contactId<br /> /*+ " and " + ContactsContract.CommonDataKinds.Phone.TYPE<br /> + "=" + ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE*/,<br /> null, null);<br /> if (phones.moveToFirst()) {<br /> int numberColumn = phones.getColumnIndex(<br /> ContactsContract.CommonDataKinds.Phone.NUMBER);<br /> // Iterate all numbers<br /> do {<br /> phoneNumber += phones.getString(numberColumn) + ",";<br /> } while (phones.moveToNext());<br /> }<br /> }<br /> // Add values to items<br /> HashMap<String, String> i = new HashMap<String, String>();<br /> i.put("name", displayName);<br /> i.put("key", phoneNumber);<br /> items.add(i);<br /> } while (cur.moveToNext());<br /> } else {<br /> HashMap<String, String> i = new HashMap<String, String>();<br /> i.put("name", "Your Phone");<br /> i.put("key", "Have No Contacts.");<br /> items.add(i);<br /> }<br /> } finally {<br /> if (cur != null)<br /> cur.close();<br /> }<br /> return items;<br /> }<br /> }

 main.xml 代码：

<?xml version="1.0" encoding="utf-8"?><br /> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"<br /> android:orientation="vertical"<br /> android:layout_width="fill_parent"<br /> android:layout_height="fill_parent"<br /> ><br /> <TextView<br /> android:layout_width="fill_parent"<br /> android:layout_height="wrap_content"<br /> android:text="show your phone's contacts:"<br /> /><br /> <ListView android:id="@id/android:list"<br /> android:layout_width="fill_parent"<br /> android:layout_height="0dip"<br /> android:layout_weight="1"<br /> android:drawSelectorOnTop="false"<br /> /><br /> </LinearLayout>

list_item.xml 代码：

<?xml version="1.0" encoding="utf-8"?><br /> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"<br /> android:orientation="vertical"<br /> android:layout_width="fill_parent"<br /> android:layout_height="fill_parent"<br /> ><br /> <TableRow android:id="@+id/TableRow01"<br /> android:layout_width="wrap_content"<br /> android:layout_height="wrap_content"><br /> <TextView android:id="@+id/item"<br /> xmlns:android="http://schemas.android.com/apk/res/android"<br /> android:layout_width="wrap_content"<br /> android:layout_height="wrap_content"<br /> android:textSize="20px" /><br /> <TextView android:text=": "<br /> xmlns:android="http://schemas.android.com/apk/res/android"<br /> android:layout_width="wrap_content"<br /> android:layout_height="wrap_content"<br /> android:textSize="20px" /><br /> <TextView android:id="@+id/item2"<br /> xmlns:android="http://schemas.android.com/apk/res/android"<br /> android:layout_width="wrap_content"<br /> android:layout_height="wrap_content"<br /> android:textSize="20px" /><br /> </TableRow><br /> </LinearLayout>

AndroidManifest.xml 增加uses权限READ_CONTACTS 代码：

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

以上文件编写好后，应用就能够在Android2.1模拟器上正确运行了。

那么该app如果在android1.6上运行，会怎么样呢？1.6上并没有ContactsContract类体系，所以就会报错了。需要注意，ContactContract类是在API Level 5增加的，之前的Android版本并不支持。

在Android 1.6 （API Level 4）上，获取联系人的方法将fillMaps()实现为如下：

  private List<HashMap<String, String>> fillMaps() {<br /> List<HashMap<String, String>> items = new ArrayList<HashMap<String, String>>();</p> <p> Cursor cur = null;<br /> try {<br /> // Form an array specifying which columns to return.<br /> String[] projection = new String[] {<br /> People._ID,<br /> People.NAME,<br /> People.NUMBER<br /> };<br /> // query using ContentResolver.query or Activity.managedQuery<br /> cur = getContentResolver().query(<br /> People.CONTENT_URI,projection, null,null, null);<br /> if (cur.moveToFirst()) {<br /> String name;<br /> String phoneNumber;<br /> int nameColumn = cur.getColumnIndex(People.NAME);<br /> int phoneColumn = cur.getColumnIndex(People.NUMBER);<br /> do {<br /> // Get the field values<br /> name = cur.getString(nameColumn);<br /> phoneNumber = cur.getString(phoneColumn);<br /> // Do something with the values.<br /> HashMap<String, String> i = new HashMap<String, String>();<br /> i.put("name", name);<br /> i.put("key", phoneNumber);<br /> items.add(i);<br /> } while (cur.moveToNext());<br /> } else {<br /> HashMap<String, String> i = new HashMap<String, String>();<br /> i.put("name", "Your Phone");<br /> i.put("key", "Have No Contacts.");<br /> items.add(i);<br /> }<br /> } finally {<br /> if (cur != null)<br /> cur.close();<br /> }<br /> return items;<br /> }

 那么就能在1.6上运行了，效果截图如下：

联系人API，在Android2.0后产生变化，如果使用如上1.6版本的调用，你会发现在2.1下姓名有了，但电话号码不显示了。仔细观察可以发现，People.CONTENT_URI等调用在2.0以上的sdk中都标记了Deprecated。这一点，对于编写希望能够同时兼容1.6与2.x版本的应用造成了困难。那么，如果应用涉及到联系人的读取，非得要编写多个版本的apk了吗？ 其实，我们可以使用判断当前系统API Level的方法编写两套代码备用，这个就留给大家去实践了。

获得系统API level方法:

int version = android.provider.Settings.System.getInt(context<br /> .getContentResolver(),<br /> android.provider.Settings.System.SYS_PROP_SETTING_VERSION,<br /> 3);</p> <p>