Android 會使用意圖及相關聯的額外功能,讓使用者快速分享資訊,並 輕鬆使用喜愛的應用程式
Android 提供兩種在應用程式之間分享資料的方式:
- Android 分享頁面主要用於將內容傳送至應用程式以外的使用者,以及/或是直接傳送給其他使用者。例如,與好友分享網址。
- Android 意圖解析器最適合將資料傳遞至明確定義工作階段。例如從應用程式開啟 PDF,並讓使用者 挑選偏好的觀眾
建構意圖時,您會指定意圖要執行的動作。Android 採用「ACTION_SEND
」動作
在活動之間傳送資料
甚至可以跨越處理程序邊界您必須指定
以及資料類型系統會自動找出相容的活動
以便接收資料並向使用者顯示在意圖解析器的情況下,如果只有一個活動可以處理意圖,該活動會立即啟動。
為什麼要使用 Android Sharesheet

我們強烈建議您使用 Android Sharesheet,以維持使用者的一致性 應用程式。請勿顯示應用程式本身的分享目標清單,或自行建立分享列變化版本。
Android 分享頁面可讓使用者輕鬆與適當對象分享資訊,並提供相關應用程式建議。Sharesheet 可以建議自訂解決方案無法使用的目標,並使用一致的排名。這是因為 Sharesheet 可將應用程式和使用者活動的相關資訊納入考量 提供給系統使用
Android 分享列表也提供許多實用的開發人員功能。舉例來說: :
使用 Android Sharesheet
針對所有類型的分享,請建立意圖並將其動作設為 Intent.ACTION_SEND
。如要顯示 Android Sharesheet,請呼叫
Intent.createChooser()
,
並傳送 Intent
物件給該函式。
它會傳回意圖的版本,該版本一律會顯示 Android 分享列。
傳送文字內容
Android Sharesheet 是最簡單也最直觀的方法,就是從以下位置傳送文字內容: 在不同活動之間進行負載平衡舉例來說,大多數瀏覽器都能將目前顯示的網頁網址以文字形式與其他應用程式分享。這項功能可讓您透過電子郵件或社群網站,與朋友分享文章或網站。範例如下:
val sendIntent: Intent = Intent().apply { action = Intent.ACTION_SEND putExtra(Intent.EXTRA_TEXT, "This is my text to send.") type = "text/plain" } val shareIntent = Intent.createChooser(sendIntent, null) startActivity(shareIntent)
Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send."); sendIntent.setType("text/plain"); Intent shareIntent = Intent.createChooser(sendIntent, null); startActivity(shareIntent);
您也可以選擇新增其他資訊,加入更多資訊,例如電子郵件收件者
(EXTRA_EMAIL
、
EXTRA_CC
,
EXTRA_BCC
)、
電子郵件主旨
(EXTRA_SUBJECT
) 等
注意:部分電子郵件應用程式 (例如 Gmail) 會在 EXTRA_EMAIL
和 EXTRA_CC
等額外項目中使用 String[]
。使用
putExtra(String, String[])
加入意圖中
傳送二進位內容
使用 ACTION_SEND
動作共用二進位資料。
設定適當的 MIME 類型,並在額外資料中放置資料的 URI
EXTRA_STREAM
,如
如以下範例所示
常用於共用圖片,但也可用於分享任何類型的二進位內容。
val shareIntent: Intent = Intent().apply { action = Intent.ACTION_SEND // Example: content://com.google.android.apps.photos.contentprovider/... putExtra(Intent.EXTRA_STREAM, uriToImage) type = "image/jpeg" } startActivity(Intent.createChooser(shareIntent, null))
Intent shareIntent = new Intent(); shareIntent.setAction(Intent.ACTION_SEND); // Example: content://com.google.android.apps.photos.contentprovider/... shareIntent.putExtra(Intent.EXTRA_STREAM, uriToImage); shareIntent.setType("image/jpeg"); startActivity(Intent.createChooser(shareIntent, null));
接收應用程式需要具備存取 Uri
所指向資料的權限。建議您採用下列兩種做法:
- 將資料儲存在自己的
ContentProvider
中,確保其他 應用程式具備適當權限,才能存取你的供應商。提供存取權的首選機制是使用個別 URI 權限,這類權限是暫時性的,且只會授予接收應用程式的存取權。如要建立這類ContentProvider
,最簡單的方法是使用FileProvider
輔助類別。 - 使用系統
MediaStore
。MediaStore
主要用於影片、音訊和圖片 MIME 類型。不過,從 Android 3.0 (API 級別 11) 開始,它也可以儲存非媒體類型。若需更多資訊,請參閲MediaStore.Files
。 您可以使用以下程式碼將檔案插入MediaStore
scanFile()
, 之後content://
風格Uri
適合用於共用的內容會傳遞至提供的onScanCompleted()
回呼。請注意,一旦將內容新增至系統MediaStore
後,內容即可供 裝置上的任何應用程式。
使用正確的 MIME 類型
根據您的資料提供最具體的 MIME 類型
傳送。舉例來說,分享純文字時使用 text/plain
。以下是 Android 中傳送簡單資料時常見的 MIME 類型:
接收器註冊時間 | 寄件者傳送 |
---|---|
text/* |
|
`image/*` |
|
video/* |
|
支援的副檔名 | application/pdf |
如要進一步瞭解 MIME 類型,請參閱 IANA 官方的 MIME 媒體類型註冊資料庫。
視提供的 MIME 類型而定,Android 分享列可能會顯示內容預覽畫面。部分預覽功能僅適用於特定類型。
分享多項內容
如要分享多個內容,請使用 ACTION_SEND_MULTIPLE
動作,並搭配指向內容的 URI 清單。MIME 類型會因分享的內容組合而異。舉例來說,如要分享三張 JPEG 圖片,請使用輸入
"image/jpg"
。如果是混合圖片類型,請使用 "image/*"
比對處理任何圖片類型的活動。雖然可以分享混合類型的內容,但我們強烈不建議這麼做,因為接收者可能不清楚要傳送的內容。如果需要傳送多種類型,請使用 "*/*"
。接收應用程式會負責剖析及處理您的資料。範例如下:
val imageUris: ArrayList<Uri> = arrayListOf( // Add your image URIs here imageUri1, imageUri2 ) val shareIntent = Intent().apply { action = Intent.ACTION_SEND_MULTIPLE putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris) type = "image/*" } startActivity(Intent.createChooser(shareIntent, null))
ArrayList<Uri> imageUris = new ArrayList<Uri>(); imageUris.add(imageUri1); // Add your image URIs here imageUris.add(imageUri2); Intent shareIntent = new Intent(); shareIntent.setAction(Intent.ACTION_SEND_MULTIPLE); shareIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris); shareIntent.setType("image/*"); startActivity(Intent.createChooser(shareIntent, null));
請確認提供的 Uri
物件會指向接收應用程式可存取的資料。
在文字預覽中加入 RTF 格式內容
自 Android 10 (API 級別 29) 起,Android 分享頁面會顯示要分享的文字預覽畫面。在某些情況下,分享的文字可能難以理解。建議您與其他人分享
複雜的網址,例如 https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4
。內容更豐富
預覽功能可以讓使用者安心知道自己分享的內容。
如果您正在預覽文字,您可以設定標題和/或縮圖圖片。在呼叫 Intent.createChooser()
之前,請先在 Intent.EXTRA_TITLE
中新增說明,然後使用 ClipData
新增相關縮圖。
注意:圖片內容 URI 是由 FileProvider
提供,通常是來自已設定的 <cache-path>
。詳情請參閱「共用檔案」。請務必為
Sharesheet 具備適當的權限,可以讀取任何你想做為縮圖的圖片。詳情請參閱 Intent.FLAG_GRANT_READ_URI_PERMISSION
。
範例如下:
val share = Intent.createChooser(Intent().apply { action = Intent.ACTION_SEND putExtra(Intent.EXTRA_TEXT, "https://developer.android.com/training/sharing/") // (Optional) Here you're setting the title of the content putExtra(Intent.EXTRA_TITLE, "Introducing content previews") // (Optional) Here you're passing a content URI to an image to be displayed data = contentUri flags = Intent.FLAG_GRANT_READ_URI_PERMISSION }, null) startActivity(share)
Intent sendIntent = new Intent(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, "https://developer.android.com/training/sharing/"); // (Optional) Here you're setting the title of the content sendIntent.putExtra(Intent.EXTRA_TITLE, "Introducing content previews"); // (Optional) Here you're passing a content URI to an image to be displayed sendIntent.setData(contentUri); sendIntent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); // Show the Sharesheet startActivity(Intent.createChooser(sendIntent, null));
以下是預覽畫面:

在 Sharesheet 中新增自訂動作

Android Sharesheet 中的自訂動作螢幕截圖。
在 Android 14 (API 級別 34) 以上版本中,應用程式可將自訂動作新增至 Android Sharesheet。自訂動作會顯示為 Android 分享列頂端的小型動作圖示,應用程式可以指定任何 Intent
,做為點選圖示時叫用的動作。
如要在 Android Sharesheet 中新增自訂動作,請先建立一個
ChooserAction
同時
ChooserAction.Builder
。
您可以指定 PendingIntent
,做為點選圖示時叫用的動作。建立包含所有自訂動作的陣列,並將其指定為分享 Intent
的 EXTRA_CHOOSER_CUSTOM_ACTIONS
。
val sendIntent = Intent(Intent.ACTION_SEND) .setType("text/plain") .putExtra(Intent.EXTRA_TEXT, text) val shareIntent = Intent.createChooser(sendIntent, null) val customActions = arrayOf( ChooserAction.Builder( Icon.createWithResource(context, R.drawable.ic_custom_action), "Custom", PendingIntent.getBroadcast( context, 1, Intent(Intent.ACTION_VIEW), PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_CANCEL_CURRENT ) ).build() ) shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, customActions) context.startActivity(shareIntent)
Intent sendIntent = new Intent(Intent.ACTION_SEND) .setType("text.plain") .putExtra(Intent.EXTRA_TEXT, text); Intent shareIntent = Intent.createChooser(sendIntent, null); ChooserAction[] actions = new ChooserAction[]{ new ChooserAction.Builder( Icon.createWithResource(context, R.drawable.ic_custom_action), "Custom", PendingIntent.getBroadcast( context, 1, new Intent(Intent.ACTION_VIEW), PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT ) ).build() }; shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, actions); context.startActivity(shareIntent);
新增自訂目標
Android 分享頁面可讓您指定最多兩個 ChooserTarget
物件,這些物件會在從 ChooserTargetServices
載入的分享捷徑和選擇器目標前顯示。你也可以
指定最多兩個意圖指向列出的活動的意圖
並在應用程式建議之前:

在呼叫 Intent.createChooser()
後,將 Intent.EXTRA_CHOOSER_TARGETS
和 Intent.EXTRA_INITIAL_INTENTS
新增至分享意圖:
val share = Intent.createChooser(myShareIntent, null).apply { putExtra(Intent.EXTRA_CHOOSER_TARGETS, myChooserTargetArray) putExtra(Intent.EXTRA_INITIAL_INTENTS, myInitialIntentArray) }
Intent shareIntent = Intent.createChooser(sendIntent, null); share.putExtra(Intent.EXTRA_CHOOSER_TARGETS, myChooserTargetArray); share.putExtra(Intent.EXTRA_INITIAL_INTENTS, myInitialIntentArray);
請謹慎使用這項功能。所有自訂Intent
而新增 ChooserTarget
則會減少系統建議的數字。一般而言
我們不建議加入自訂指定目標常見的例子是
Intent.EXTRA_INITIAL_INTENTS
是讓使用者能對共用項目執行額外動作
內容。舉例來說,使用者分享圖片時,可以使用 Intent.EXTRA_INITIAL_INTENTS
傳送連結。新增 Intent.EXTRA_CHOOSER_TARGETS
的常見範例
鎖定與您應用程式相關的使用者或裝置。
依元件排除特定目標
您可以提供 Intent.EXTRA_EXCLUDE_COMPONENTS
來排除特定目標。只用來移除您掌控的目標。常見的用途是
使用者在應用程式中分享資訊的時候,就會分享應用程式的共用目標,因為他們的意圖可能是
應用程式以外的功能
呼叫 Intent.createChooser()
後,請將 Intent.EXTRA_EXCLUDE_COMPONENTS
新增至意圖:
val share = Intent.createChooser(Intent(), null).apply { // Only use for components you have control over val excludedComponentNames = arrayOf(ComponentName("com.example.android", "ExampleClass")) putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames) }
Intent shareIntent = Intent.createChooser(new Intent(), null); // Only use for components you have control over ComponentName[] excludedComponentNames = { new ComponentName("com.example.android", "ExampleClass") }; shareIntent.putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames);
取得共用資訊
有助您瞭解使用者何時分享內容,以及他們選擇的目標。
Android Sharesheet 可讓您的 ComponentName
取得這項資訊
指定使用者透過IntentSender
選取的選項
首先為 BroadcastReceiver
建立 PendingIntent
,並在 Intent.createChooser()
中提供其 IntentSender
:
var share = Intent(Intent.ACTION_SEND) // ... val pi = PendingIntent.getBroadcast( myContext, requestCode, Intent(myContext, MyBroadcastReceiver::class.java), PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT ) share = Intent.createChooser(share, null, pi.intentSender)
Intent share = new Intent(ACTION_SEND); ... PendingIntent pi = PendingIntent.getBroadcast(myContext, requestCode, new Intent(myContext, MyBroadcastReceiver.class), PendingIntent.FLAG_MUTABLE | PendingIntent.FLAG_UPDATE_CURRENT); share = Intent.createChooser(share, null, pi.getIntentSender());
在 MyBroadcastReceiver
中接收回呼,並查看 Intent.EXTRA_CHOSEN_COMPONENT
:
override fun onReceive(context: Context, intent: Intent) { ... val clickedComponent : ComponentName = intent.getParcelableExtra(EXTRA_CHOSEN_COMPONENT); }
@Override public void onReceive(Context context, Intent intent) { ... ComponentName clickedComponent = intent.getParcelableExtra(EXTRA_CHOSEN_COMPONENT); }
在 Sharesheet 中新增自訂動作
在 Android 14 (API 級別 34) 以上版本中,應用程式可將自訂動作新增至 Android Sharesheet。建立 ChooserAction
同時
ChooserAction.Builder
。
您可以指定 PendingIntent
做為點選圖示時所叫用的動作。創作
包含所有自訂動作的陣列,並將其指定為
EXTRA_CHOOSER_CUSTOM_ACTIONS
股份清單 Intent
val sendIntent = Intent(Intent.ACTION_SEND) .setType("text/plain") .putExtra(Intent.EXTRA_TEXT, text) val shareIntent = Intent.createChooser(sendIntent, null) val customActions = arrayOf( ChooserAction.Builder( Icon.createWithResource(context, R.drawable.ic_custom_action), "Custom", PendingIntent.getBroadcast( context, 1, Intent(Intent.ACTION_VIEW), PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_CANCEL_CURRENT ) ).build() ) shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, customActions) context.startActivity(shareIntent)
Intent sendIntent = new Intent(Intent.ACTION_SEND) .setType("text.plain") .putExtra(Intent.EXTRA_TEXT, text); Intent shareIntent = Intent.createChooser(sendIntent, null); ChooserAction[] actions = new ChooserAction[]{ new ChooserAction.Builder( Icon.createWithResource(context, R.drawable.ic_custom_action), "Custom", PendingIntent.getBroadcast( context, 1, new Intent(Intent.ACTION_VIEW), PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT ) ).build() }; shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, actions); context.startActivity(shareIntent);
使用 Android 意圖解析器

ACTION_SEND
意圖解析器的螢幕截圖。
Android 意圖解析器在定義工作流程中,將資料傳送至其他應用程式時,最適合使用 Android 意圖解析器。
如要使用 Android 意圖解析器,請建立意圖並新增額外項目,就像呼叫 Android Sharesheet 一樣。但「不要」呼叫
Intent.createChooser()
。
如已安裝多個符合篩選條件的應用程式
ACTION_SEND
與 MIME 類型,系統會顯示名為「意圖解析器」的消歧對話方塊
讓使用者選擇要共用的目標。單一應用程式
就會執行
以下範例說明如何使用 Android 意圖解析器傳送文字:
val sendIntent: Intent = Intent().apply { action = Intent.ACTION_SEND putExtra(Intent.EXTRA_TEXT, "This is my text to send.") type = "text/plain" } startActivity(sendIntent)
Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send."); sendIntent.setType("text/plain"); startActivity(sendIntent);
瞭解詳情
如要進一步瞭解如何傳送資料,請參閱「意圖和意圖篩選器」。