【筆記】【從Android Guide溫習Android 三】意圖 (Intent)

時間 2019-11-13

標籤筆記 android guide 溫習意圖 intent 欄目 Android 简体版

原文原文鏈接

【筆記】【從Android Guide溫習Android 三】意圖 (Intent)

官方網站鏈接html

是什麼

直譯過來很貼切"意圖". 主要用於啓動Activity,Service以及Broadcast。java

建立Intent

包含下面幾大部分函數

前四種(Component name. Action, Data, Category)，系統經過這些屬性判斷啓動哪一個組建(Component)。測試

Component name網站

目標組建, 注意這個參數是 ComponentName 類，該類由包名和類名組成。ui

你一般調用以下方法:

// case 1
  Intent intent = new Intent(this, IntentActivity.class);
  // case 2
  Intent intent = new Intent();
  intent.setComponent(new ComponentName(stringOfPackage, stringOfClass));
  // case 3
  Intent intent = new Intent();
  intent.setClassName(stringOfPackage, stringOfClass)

Action

"意圖"執行的具體活動。能夠理解爲一種標識。每一種有本身的含義。Intent提供給咱們一些公用的Action。

由於Intent能夠攜帶數據，因此每種公用Action也表明是否有輸入輸出數據。

同時，Intent有兩種分類，一種被Activity使用，另外一種爲Broardcast所用。

下面舉幾個例子，文尾會附上全部Action。

Activity:
- ACTION_MAIN: 標識程序入口。沒有數據返回。
- ACTION_VIEW: 展現用戶數據。可設置輸入的URI用來接受數據。
- ACTION_INSERT: 插入一條空數據到所提供的容器。輸入的URI是待插入數據的目錄。
- ACTION_EDIT: 爲傳入數據，提供明確的可修改的訪問。輸入的URI是待修改的數據。
```
最後兩個或許看上不是很明白。
  能夠結合ContentProvider去理解。
  插入或修改數據，須要告訴Provider一個URI.該URI標識出你要插入或修改的表或行數據。
  因此你若啓動一個Activity去完成此操做，靈活性的方法是給他待操做的URI。
```
BroadCast:
- ACTION_MEDIA_BAD_REMOVAL: 移動媒體到SD卡時，要移動的目標位置是unmounted的。
- ACTION_MEDIA_BUTTON: 點擊"Media Button"
- ACTION_MEDIA_REMOVED: 媒體被刪除。
Data

指向該數據的URI或MIME類型。
- setData() 設置URI
- setType() 設置MIME
- 上述兩函數互斥的，若需同時設置這兩項，須要經過 setDataAndType()。
Category

標識目標組建的分類。多數狀況下不須要此參數，固然，需不須要確定依賴於你AndroidManifest中的設置。

Extras

須要攜帶的數據經過此屬性存儲。

經過putExtra() 存入, getXXXExtra()讀取

在這裏掃個盲,原來被某測試同窗問了屢次，關於putExtra和putExtras是否同樣，估計是由於不清楚putExtra最終存到了哪裏。直接上源碼:

// putExtra() 和 putExtras() 是等價的。
  public Intent putExtra(String name, boolean value) {
      if (mExtras == null) {
          mExtras = new Bundle();
      }
      mExtras.putBoolean(name, value);
      return this;
  }
  public Intent putExtras(Bundle extras) {
      if (mExtras == null) {
          mExtras = new Bundle();
      }
      mExtras.putAll(extras);
      return this;
  }
  public Intent putExtras(Intent src) {
      if (src.mExtras != null) {
          if (mExtras == null) {
              mExtras = new Bundle(src.mExtras);
          } else {
              mExtras.putAll(src.mExtras);
          }
      }
      return this;
  }

  // Bundle putXXX
  // mMap type is ArrayMap<String, Object>()
  public void putLong(String key, long value) {
      unparcel();
      mMap.put(key, value);
  }

  //Bundle putAll method...
  public void putAll(Bundle map) {
      unparcel();
      map.unparcel();
      mMap.putAll(map.mMap);
      // fd state is now known if and only if both bundles already knew 
      mHasFds |= map.mHasFds;
      mFdsKnown = mFdsKnown && map.mFdsKnown;
  }

Flags

終於見到"萬能的"flag了。

官網舉了兩個例子：
- 系統如何加載Activity, 如Activity應該加入到哪一個任務中
- 加載後有什麼操做, 如是否加入到最近的Activity.

隱式Intent如何肯定目標組建的

影響因素有如下幾點：

Action

在Manifest中的intent-filter節點中，定義0個或多個action節點，以下.

<intent-filter>
      <action android:name="android.intent.action.EDIT" />
      <action android:name="android.intent.action.VIEW" />
      ...
  </intent-filter>

匹配原則：

查找包含的name屬性是否與請求的intent相同，相同則進行下面的判斷。

Category

在Manifest中的intent-filter節點中，定義0個或多個category節點，以下.
```
<intent-filter>
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      ...
  </intent-filter>
```
匹配原則：
```
查找包含的name屬性是否與請求的intent相同，相同則進行下面的判斷。
```
當隱式intent是要啓動某個Activity時，默認會添加 CATEGORY_DEFAULT 分類。

因此被啓動的Activity要在intent-filter中加上"android.intent.category.DEFAULT"這個分類。

Data

在Manifest中的intent-filter節點中，定義0個或多個data節點，以下.

<intent-filter>
      <data android:mimeType="video/mpeg" android:scheme="http" ... />
      <data android:mimeType="audio/mpeg" android:scheme="http" ... />
      ...
  </intent-filter>

