fr.tvbarthel.intentshare

Class IntentShare

java.lang.Object

fr.tvbarthel.intentshare.IntentShare

All Implemented Interfaces:

android.os.Parcelable

public final class IntentShare
extends java.lang.Object
implements android.os.Parcelable

IntentShare is designed to enhance the sharing experience by allowing to share different content according to the application the user will choose to share with.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IntentShare.ExtraProvider Used to provide specific extras for a given package name

Nested classes/interfaces inherited from interface android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

Field Summary

Fields

Modifier and Type	Field and Description
static android.os.Parcelable.Creator<IntentShare>	CREATOR Parcelable.
static java.lang.String	FACEBOOK Facebook package.
static java.lang.String	TWITTER Twitter package.

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IntentShare(android.os.Parcel in) IntentShare is designed to enhance the sharing experience by allowing to share different content according to the application the user will choose to share with.

Method Summary

Modifier and Type	Method and Description
IntentShare	addExtraProvider(IntentShare.ExtraProvider extraProvider) Allow to add a specific intent for a given
IntentShare	chooserTitle(java.lang.String title) Title that will be displayed in the chooser.
IntentShare	comparatorProvider(TargetActivityComparatorProvider comparatorProvider) Provide a custom Comparator in order to sort the TargetActivity displayed to the user.
void	deliver() Deliver the intent to the system.
int	describeContents()
IntentShare	facebookBody(android.net.Uri link) Link which will be used as single shared content if target application is the facebook since facebook app don't handle Intent.EXTRA_TEXT Override text(String) for the Facebook application.
IntentShare	iconLoader(IconLoader iconLoader) Set the IconLoader used to load target activities icon.
IntentShare	image(android.net.Uri imageUri) Image which will be set as Intent.EXTRA_STREAM if the target application can handle it.
IntentShare	listener(IntentShareListener listener) Allow to set a listener to be notified on chosen target activity.
IntentShare	mailBody(java.lang.String mailBody) Text which will be shared by any application marked as mail client (application which can handle "message/rfc822").
IntentShare	mailSubject(java.lang.String mailSubject) Text which will be displayed inside the subject field of any application marked as mail client (applcation which can handle "message/rfc822").
IntentShare	text(java.lang.String text) Text which will be shared.
IntentShare	twitterBody(java.lang.String tweet) Text which will be used as tweet body if target application is the Twitter one.
static IntentShare	with(android.content.Context context) IntentShare is designed to enhance the sharing experience by allowing to share different content according to the application the user will choose to share with.
void	writeToParcel(android.os.Parcel dest, int flags)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CREATOR

public static final android.os.Parcelable.Creator<IntentShare> CREATOR

Parcelable.

FACEBOOK

public static final java.lang.String FACEBOOK

Facebook package.

See Also:

Constant Field Values

TWITTER

public static final java.lang.String TWITTER

Twitter package.

See Also:

Constant Field Values

Constructor Detail

IntentShare

protected IntentShare(android.os.Parcel in)

IntentShare is designed to enhance the sharing experience by allowing to share different content according to the application the user will choose to share with.

Parameters:

in - parcel.

Method Detail

describeContents

public int describeContents()

Specified by:

describeContents in interface android.os.Parcelable

writeToParcel

public void writeToParcel(android.os.Parcel dest,
                          int flags)

Specified by:

writeToParcel in interface android.os.Parcelable

with

public static IntentShare with(android.content.Context context)

IntentShare is designed to enhance the sharing experience by allowing to share different content according to the application the user will choose to share with.

Parameters:

context - context from which the sharing is initiated.

Returns:

new instance.

chooserTitle

public IntentShare chooserTitle(java.lang.String title)

Title that will be displayed in the chooser.

Will be displayed on a single line.

Parameters:

title - title that will be displayed in the chooser.

Returns:

current IntentShare for method chaining.

iconLoader

public IntentShare iconLoader(IconLoader iconLoader)

Set the IconLoader used to load target activities icon.

Parameters:

iconLoader - icon loader.

Returns:

current IntentShare for method chaining.

comparatorProvider

public IntentShare comparatorProvider(TargetActivityComparatorProvider comparatorProvider)

Provide a custom Comparator in order to sort the TargetActivity displayed to the user.

By default, TargetActivities are sorted by the recentness of their selection. If it's the behaviour that you are looking for, don't use this method and let the default comparator bring the magic.

Parameters:

comparatorProvider - comparator used to sort the TargetActivities displayed to the user. Will override the default sorting by recentness.

Returns:

current IntentShare for method chaining.

text

public IntentShare text(java.lang.String text)

Text which will be shared.

Will be used as Intent.EXTRA_TEXT

Parameters:

text - text to share.

Returns:

current IntentShare for method chaining.

image

public IntentShare image(android.net.Uri imageUri)

Image which will be set as Intent.EXTRA_STREAM if the target application can handle it.

Parameters:

imageUri - Uri of the image.

Returns:

current IntentShare for method chaining.

mailBody

public IntentShare mailBody(java.lang.String mailBody)

Text which will be shared by any application marked as mail client (application which can handle "message/rfc822").

Override text(String) for every mail application.

Parameters:

mailBody - text set as text body for mail application.

Returns:

current IntentShare for method chaining.

mailSubject

public IntentShare mailSubject(java.lang.String mailSubject)

Text which will be displayed inside the subject field of any application marked as mail client (applcation which can handle "message/rfc822").

See also : mailBody(String)

Parameters:

mailSubject - subject of the mail.

Returns:

current IntentShare for method chaining.

facebookBody

public IntentShare facebookBody(android.net.Uri link)

Link which will be used as single shared content if target application is the facebook since facebook app don't handle Intent.EXTRA_TEXT

Override text(String) for the Facebook application.

Parameters:

link - link to the content.

Returns:

current IntentShare for method chaining.

twitterBody

public IntentShare twitterBody(java.lang.String tweet)

Text which will be used as tweet body if target application is the Twitter one.

Override text(String) for the Twitter application.

Note that length compliancy (140 char) isn't handle by the library anymore since tweet lenght can't be easily deduced from the text length directly.

Please refer to the following link if you want to ensure the length check on your side: https://blog.twitter.com/2016/doing-more-with-140-characters

Parameters:

tweet - tweet body.

Returns:

current IntentShare for method chaining.

listener

public IntentShare listener(IntentShareListener listener)

Allow to set a listener to be notified on chosen target activity.

Listener will be automatically unregister once a result is delivered.

Parameters:

listener - listener to register.

Returns:

current IntentShare for method chaining.

addExtraProvider

public IntentShare addExtraProvider(IntentShare.ExtraProvider extraProvider)

Allow to add a specific intent for a given

Parameters:

extraProvider - extra provider for a given package;

Returns:

current IntentShare for method chaining.

deliver

public void deliver()

Deliver the intent to the system.

This will lead to the display of every applications that can handle the build intent. Target activity field will be then filled according to the params.