本章主要介紹瞭如何使用隱式 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 的主要組成部分：

1. 要執行的操作。通常以 Intent 類中的常量來表示。例如，要訪問檢視某個 URL，可以使用 Intent.ACTION_VIEW;要傳送郵件，可以使用 Intent.ACTION_SEND。
2. 要訪問資料的位置。這可能是裝置以外的資源，如某個網頁的 URL，也可能是指向某個檔案的 URI，或者是指向 ContentProvider 中某條記錄的某個內容 URI(content URI)。
3. 操作涉及的資料型別。 這指的是 MIME 形式的資料型別，如text/html或audio/mpeg3。如果一個 intent 包含資料位置，那麼通常可以從中推測出資料的型別。
4. 可選類別。如果操作用於描述具體要做什麼，那麼類別通常用來描述我們是何時、何地或者如何使用某 個 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

這個問題分三步解決：

1. 獲取選擇的聯絡人的 _ID （在 ContactsContract.Contacts 表中）
2. 通過獲取到的聯絡人 ID 在 CommonDataKinds.Phone 表中查詢聯絡人的電話
3. 通過電話建立隱式 Intent

在開始之前，資料庫中要加入 suspect 的 PhoneNumber 這一列，按照之前的步驟更改 Model 層和資料庫建表語句以及資料庫操作函式。

然後要加入一個撥打電話的按鈕，我的想法是，在選擇聯絡人之前或者聯絡人沒有電話的時候，這個按鈕是不能點選的，並會顯示相應的文字。

3.2.1 獲取聯絡人 ID

在按下選擇聯絡人的那一步的 queryField 裡面加入請求聯絡人 Id 的列即可。最後再從 Cursor 中取出。程式碼在 2.2.1節

3.2.2 通過獲取到的聯絡人 ID 查詢電話

1. 首先要在 AndroidManifest.xml 中， 標籤前面加上申請許可權的標籤

   <uses-permission android:name="android.permission.READ_CONTACTS"/>

   注意這裡有個坑在，由於 Android 6.0 新加入了執行時許可權，所有 targetAPI 為23及以上的應用都需要在使用時申請許可權，如果不加入申請許可權的程式碼，應用將崩潰。為了節約時間和程式碼量，我在完成這個挑戰的時候將 Project 的 targetAPI 設為22以避免這種情況的發生。

2. 在獲取到 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;
   }
   

3. 還要根據電話號碼的值來決定撥打電話按鈕的狀態

   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);
    }
});