Data有兩部分組成，一部分是 URI 另外一部分是 MIME

URL由這些4大屬性組成: scheme, host, port, path.

下面是官方的例子,URI與屬性的對應圖

content://com.example.project:200/folder/subfolder/etc
  ------- | -------------------|---|--------------------
  scheme  |        host        |port|       path

4大屬性依次依賴，前者若沒有聲明，後者的設置將被忽略。

URI的比較原則：僅比較intent的URI包含的部分。即若只包含scheme則匹配scheme，包含scheme和host則比較二者。

Path的模糊匹配：* 能夠匹配全部。

匹配原則：比較複雜。

下表 - 標識未聲明此屬性，+ 標識已聲明。當四條均符合是，則匹配成功。

URI	MIME	命中組建條件(URI)	命中組建條件(MIME)
-	-	-	-
+	-	+	-
-	+	-	+
+	+	+	+

還有不少細節，請參照官網，Note如下的部分。

匹配Intent

官網舉了兩點例子，第二點會結合個人代碼說明。

Android如何確認打開app時應選擇那個組建首先啓動。
- ACTION_MAIN
- CATEGORY_LAUNCHER

能夠利用方法查找符合intent的組建。

PackageManager中的 query...() 和 resolve...()

//獲取符合的intent並顯示在ListView中。

  public static final String INTENT_FILTER = "com.tangyu.component.demo.action";                                                                              

  // method start ...
  mVList = (ListView) findViewById(R.id.demo_launcher_list);
  List<ResolveInfo> resolveInfoList = getPackageManager().queryIntentActivities(new Intent(INTENT_FILTER, null), 0);

   LinkedList<String> activities = new LinkedList<String>();
   for (int i = 0; i < resolveInfoList.size(); ++i) {
       String fullname = resolveInfoList.get(i).activityInfo.name;
       Pattern pattern = Pattern.compile("\\.");
       String[] split = pattern.split(fullname);
       String activityName = split[split.length - 1]; 
       activities.add(activityName);
   }   
   mVList.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, activities));
  // method end.

PendingIntent

是Intent的包裝類，獲取外界APP的信任權限，並使用攜帶的intent啓動他。內容仍是比較多的。之後在系統複習。

例子

官網的例子很到位的說

顯式Intent 用Download服務爲例，傳入URI進行download。
隱式Intent 要Share某些數據，如有匹配的Activity，則啓動它。
其中也介紹了 App chooser 這個比較直觀的體現隱式的含義。

接收顯式Intent

在AndroidManifest.xml中設置<intent-filter>, 下面是官網的例子

<activity android:name="MainActivity">
      <!-- This activity is the main entry, should appear in app launcher -->
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
  </activity>

  <!-- 看！！是能夠設置多個不一樣的intent-filter -->
  <activity android:name="ShareActivity">
      <!-- This activity handles "SEND" actions with text data -->
      <intent-filter>
          <action android:name="android.intent.action.SEND"/>
          <category android:name="android.intent.category.DEFAULT"/>
          <data android:mimeType="text/plain"/>
      </intent-filter>
      <!-- This activity also handles "SEND" and "SEND_MULTIPLE" with media data -->
      <intent-filter>
          <action android:name="android.intent.action.SEND"/>
          <action android:name="android.intent.action.SEND_MULTIPLE"/>
          <category android:name="android.intent.category.DEFAULT"/>
          <data android:mimeType="application/vnd.google.panorama360+jpg"/>
          <data android:mimeType="image/*"/>
          <data android:mimeType="video/*"/>
      </intent-filter>
  </activity>

下面是TYComponent項目的AndroidManifest.xml

<activity android:name=".demo.DemoLauncher">
          <intent-filter>
              <action android:name="android.intent.action.MAIN"/>
              <category android:name="android.intent.category.LAUNCHER"/>
          </intent-filter>
      </activity>
      <!-- horizontal list view -->
      <activity
          android:name=".demo.HorizontalListViewDemo"
          android:label="@string/app_name">
          <intent-filter>
              <action android:name="com.tangyu.component.demo.action"/>
          </intent-filter>
      </activity>
      <activity
          android:name=".demo.HorizontalListViewDemo4Grid"
          android:label="@string/app_name">
          <intent-filter>
              <action android:name="com.tangyu.component.demo.action"/>
          </intent-filter>
      </activity>

      <!-- remind service -->
      <activity android:name=".demo.service.remind.ActDemoRemindService"
                android:label="@string/app_name">
          <intent-filter>
              <action android:name="com.tangyu.component.demo.action"/>
          </intent-filter>
      </activity>

除了Launcher之外，組建都會有<action android:name="com.tangyu.component.demo.action"/>

這是爲了實現獲取具備相同Action的組建，並把他們顯示到列表中。學自於ApiDemo。

再者，若將com.tangyu.component.demo.action 換爲 android.intent.action.MAIN 會不會有影響？

不會有影響，雖然組建都是程序的入口。可是因爲第一個有<category android:name="android.intent.category.LAUNCHER"/> ，因此打開應用，還是從demo.DemoLauncher啓動。

在這裏有一下幾點須要注意

顯式意圖會直接送給目標，不會管該組建的Intent-filters
避免運行其餘APP的組建，一般用顯式意圖啓動組建
全部的Activity的intent-filters都要定義在AndroidManifest中，可是broadcast的filter能夠動態綁定。經過 registerReceiver()) 和 unregisterReceiver());
若是你不想讓其餘APP啓動你的組建，設置exported 爲false