本章主要介绍了如何使用隐式 Intent 启动其他应用的 Activity,以及从用隐式 Intent 的方法启动的应用中获取数据
GitHub 地址:
完成15章但未完成挑战
完成15章挑战1
完成15章挑战2
1. 使用格式化字符串
在string.xml
中定义字符串时,我们可以先用占位符代替一些内容,然后在引用的时候用相应的字符串代替占位符,得到所需要的字符串。
比如一个定义好的字符串:
<string name="string_name">我的名字叫%1$s,我有%2$d个苹果</string>
引用时可以这样:
String s = getResources()
.getString(R.string.string_name, "王大宝", 512);
// 结果应该是 s == "我的名字叫王大宝,我有512个苹果"
这种字符串资源用作模板再方便不过了。
2. 使用隐式 intent
Intent 对象用来向操作系统说明需要处理的任务。使用显式 intent,我们需指定要操作系统 启动哪个 activity。而使用隐式 intent,只需告诉操作系统我们想要做什么,操作系统就会去启动能够胜任工作任务的 activity。如果找到多个符合的 activity,用户会看到一个可选应用列表,然后就看用户如何选择了。
2.1 隐式 intent 的组成
下面是一个隐式 intent 的主要组成部分:
- 要执行的操作。通常以 Intent 类中的常量来表示。例如,要访问查看某个 URL,可以使用 Intent.ACTION_VIEW;要发送邮件,可以使用 Intent.ACTION_SEND。
- 要访问数据的位置。这可能是设备以外的资源,如某个网页的 URL,也可能是指向某个文件的 URI,或者是指向 ContentProvider 中某条记录的某个内容 URI(content URI)。
- 操作涉及的数据类型。 这指的是 MIME 形式的数据类型,如
text/html
或audio/mpeg3
。如果一个 intent 包含数据位置,那么通常可以从中推测出数据的类型。 - 可选类别。如果操作用于描述具体要做什么,那么类别通常用来描述我们是何时、何地或者如何使用某 个 activity 的。例如,Android 的
android.intent.category.LAUNCHER
类别表明,activity 应该显示在顶级应用启动器中;而android.intent.category.INFO
类别表明,虽然 activity 向用户显示了包信息,但它不应该显示在启动器中。
和显式 intent 一样,隐式 intent 也可以包含 extra 信息。不过,操作系统在寻找适用的 activity 时, 不会使用附加在隐式 intent 上的任何 extra。
注意,显式 intent 也可以使用隐式 intent 的操作和数据部分。这相当于要求特定 activity 去处理特定任务。
2.1 发送消息
如果我们要发送一段文字消息,应该创建一个用于发送文字消息的 intent:
// 首先指定动作为 Intent.ACTION_SEND
Intent i = new Intent(Intent.ACTION_SEND);
// 设置文字类别,这里是纯文本
i.setType("text/plain");
// 设置文字内容
i.putExtra(Intent.EXTRA_TEXT, getCrimeReport());
// 设置主题内容
i.putExtra(Intent.EXTRA_SUBJECT,
getString(R.string.crime_report_subject));
// 每一次都会弹出选择发送的应用弹框
i = Intent.createChooser(i, getString(R.string.send_report));
startActivity(i);
没错,使用一个隐式的 intent 就是这么简单,对于不同的需求,查询文档,使用相应的方法调用隐式 intent 就可以啦。
2.2 获取联系人信息
现在,创建另一个隐式 intent,实现让用户从联系人应用里选择嫌疑人。新建的隐式 intent 将 由操作以及数据获取位置组成。
- 操作为
Intent.ACTION_PICK
。 - 联系人数据获取位置为
ContactsContract.Contacts.CONTENT_URI
。
简而言之,就是请 Android 帮忙从联系人数据库里获取某个具体联系人。
因为要获取启动 activity 的返回结果,我们调用 startActivityForResult(…)方法并传 入 intent 和 RequestCode。
private static final int REQUEST_CONTACT = 1;
……
Intent pickContact = new Intent(Intent.ACTION_PICK,
ContactsContract.Contacts.CONTENT_URI);
startActivityForResult(pickContact, REQUEST_CONTACT);
2.2.1 从联系人列表中获取联系人数据
现在,我们需要从联系人应用中获取返回结果。很多应用都会共享联系人信息,因此 Android 提供了一个深度定制的 API 用于处理联系人信息,这主要是通过 ContentProvider 类来实现的。 该类的实例封装了联系人数据库并提供给其他应用使用。
我们可以通过一个 ContentResolver 访问 ContentProvider。
前面,我们以 ACTION_PICK 启动了 activity 并要求返回结果,因此调用 onActivityResult (…)方法会接收到一个 intent。该 intent 包括了数据 URI。这个 URI 是个数据定位符,指向用户所选联系人。
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
if (resultCode != Activity.RESULT_OK) {
return;
}
if (requestCode == REQUEST_CONTACT && data != null) {
Uri contactUri = data.getData();
// Specify which fields you want your query to return
// values for. 就相当于要请求的数据域
String [] queryFields = new String[] {
ContactsContract.Contacts._ID,
ContactsContract.Contacts.DISPLAY_NAME
};
// Perform your query - the contactUri is like a "where"
// clause here 相当于一个查询数据库的语句
// 首先 contactUri 定位了数据库的表,queryFields 定义了要查的语句
Cursor c = getActivity().getContentResolver()
.query(contactUri, queryFields, null, null, null);
try {
// Double-check that you actually got results
if (c.getCount() == 0) {
return;
}
// Pull out the first column of the first row of data -
// that is your suspect's name.
c.moveToFirst();
// 获得嫌疑人的名字
String suspect = c.getString(
c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
// 获得嫌疑人的 ID
String suspectId = c.getString(
c.getColumnIndex(ContactsContract.Contacts._ID));
} finally {
// 最后不要忘了关闭 cursor
c.close();
}
}
}
2.2.2 联系人信息的使用权限
我们如何获得读取联系人数据库的权限呢?实际上,这是联系人应用将其权限临时赋给了我们。联系人应用具有使用联系人数据库的全部权限。
联系人应用返回包含在 intent 中的 URI 数据给父 activity 时 , 会添加一个 Intent.FLAG_GRANT_READ_URI_PERMISSION
标志。该标志告诉 Android,CriminalIntent
应用中的父 activity 可以使用联系人数据一次。这很有用,因为不需要访问整个联系人数据库,我们只需要访问其中的一条联系人信息。
2.2.3 检查可响应任务的 activity
有些设备上根本就没有联系人应用,这时如果操作系统找不到匹配的 activity,应用就会崩溃!
解决办法是在调用最开始的时候通过操作系统中的 PackageManager 类进行自检,然后决定是否禁用这个按钮。
PackageManager packageManager = getActivity().getPackageManager();
Intent pickContact = new Intent(Intent.ACTION_PICK,
ContactsContract.Contacts.CONTENT_URI);
if (packageManager.resolveActivity(pickContact,
PackageManager.MATCH_DEFAULT_ONLY) == null) {
mSuspectButton.setEnabled(false);
}
Android 设备上安装了哪些组件以及包括哪些 activity,PackageManager 类全都知道。调用resolveActivity(Intent, int)
方法,我们可以找到匹配给定 Intent 任务的 activity。flag 标志MATCH_DEFAULT_ONLY
限定只搜索带CATEGORY_DEFAULT
标志的 activity。这和 startActivity(Intent)方法类似。
3. 挑战联系
3.1 ShareCompat
使用 ShareCompat.IntentBuilder 内部类用于创建发送消息的 Intent。
将原来的代码替换如下:
ShareCompat.IntentBuilder.from(getActivity())
.setType("text/plain")
.setSubject(getString(R.string.crime_report_subject))
.setText(getCrimeReport())
.setChooserTitle(R.string.send_report)
.startChooser();
/* Intent i = new Intent(Intent.ACTION_SEND);
i.setType("text/plain");
i.putExtra(Intent.EXTRA_TEXT, getCrimeReport());
i.putExtra(Intent.EXTRA_SUBJECT,
getString(R.string.crime_report_subject));
i = Intent.createChooser(i, getString(R.string.send_report));
startActivity(i);*/
3.2 又一个隐式 Intent
这个问题分三步解决:
- 获取选择的联系人的 _ID (在 ContactsContract.Contacts 表中)
- 通过获取到的联系人 ID 在 CommonDataKinds.Phone 表中查询联系人的电话
- 通过电话创建隐式 Intent
在开始之前,数据库中要加入 suspect 的 PhoneNumber 这一列,按照之前的步骤更改 Model 层和数据库建表语句以及数据库操作函数。
然后要加入一个拨打电话的按钮,我的想法是,在选择联系人之前或者联系人没有电话的时候,这个按钮是不能点击的,并会显示相应的文字。
3.2.1 获取联系人 ID
在按下选择联系人的那一步的 queryField 里面加入请求联系人 Id 的列即可。最后再从 Cursor 中取出。代码在 2.2.1节
3.2.2 通过获取到的联系人 ID 查询电话
首先要在 AndroidManifest.xml 中, 标签前面加上申请权限的标签
<uses-permission android:name="android.permission.READ_CONTACTS"/>
注意这里有个坑在,由于 Android 6.0 新加入了运行时权限,所有 targetAPI 为23及以上的应用都需要在使用时申请权限,如果不加入申请权限的代码,应用将崩溃。为了节约时间和代码量,我在完成这个挑战的时候将 Project 的 targetAPI 设为22以避免这种情况的发生。
在获取到 suspect 的 ID 的之后,通过 ID 查询其第一个电话号码,我写了一个方法用于获取
private String getPhoneNumberById(String contactId) { // 首先找到需要查找的表的 URI Uri phoneUri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI; // 然后还是通过 ContentResolver 对数据进行请求 // 跟数据库的操作十分类似 Cursor c = getActivity().getContentResolver().query( phoneUri, // 要请求的数据是 NUMBER,即电话号码 new String[] { ContactsContract.CommonDataKinds.Phone.NUMBER }, // 相当于 Where 语句,注意这里不是 _ID,应该是 CONTACT_ID // 对于 Phone 表来说,CONTACT_ID 应该是其外键,_ID 是主键 ContactsContract.CommonDataKinds.Phone.CONTACT_ID + "= ? ", new String[] { contactId }, null ); String phoneNumber = null; try { if (c.getCount() == 0) { return phoneNumber; } // 只取第一个数据 c.moveToFirst(); phoneNumber = c.getString(0); } finally { c.close(); } return phoneNumber; }
还要根据电话号码的值来决定拨打电话按钮的状态
private void handleCallSuspectButton(String phoneNumber) { if (phoneNumber == null || phoneNumber.isEmpty()) { mCallSuspectButton.setText(getString(R.string.crime_call_no_phone_number)); mCallSuspectButton.setEnabled(false); } else { mCallSuspectButton.setText(getString(R.string.crime_call_suspect, phoneNumber)); mCallSuspectButton.setEnabled(true); } }
3.2.3 建立拨打电话的隐式 Intent
这个就和书上的差不多啦~
mCallSuspectButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Uri number = Uri.parse("tel:" + mCrime.getPhoneNumber());
Intent i = new Intent(Intent.ACTION_DIAL, number);
startActivity(i);
}
});