> 編寫:[kesenhoo](https://github.com/kesenhoo) - 原文:[http://developer.android.com/training/sharing/send.html](http://developer.android.com/training/sharing/send.html)
當你構建一個intent,你必須指定這個intent需要觸發的actions。Android定義了一些actions,包括ACTION_SEND,這個action表明著這個intent是用來從一個[activity](# "An activity represents a single screen with a user interface.")發送數據到另外一個[activity](# "An activity represents a single screen with a user interface.")的,甚至是跨進程之間的。
為了發送數據到另外一個[activity](# "An activity represents a single screen with a user interface."),你需要做的是指定數據與數據的類型,系統會識別出能夠兼容接受的這些數據的[activity](# "An activity represents a single screen with a user interface.")。如果這些選擇有多個,則把這些[activity](# "An activity represents a single screen with a user interface.")顯示給用戶進行選擇;如果只有一個兼容選擇,則立即啟動該[Activity](# "An activity represents a single screen with a user interface.")。同樣的,你可以在manifest文件的[Activity](# "An activity represents a single screen with a user interface.")描述中添加接受的數據類型。
在不同的程序之間使用intent來發送與接受數據是在社交分享內容的時候最常用的方法。Intent使得用戶用最常用的程序進行快速簡單的分享信息。
**注意:**為ActionBar添加分享功能的最好方法是使用[ShareActionProvider](https://developer.android.com/reference/android/widget/ShareActionProvider.html),它能夠在API level 14以上進行使用。ShareActionProvider會在第3課中進行詳細介紹。
### 分享文本內容(Send Text Content)
ACTION_SEND最直接與最常用的地方是從一個[Activity](# "An activity represents a single screen with a user interface.")發送文本內容到另外一個[Activity](# "An activity represents a single screen with a user interface.")。例如,Android內置的瀏覽器可以把當前顯示頁面的URL作為文本內容分享到其他程序。這是非常有用的,通過郵件或者社交網絡來分享文章或者網址給好友。下面是一段Sample Code:
~~~
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);
~~~
如果設備上有安裝某個能夠匹配ACTION_SEND與MIME類型為text/plain程序,那么Android系統會自動把他們都給篩選出來,并呈現Dialog給用戶進行選擇。如果你為intent調用了Intent.createChooser(),那么Android總是會顯示可供選擇。這樣有一些好處:
- 即使用戶之前為這個intent設置了默認的action,選擇界面還是會被顯示。
- 如果沒有匹配的程序,Android會顯示系統信息。
- 你可以指定選擇界面的標題。
下面是更新后的代碼:
~~~
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(Intent.createChooser(sendIntent, getResources().getText(R.string.send_to));
~~~
效果圖如下:

Optionally,你可以為intent設置一些標準的附加值,例如:EXTRA_EMAIL, EXTRA_CC, EXTRA_BCC, EXTRA_SUBJECT.然而,如果接收程序沒有針對那些做特殊的處理,則不會有對應的反應。
**注意:**一些e-mail程序,例如Gmail,對應接收的是EXTRA_EMAIL與EXTRA_CC,他們都是String類型的,可以使用putExtra(string,string[])方法來添加到intent里面。
### 分享二進制內容(Send Binary Content)
分享二進制的數據需要結合設置特定的MIME類型`,需要在`EXTRA_STREAM`里面放置數據的URI,下面有個分享圖片的例子,這個例子也可以修改用來分享任何類型的二進制數據:
~~~
Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND);
shareIntent.putExtra(Intent.EXTRA_STREAM, uriToImage);
shareIntent.setType("image/jpeg");
startActivity(Intent.createChooser(shareIntent, getResources().getText(R.string.send_to)));
~~~
**請注意下面的內容:**
- 你可以使用`*/*`這樣的方式來指定MIME類型,但是這僅僅會match到那些能夠處理一般數據類型的[Activity](# "An activity represents a single screen with a user interface.")(即一般的[Activity](# "An activity represents a single screen with a user interface.")無法詳盡所有的MIME類型)
- 接收的程序需要有訪問URI資源的權限。下面有一些方法來處理這個問題:
- 將數據存儲在你的ContentProvider中,確保其他程序有訪問你的provider的權限。較好的提供訪問權限的方法是使用 per-URI permissions,其對接收程序而言是只是暫時擁有該許可權限。類似于這樣創建ContentProvider的一種簡單的方法是使用FileProvider helper類。
- 使用MediaStore系統。MediaStore系統主要用于音視頻及圖片的MIME類型。但在Android3.0之后,其也可以用于存儲非多媒體類型。
### 發送多塊內容(Send Multiple Pieces of Content)
為了同時分享多種不同類型的內容,需要使用`ACTION_SEND_MULTIPLE`與指定到那些數據的URIs列表。MIME類型會根據你分享的混合內容而不同。例如,如果你分享3張JPEG的圖片,那么MIME類型仍然是`image/jpeg`。如果是不同圖片格式的話,應該是用`image/*`來匹配那些可以接收任何圖片類型的[activity](# "An activity represents a single screen with a user interface.")。如果你需要分享多種不同類型的數據,可以使用`*/*`來表示MIME。像前面描述的那樣,這取決于那些接收的程序解析并處理你的數據。下面是一個例子:
~~~
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, "Share images to.."));
~~~
當然,請確保指定到數據的URIs能夠被接收程序所訪問(添加訪問權限)。
- 序言
- Android入門基礎:從這里開始
- 建立第一個App
- 創建Android項目
- 執行Android程序
- 建立簡單的用戶界面
- 啟動其他的Activity
- 添加ActionBar
- 建立ActionBar
- 添加Action按鈕
- 自定義ActionBar的風格
- ActionBar的覆蓋層疊
- 兼容不同的設備
- 適配不同的語言
- 適配不同的屏幕
- 適配不同的系統版本
- 管理Activity的生命周期
- 啟動與銷毀Activity
- 暫停與恢復Activity
- 停止與重啟Activity
- 重新創建Activity
- 使用Fragment建立動態的UI
- 創建一個Fragment
- 建立靈活動態的UI
- Fragments之間的交互
- 數據保存
- 保存到Preference
- 保存到文件
- 保存到數據庫
- 與其他應用的交互
- Intent的發送
- 接收Activity返回的結果
- Intent過濾
- Android分享操作
- 分享簡單的數據
- 給其他App發送簡單的數據
- 接收從其他App返回的數據
- 給ActionBar增加分享功能
- 分享文件
- 建立文件分享
- 分享文件
- 請求分享一個文件
- 獲取文件信息
- 使用NFC分享文件
- 發送文件給其他設備
- 接收其他設備的文件
- Android多媒體
- 管理音頻播放
- 控制音量與音頻播放
- 管理音頻焦點
- 兼容音頻輸出設備
- 拍照
- 簡單的拍照
- 簡單的錄像
- 控制相機硬件
- 打印
- 打印照片
- 打印HTML文檔
- 打印自定義文檔
- Android圖像與動畫
- 高效顯示Bitmap
- 高效加載大圖
- 非UI線程處理Bitmap
- 緩存Bitmap
- 管理Bitmap的內存
- 在UI上顯示Bitmap
- 使用OpenGL ES顯示圖像
- 建立OpenGL ES的環境
- 定義Shapes
- 繪制Shapes
- 運用投影與相機視圖
- 添加移動
- 響應觸摸事件
- 添加動畫
- View間漸變
- 使用ViewPager實現屏幕側滑
- 展示卡片翻轉動畫
- 縮放View
- 布局變更動畫
- Android網絡連接與云服務
- 無線連接設備
- 使得網絡服務可發現
- 使用WiFi建立P2P連接
- 使用WiFi P2P服務
- 執行網絡操作
- 連接到網絡
- 管理網絡
- 解析XML數據
- 高效下載
- 為網絡訪問更加高效而優化下載
- 最小化更新操作的影響
- 避免下載多余的數據
- 根據網絡類型改變下載模式
- 云同步
- 使用備份API
- 使用Google Cloud Messaging
- 解決云同步的保存沖突
- 使用Sync Adapter傳輸數據
- 創建Stub授權器
- 創建Stub Content Provider
- 創建Sync Adpater
- 執行Sync Adpater
- 使用Volley執行網絡數據傳輸
- 發送簡單的網絡請求
- 建立請求隊列
- 創建標準的網絡請求
- 實現自定義的網絡請求
- Android聯系人與位置信息
- Android聯系人信息
- 獲取聯系人列表
- 獲取聯系人詳情
- 使用Intents修改聯系人信息
- 顯示聯系人頭像
- Android位置信息
- 獲取最后可知位置
- 獲取位置更新
- 顯示位置地址
- 創建和監視地理圍欄
- Android可穿戴應用
- 賦予Notification可穿戴特性
- 創建Notification
- 在Notifcation中接收語音輸入
- 為Notification添加顯示頁面
- 以Stack的方式顯示Notifications
- 創建可穿戴的應用
- 創建并運行可穿戴應用
- 創建自定義的布局
- 添加語音功能
- 打包可穿戴應用
- 通過藍牙進行調試
- 創建自定義的UI
- 定義Layouts
- 創建Cards
- 創建Lists
- 創建2D-Picker
- 創建確認界面
- 退出全屏的Activity
- 發送并同步數據
- 訪問可穿戴數據層
- 同步數據單元
- 傳輸資源
- 發送與接收消息
- 處理數據層的事件
- Android TV應用
- 創建TV應用
- 創建TV應用的第一步
- 處理TV硬件部分
- 創建TV的布局文件
- 創建TV的導航欄
- 創建TV播放應用
- 創建目錄瀏覽器
- 提供一個Card視圖
- 創建詳情頁
- 顯示正在播放卡片
- 幫助用戶在TV上探索內容
- TV上的推薦內容
- 使得TV App能夠被搜索
- 使用TV應用進行搜索
- 創建TV游戲應用
- 創建TV直播應用
- TV Apps Checklist
- Android企業級應用
- Ensuring Compatibility with Managed Profiles
- Implementing App Restrictions
- Building a Work Policy Controller
- Android交互設計
- 設計高效的導航
- 規劃屏幕界面與他們之間的關系
- 為多種大小的屏幕進行規劃
- 提供向下和橫向導航
- 提供向上和歷史導航
- 綜合:設計樣例 App
- 實現高效的導航
- 使用Tabs創建Swipe視圖
- 創建抽屜導航
- 提供向上的導航
- 提供向后的導航
- 實現向下的導航
- 通知提示用戶
- 建立Notification
- 當啟動Activity時保留導航
- 更新Notification
- 使用BigView風格
- 顯示Notification進度
- 增加搜索功能
- 建立搜索界面
- 保存并搜索數據
- 保持向下兼容
- 使得你的App內容可被Google搜索
- 為App內容開啟深度鏈接
- 為索引指定App內容
- Android界面設計
- 為多屏幕設計
- 兼容不同的屏幕大小
- 兼容不同的屏幕密度
- 實現可適應的UI
- 創建自定義View
- 創建自定義的View類
- 實現自定義View的繪制
- 使得View可交互
- 優化自定義View
- 創建向后兼容的UI
- 抽象新的APIs
- 代理至新的APIs
- 使用舊的APIs實現新API的效果
- 使用版本敏感的組件
- 實現輔助功能
- 開發輔助程序
- 開發輔助服務
- 管理系統UI
- 淡化系統Bar
- 隱藏系統Bar
- 隱藏導航Bar
- 全屏沉浸式應用
- 響應UI可見性的變化
- 創建使用Material Design的應用
- 開始使用Material Design
- 使用Material的主題
- 創建Lists與Cards
- 定義Shadows與Clipping視圖
- 使用Drawables
- 自定義動畫
- 維護兼容性
- Android用戶輸入
- 使用觸摸手勢
- 檢測常用的手勢
- 跟蹤手勢移動
- Scroll手勢動畫
- 處理多觸摸手勢
- 拖拽與縮放
- 管理ViewGroup中的觸摸事件
- 處理鍵盤輸入
- 指定輸入法類型
- 處理輸入法可見性
- 兼容鍵盤導航
- 處理按鍵動作
- 兼容游戲控制器
- 處理控制器輸入動作
- 支持不同的Android系統版本
- 支持多個控制器
- Android后臺任務
- 在IntentService中執行后臺任務
- 創建IntentService
- 發送工作任務到IntentService
- 報告后臺任務執行狀態
- 使用CursorLoader在后臺加載數據
- 使用CursorLoader執行查詢任務
- 處理查詢的結果
- 管理設備的喚醒狀態
- 保持設備的喚醒
- 制定重復定時的任務
- Android性能優化
- 管理應用的內存
- 代碼性能優化建議
- 提升Layout的性能
- 優化layout的層級
- 使用include標簽重用layouts
- 按需加載視圖
- 使得ListView滑動順暢
- 優化電池壽命
- 監測電量與充電狀態
- 判斷與監測Docking狀態
- 判斷與監測網絡連接狀態
- 根據需要操作Broadcast接受者
- 多線程操作
- 在一個線程中執行一段特定的代碼
- 為多線程創建線程池
- 啟動與停止線程池中的線程
- 與UI線程通信
- 避免出現程序無響應ANR
- JNI使用指南
- 優化多核處理器(SMP)下的Android程序
- Android安全與隱私
- Security Tips
- 使用HTTPS與SSL
- 為防止SSL漏洞而更新Security
- 使用設備管理條例增強安全性
- Android測試程序
- 測試你的Activity
- 建立測試環境
- 創建與執行測試用例
- 測試UI組件
- 創建單元測試
- 創建功能測試
- 術語表