README.md

FilteredIntent

Overview

This library helps to select apps when you want to share text or file to other apps.

Features

• You can add filters to select apps.
• A filter is app name and package name.
• You can show choosing dialog more easy.

Gradle & Maven

Gradle

    dependencies {
    	implementation 'net.sjava:filteredintent:1.3.0'
    }

Maven

    <dependency>
     <groupId>net.sjava</groupId>
     <artifactId>filteredintent</artifactId>
     <version>1.3.0</version>
    </dependency>

Ivy

<dependency org='net.sjava' name='filteredintent' rev='1.3.0'>
    <artifact name='$AID' ext='pom'></artifact> 
</dependency>

##Screenshots

  

Usage

Example 1

• Show sns apps for sharing "text/plain" contents.

    Intent shareIntent = new Intent();
    shareIntent.setAction(Intent.ACTION_SEND);
    shareIntent.putExtra(Intent.EXTRA_SUBJECT, "share intent subject");
    shareIntent.putExtra(Intent.EXTRA_TEXT, "share intent value");
    shareIntent.setType("text/plain");

    // for testing 
    //String[] filters = new String[]{"1222222222222222222222"};

    // real 
    String[] filters = new String[]{"twitter", "facebook", "kakao.talk", "com.facebook.orca", "com.tencent.mm"};

    FilteredIntent filteredIntent = FilteredIntent.newInstance(MainActivity.this, shareIntent);
    filteredIntent.startIntent("Share sns", filters);

Example 2

• Show only cloud apps for sharing image file.

    Intent shareIntent = new Intent();
    shareIntent.setAction(Intent.ACTION_SEND);
    shareIntent.setType("image/*");
    // You have to add image file to shareIntent
    
    String[] filters = new String[]{"dropbox", "com.microsoft.skydrive", "com.google.android.apps.docs", "com.box.android", "com.amazon.drive"};
    FilteredIntent filteredIntent = FilteredIntent.newInstance(MainActivity.this, shareIntent);
    filteredIntent.startIntent("Share file to clouds", filters);

Example 3

• Show apps without gmail, twitter, facebook, kakao, facebook, and tencent apps.

    Intent shareIntent = new Intent();
    shareIntent.setAction(Intent.ACTION_SEND);
    shareIntent.putExtra(Intent.EXTRA_SUBJECT, "share intent subject");
    shareIntent.putExtra(Intent.EXTRA_TEXT, "share intent value");
    shareIntent.setType("text/plain");
    
    // real
    String[] withoutFilters = new String[]{"gmail", "twitter", "facebook", "kakao.talk", "com.facebook.orca", "com.tencent.mm"};
    
    FilteredIntent filteredIntent = FilteredIntent.newInstance(MainActivity.this, shareIntent);
    filteredIntent.startIntentWithout("Share sns", withoutFilters);

Example 4

• How to get chosen app name.

       if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP_MR1) {
            filteredIntent.startIntent(new AppChosenListener() {
                @Override
                public void chosen(String appName) {
                    Toast.makeText(MainActivity.this, appName, Toast.LENGTH_LONG).show();
                }
            }, "Share file to clouds", filters);
        }

License

Copyright 2020 Justin Song

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. See the License for the specific language governing permissions and limitations under the License.