《Android编程权威指南》之隐式intent

小知识，大挑战！本文正在参与“程序员必备小知识”创作活动。

《Android编程权威指南》第15章，将使用隐式intent发送短消息给Crime嫌疑人。

显式 intent —— 指定要启动的 activity 类，操作系统会负责启动它。隐式 intent —— 描述要完成的任务，操作系统就会找到合适的应用，并在其中启动相应的 activity。

一、添加按钮部件

先在 CrimeFragment 的布局中添加两个投诉用按钮。

    <string name="crime_suspect_text">Choose Suspect</string>
    <string name="crime_report_text">Send Crime Report</string>

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

    <CheckBox
        .../>

    <Button
        android:id="@+id/crime_suspect"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/crime_suspect_text" />

    <Button
        android:id="@+id/crime_report"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/crime_report_text" />
</LinearLayout>

二、添加嫌疑人信息至模型层

在 Crime.kt 新增成员变量。

@Entity
data class Crime(
    @PrimaryKey val id: UUID = UUID.randomUUID(),
    var title: String = "",
    var date: Date = Date(),
    var isSolved: Boolean = false,
    var requiresPolice: Boolean = false,
    var suspect:String = ""
)

打开 CrimeDatabase.kt，修改数据库版本，由 1 到 2。

@Database(entities = [Crime::class], version = 2, exportSchema = false)
@TypeConverters(CrimeTypeConverters::class)
abstract class CrimeDatabase : RoomDatabase() {
    abstract fun crimeDao(): CrimeDao
}

val migration_1_2 = object :Migration(1,2){
    override fun migrate(database: SupportSQLiteDatabase) {
        database.execSQL(
            "ALTER TABLE Crime ADD COLUMN suspect TEXT NOT NULL DEFAULT ''"
        )
    }
}

创建一个Migration对象更新数据库，Migration类构造函数需要两个参数，第一个是迁移前的数据库版本，第二个是迁移到的版本。

打开 CrimeRepository.kt，在创建CrimeDatabase时，把Migration添加给Room。

class CrimeRepository private constructor(context: Context) {

    private val database: CrimeDatabase = Room.databaseBuilder(
        context.applicationContext,
        CrimeDatabase::class.java,
        DATABASE_NAME
    ).addMigrations(migration_1_2).build()
  ...
}

为数据库转换提供迁移很重要。如果不提供，Room则会先删除旧版本数据库，再创建新版本数据库。这意味着数据会全部丢失，那就不太好了。

三、使用格式化字符串

接下来就是使用带有占位符（可在应用运行时替换）的格式化字符串。

在string.xml中添加字符串资源，%1$s、%2$s等特殊字符串是占位符，它们接受字符串参数。

    <string name="crime_report">%1s!The Crime was discovered on 2%s.%3s,and %4s</string>
    <string name="crime_report_solved">The case is solved</string>
    <string name="crime_report_unsolved">The case is not solved</string>
    <string name="crime_report_no_suspect">there is no suspect</string>
    <string name="crime_report_suspect">the suspect is %s.</string>
    <string name="crime_report_subject">CriminalIntent Crime Report</string>
    <string name="send_report">Send crime report via</string>

在 CrimeFragment.kt 中，添加 getCrimeReport() 函数：

private const val DATE_FORMAT = "EEE, MMM, dd"

class CrimeFragment : Fragment(), DatePickerFragment.Callbacks {
...
    private fun getCrimeReport(): String {
        val solvedStr = if (mCrime.isSolved) {
            getString(R.string.crime_report_solved)
        } else {
            getString(R.string.crime_report_unsolved)
        }

        val dateStr = android.text.format.DateFormat.format(DATE_FORMAT, mCrime.date).toString()
        var suspect = if (mCrime.suspect.isBlank()) {
            getString(R.string.crime_report_no_suspect)
        } else {
            getString(R.string.crime_report_suspect, mCrime.suspect)
        }

        return String.format(resources.getString(R.string.crime_report), mCrime.title, dateStr, solvedStr, suspect)
    }
}

四、使用隐式intent

隐式 intent 的组成：

要执行的操作

通常以Intent类中的常量来表示。比如，URL 是 Intent.ACTION_VIEW；邮件使用 Intent.ACTION_SEND。

Intent 介绍官方地址：developer.android.com/reference/a…
待访问数据的位置

