06- اضافه کردن قابلیت اشتراک گذاری در اکشن ها برنامه

مترجم: مژگان پیرامن

آدرس: http://developer.android.com/training/sharing/shareaction.html

پیاده سازی عمل اشتراک گذاری موثر و کاربر پسند در ActionBar حتی آسان تر با معرفی ActionProvider در اندروید 4.1 ساخته شده. یک ActionProvider ، یکبار متصل شده به منوی آیتم در ActionBar ، که هردو در ظاهر و رفتار ان آیتم بکار برده شده .در مورد  ShareActionProvider، شما یک share intent وان چه باقیمانده ارائه می کنید.

 

Update menu Declaration (اپدیت منو اعلان ها)

گرفتن اغاز شده با ShareActionProviders ، android:actionProviderClass  تعریف میکند صفت مربوط به <item> در فایل منبع منو شما:

<menuxmlns:android="http://schemas.android.com/apk/res/android">
    <item
            android:id="@+id/menu_item_share"
            android:showAsAction="ifRoom"
            android:title="Share"
            android:actionProviderClass=
                "android.widget.ShareActionProvider"/>
    ...
</menu>

این نمایندگان برای ظاهر ایتم و عملکرد ShareActionProvider مسئولیت دارند. اگرچه ، شما نیاز دارید بگفتن چه چیزی می خواهید به اشتراک بزارید، ارئه دهید.

 

Set the share intent

برای تابع ShareActionProvider ،باید یک اشتراک گذاری intent  فراهم کند.این share intent باید همان توصیف درس ارسال اطلاعات ساده به Apps دیگر، با عمل ACTION_SENDو تنظیم اطلاعات اضافی از طریق extras مثل EXTRA_TEXT وEXTRA_STREAM باشد. برای تعیین share intent  اول منوی ایتم مربوطه را پیدامی کنیم تاهنگامی  که inflating منبع منو شما در فعالیت یا قطعه باشد. بعد با فراخوانی MenuItem.getActionProvider()  برای بازیابی یک نمونه از ShareActionProvider.استفاده از   setShareIntent()برای اپدیت Share intent در ارتباط با عمل ایتم. اینجا هست یک مثال :

privateShareActionProvidermShareActionProvider;
...

@Override
publicbooleanonCreateOptionsMenu(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
    returntrue;
}

// Call to update the share intent
privatevoidsetShareIntent(IntentshareIntent){
    if(mShareActionProvider!=null){
        mShareActionProvider.setShareIntent(shareIntent);
    }
}

شما ممکن است فقط نیاز به تنظیم  Share intent  یکبار درطول ایجاد منو خود کنید ، یا شما ممکن است بخواهید به تنظیم و اپدیت ان مانند تغییرات UI( رابط کاربر). برای مثال ، وقتی که شما عکس ها را بصورت تمام صفحه در Gallery App نمایش می دهید ، تغییرات Share intent بین عکسها flip میشود.