Yeti - Control what you share

Do you want to customize what you share, depending on what the user wants to share it with?

Let's say you want to add a "via @theTwitterAccountOfYourProduct" if the content is being shared with a Twitter client.

###BOOM! That's what Yeti does.

Add to your project

Gradle (jcenter)

compile 'me.kentin:yeti:1.1.0'

Maven

Who uses that? Seriously.

Or you can clone it and import yeti as a module.

Usage

Two options. Because there are 2 ways to share on Android.

• using a shareActionProvider (the menu thing)
• using a normal intent, with ACTION_SEND.

For both you're going to need an Intent anyway.

shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND);
shareIntent.setType("text/plain");
shareIntent.putExtra(Intent.EXTRA_TEXT, "This is the text BEFORE you change it bro. (if you want huh)");

ShareActionProvider

Add the action provider to your menu xml.

<item
  android:id="@+id/menu_item_share"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  app:showAsAction="ifRoom"
  android:title="Share"
  app:actionProviderClass="me.kentin.yeti.YetiActionProvider" />

And set the intent in your activity:

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // Inflate the menu; this adds items to the action bar/toolbar if it is present.
    getMenuInflater().inflate(R.menu.menu_actionprovideractivity, menu);

    // Locate MenuItem with YetiActionProvider
    MenuItem item = menu.findItem(R.id.menu_item_share);

    // Fetch and store ShareActionProvider
    yetiActionProvider = (YetiActionProvider) MenuItemCompat.getActionProvider(item);

    // You don't have to Override everything though, just what you want
    yetiActionProvider.setOnShareListener(shareListener);
    yetiActionProvider.setShareIntent(shareIntent);

    return true;
}

Normal way

Create the Yeti intent and then, startActivityForResult with it.

Yeti yeti = Yeti.with(activity);
Intent intent = yeti.share(yourShareIntent)
startActivityForResult(yeti.share(shareIntent), REQUEST_CODE_YETI);

Override onActivityResult and use THE SAME INSTANCE OF YETI with the data.

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode == RESULT_OK && requestCode == REQUEST_CODE_YETI) {
        yeti.result(data, shareListener);
    }
}

shareListener here is just a OnShareListener.

Todo

• "I want to share with Twitter, and Facebook only. Filter the apps pretty please." ---> Done in 1.1.0
• Want something? Tell me. :)

Contributors

• geralt-encore

License

Yeti is licensed under the Apache 2 license (you can use it in commercial and open source projects).

Copyright 2015 Quentin Dommerc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Anyway no one read this, so why would I care having meaningful License.
See the License for the specific language governing permissions and
limitations under the License.