比如网页的URL，文件的URI，或者是指向ContentProvider中某条记录的某个内容URI（content URI）。
操作涉及的数据类型

指MIME形式的数据类型，比如 text/html 或 audio/mpeg3。
可选类别

developer.android.com/guide/compo…

注意，显式intent也可以使用隐式intent的操作和数据部分。这相当于要求特定的activity去做特定的事。

接下来就是使用一些隐式 intent 发送信息，在CrimeFragment中给发送的那个button添加点击事件：

        mBinding.btnCrimeReport.setOnClickListener {
            Intent(Intent.ACTION_SEND).apply {
                type = "text/plain"
                putExtra(Intent.EXTRA_TEXT, getCrimeReport())
                putExtra(Intent.EXTRA_SUBJECT, getString(R.string.crime_report_subject))
            }.also { intent -> startActivity(intent) }
        }

消息内容和主题是作为 extra 附加到 intent 上的。注意，这些 extra 信息使用了Intent类中定义的常量。

点击效果： demo

创建另一个隐式intent，让用户从联系人应用里选择嫌疑人。

...

class CrimeFragment : Fragment(), DatePickerFragment.Callbacks {
...
    val startForResult =
        registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {
            if (it.resultCode == Activity.RESULT_OK) {
                val contactUri: Uri = it.data?.data!!
                val queryFilds = arrayOf(ContactsContract.Contacts.DISPLAY_NAME)
                val cursor = requireActivity().contentResolver.query(contactUri,queryFilds,null,
                    null,null)
                cursor.use {
                    if (it?.count == 0){
                        return@use
                    }
                    it?.moveToFirst()
                    val suspect = it?.getString(0)
                    mCrime.suspect = suspect!!
                    crimeDetailViewModel.saveCrime(mCrime)
                    mBinding.btnCrimeSuspect.text = suspect
                }
            }
        }
...
               mBinding.btnCrimeSuspect.apply {
            val pickContactIntent =
                Intent(Intent.ACTION_PICK, ContactsContract.Contacts.CONTENT_URI)
            setOnClickListener {
                startForResult.launch(pickContactIntent)
            }
        }
...
    private fun updateUI() {
        ...
        if (mCrime.suspect.isNotEmpty()){
            mBinding.btnCrimeSuspect.text = mCrime.suspect
        }
    }
...
}

下面会涉及到一个知识点，是有关于 android 四大组件之一的 content provider，详情参考：developer.android.com/guide/topic…

上述第二个隐式 intent 其实有风险会奔溃了，万一用户手机上没有联系人的应用呢。这个时候的解决办法就是，通过操作系统中的 PackageManager 类进行自检。

        mBinding.btnCrimeSuspect.apply {
            val pickContactIntent =
                Intent(Intent.ACTION_PICK, ContactsContract.Contacts.CONTENT_URI)
            setOnClickListener {
                startForResult.launch(pickContactIntent)
            }
            val packageManager: PackageManager = requireActivity().packageManager
            val resolvedActivity: ResolveInfo? =
                packageManager.resolveActivity(pickContactIntent, PackageManager.MATCH_DEFAULT_ONLY)
            if (resolvedActivity == null) {
                isEnabled = false
            }
        }

PackageManager 知道 Android设备上安装了哪些组件以及哪些 activity。调用resolveActivity(Intent, Int) 函数，可以找到匹配给定 Intent 任务的 activity。flag标志 MATCH_DEFAULT_ONLY 限定只搜索带 CATEGORY_DEFAULT 标志的 activity。

如果搜到目标，它会返回ResolveInfo告诉我们找到了哪个activity；如果找不到，必须禁用嫌疑人按钮，否则应用就会崩溃。

如果想验证过滤器，可以随意添加个别的类别的 intent。

五、挑战练习：又一个隐式intent

新增一个按钮，允许用户直接拨打陋习嫌疑人的电话。

这里会涉及到一个运行时的权限请求，有关的知识点参考：developer.android.com/training/pe… 也可以直接使用其他人封装好的权限请求库，用起来很方便。比如说：github.com/guolindev/P…

下次再来更新这个挑战练习！下次一定！补上！

六、其他

CriminalIntent 项目 Demo 地址： github.com/visiongem/A…

🌈关注我吖~❤️

公众号：妮K妮K妮