安卓内容实战演练读取手机通讯录

<think>嗯，用户想学习如何在安卓应用中读取手机通讯录，需要一个实战教程。首先，我需要回忆安卓开发中读取通讯录的基本步骤。记得需要权限处理，因为从Android 6.0开始需要动态申请权限。所以教程里应该包括权限申请的部分，比如在manifest里声明READ_CONTACTS权限，然后运行时检查并请求。 然后，读取通讯录一般使用ContentProvider，通过ContentResolver来查询ContactsContract.CommonDataKinds.Phone这个URI。可能需要用Cursor来遍历结果，获取姓名和电话号码等字段。这部分代码需要详细说明，尤其是列名和URI的正确使用，避免常见的错误，比如列名拼写错误或者URI不正确导致的空指针。 用户提供的引用中有一些代码示例，比如引用3中的manifest文件添加了权限，引用4中的MainActivity里有动态权限检查和异步任务读取通讯录。这些可以作为参考。要注意的是，现在可能推荐使用Activity Result API来处理权限请求，而不是直接使用requestPermissions方法，不过对于初学者来说，传统方法可能更容易理解。 另外，用户可能还关心如何处理没有联系人的情况，比如引用1中的try-catch处理跳转通讯录Activity，如果失败就显示Toast提示。这可能涉及到检查Cursor是否为空，或者在查询时捕获异常，确保应用不会崩溃。 需要分步骤讲解：首先是配置权限，然后是动态申请权限，接着是查询通讯录数据，最后是显示结果。代码示例要确保语法正确，比如使用LoaderManager或者CursorLoader来异步加载数据，避免在主线程中执行耗时操作。不过引用4中使用了AsyncTask，虽然现在AsyncTask已经被弃用，但作为教程可能还是可以接受的，或者可以建议使用更现代的方法如协程或LiveData。 还要注意适配高版本Android，比如Scoped Storage的影响，但在通讯录访问方面可能没有太大变化。需要提醒用户在实际测试中检查权限是否授予，并处理拒绝权限的情况，比如显示解释或引导用户去设置页面。 最后，生成相关问题时要考虑用户可能遇到的后续问题，比如性能优化、数据解析、分页加载或者如何写入通讯录等。确保问题覆盖常见的学习路径，帮助用户深入学习。</think>### 安卓读取通讯录实战教程（分步实现） #### 一、权限配置 1. **声明静态权限** 在`AndroidManifest.xml`添加通讯录读取权限： ```xml <uses-permission android:name="android.permission.READ_CONTACTS"/> ``` 2. **动态权限申请**（Android 6.0+） 在Activity中检查并请求权限： ```java if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_CONTACTS}, REQUEST_CODE_CONTACTS); } ``` #### 二、数据查询核心代码 ```java private void loadContacts() { ContentResolver resolver = getContentResolver(); Cursor cursor = resolver.query( ContactsContract.CommonDataKinds.Phone.CONTENT_URI, new String[]{ ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME, ContactsContract.CommonDataKinds.Phone.NUMBER }, null, null, null ); List<Contact> contacts = new ArrayList<>(); if (cursor != null && cursor.moveToFirst()) { do { String name = cursor.getString(cursor.getColumnIndex( ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME)); String number = cursor.getString(cursor.getColumnIndex( ContactsContract.CommonDataKinds.Phone.NUMBER)); contacts.add(new Contact(name, number)); } while (cursor.moveToNext()); cursor.close(); } // 更新UI显示数据 } ``` #### 三、完整流程示例 ```kotlin class ContactsActivity : AppCompatActivity() { private val REQUEST_CODE = 100 override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_contacts) if (checkSelfPermission(READ_CONTACTS) == PERMISSION_GRANTED) { loadContacts() } else { requestPermissions(arrayOf(READ_CONTACTS), REQUEST_CODE) } } override fun onRequestPermissionsResult( requestCode: Int, permissions: Array<out String>, grantResults: IntArray ) { if (requestCode == REQUEST_CODE && grantResults[0] == PERMISSION_GRANTED) { loadContacts() } else { Toast.makeText(this, "权限被拒绝", Toast.LENGTH_SHORT).show() } } private fun loadContacts() { // 实现上述数据查询逻辑 } } ``` #### 四、注意事项 1. 使用`CursorLoader`实现异步加载（避免主线程阻塞）[^3] 2. 联系人数据字段说明： - `DISPLAY_NAME_PRIMARY`: 联系人显示名称 - `PHOTO_THUMBNAIL_URI`: 缩略图URI - `CONTACT_LAST_UPDATED_TIMESTAMP`: 最后更新时间戳 3. 处理空数据情况（参考`try-catch`异常捕获）[^1]