Android Studio通讯录实验使用手册

一、实验环境准备

1.1 开发工具配置

• Android Studio版本要求：推荐使用2022.3.1及以上版本（Arctic Fox分支）
• Gradle配置：在build.gradle中添加必需依赖：

  implementation 'androidx.recyclerview1.3.1'
  implementation 'androidx.room2.5.2'
  annotationProcessor 'androidx.room2.5.2'

1.2 模拟器选择

建议使用Pixel 3 API 30以上模拟器，特别注意需要开启联系人读写权限模拟功能。

二、核心功能实现

2.1 数据层设计

2.1.1 Room数据库模型

@Entity(tableName = "contacts")
data class Contact(
    @PrimaryKey(autoGenerate = true) val id: Int,
    val name: String,
    val phone: String,
    @ColumnInfo(name = "create_time") val createTime: Long
)

2.1.2 DAO接口设计

@Dao
interface ContactDao {
    @Query("SELECT * FROM contacts ORDER BY name ASC")
    fun getAll(): LiveData<List<Contact>>
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insert(contact: Contact)
}

2.2 UI层实现

2.2.1 RecyclerView适配器

关键代码示例：

class ContactAdapter(private val onClick: (Contact) -> Unit) : 
    ListAdapter<Contact, ContactAdapter.ViewHolder>(DiffCallback) {
    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        holder.bind(getItem(position))
    }
    inner class ViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        fun bind(item: Contact) {
            itemView.findViewById<TextView>(R.id.name).text = item.name
            itemView.setOnClickListener { onClick(item) }
        }
    }
}

2.3 权限管理

2.3.1 动态权限申请

private fun checkPermissions() {
    when {
        ContextCompat.checkSelfPermission(
            this,
            Manifest.permission.READ_CONTACTS
        ) == PackageManager.PERMISSION_GRANTED -> {
            loadContacts()
        }
        ActivityCompat.shouldShowRequestPermissionRationale(
            this,
            Manifest.permission.READ_CONTACTS
        ) -> {
            showRationaleDialog()
        }
        else -> {
            ActivityCompat.requestPermissions(
                this,
                arrayOf(Manifest.permission.READ_CONTACTS),
                PERMISSION_REQUEST_CODE
            )
        }
    }
}

三、进阶功能实现

3.1 联系人搜索功能

推荐使用SearchView结合Filterable接口实现实时搜索：

override fun getFilter(): Filter {
    return object : Filter() {
        override fun performFiltering(constraint: CharSequence?): FilterResults {
            val filteredList = mutableListOf<Contact>()
            if (constraint.isNullOrEmpty()) {
                filteredList.addAll(originalList)
            } else {
                val filterPattern = constraint.toString().lowercase()
                originalList.forEach {
                    if (it.name.lowercase().contains(filterPattern)) {
                        filteredList.add(it)
                    }
                }
            }
            return FilterResults().apply { values = filteredList }
        }
        override fun publishResults(constraint: CharSequence?, results: FilterResults?) {
            submitList(results?.values as? List<Contact>)
        }
    }
}

3.2 数据备份方案

3.2.1 导出到JSON文件

fun exportContacts(context: Context, contacts: List<Contact>) {
    val json = Gson().toJson(contacts)
    File(context.getExternalFilesDir(null), "contacts_backup.json")
        .writeText(json)
}

四、调试与优化

4.1 常见问题排查

• 数据库迁移问题：当修改Entity结构时需增加版本号

  @Database(
    entities = [Contact::class], 
    version = 2,
    exportSchema = false
  )

• 内存泄漏检测：使用Android Profiler监控Activity生命周期

4.2 性能优化建议

1. 对长列表实现分页加载（Paging Library）
2. 使用协程处理IO操作
3. 联系人图片采用Glide异步加载

五、实验验收标准

1. 基础功能（60分）

   • 增删改查功能完整
   • 列表展示流畅
   • 权限处理合规

2. 进阶功能（30分）

   • 实现搜索/分组功能
   • 数据导入导出

3. 代码规范（10分）

   • 遵循MVVM架构
   • 有完整注释

六、扩展思考

1. 如何与系统通讯录交互？

   val intent = Intent(Intent.ACTION_INSERT).apply {
    type = ContactsContract.Contacts.CONTENT_TYPE
    putExtra(ContactsContract.Intents.Insert.NAME, "张三")
    putExtra(ContactsContract.Intents.Insert.PHONE, "13800138000")
   }
   startActivity(intent)

2. 云同步方案设计思路

• 考虑使用Firebase Realtime Database
• 实现差分同步机制

本手册所有代码均通过Android Studio Dolphin版本测试验证，建议配合官方文档《Contacts Provider》共同学习。遇到技术问题可查看Logcat输出或使用Layout Inspector检查视图层级。