本文共 2121 字,大约阅读时间需要 7 分钟。
Implementing an effective and user friendly share action in your is made even easier with the introduction of
in Android 4.0 (API Level 14). An
, once attached to a menu item in the action bar, handles both the appearance and behavior of that item. In the case of , you provide a share intent and it does the rest.
Note: is available starting with API Level 14 and higher.
To get started with , define the
android:actionProviderClass
attribute for the corresponding <item>
in your file:
This delegates responsibility for the item's appearance and function to
. However, you will need to tell the provider what you would like to share.
In order for to function, you must provide it a share intent. This share intent should be the same as described in the lesson, with action
and additional data set via extras like
and
. To assign a share intent, first find the corresponding
while inflating your menu resource in your
or . Next, call
to retreive an instance of
. Use
to update the share intent associated with that action item. Here's an example:
private ShareActionProvider mShareActionProvider;...@Overridepublic boolean onCreateOptionsMenu(Menu menu) { // Inflate menu resource file. getMenuInflater().inflate(R.menu.share_menu, menu); // Locate MenuItem with ShareActionProvider MenuItem item = menu.findItem(R.id.menu_item_share); // Fetch and store ShareActionProvider mShareActionProvider = (ShareActionProvider) item.getActionProvider(); // Return true to display menu return true;}// Call to update the share intentprivate void setShareIntent(Intent shareIntent) { if (mShareActionProvider != null) { mShareActionProvider.setShareIntent(shareIntent); }}
You may only need to set the share intent once during the creation of your menus, or you may want to set it and then update it as the UI changes. For example, when you view photos full screen in the Gallery app, the sharing intent changes as you flip between photos.
For further discussion about the object, see the guide.