本章主要介紹了如何使用隱式 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 是個數據定位符，指向用戶所選聯系人。<p id="inline_code"></p>
@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 中取出。代碼在 <a href="#inline_code">2.2.1節</a>
3.2.2 通過獲取到的聯系人 ID 查詢電話
-
首先要在 AndroidManifest.xml 中，<application> 標簽前面加上申請權限的標簽
<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);
}
});
GitHub Page: kniost.github.io
簡書：http://www.lxweimin.com/u/723da691aa42
