如何从 Android 小部件创建快捷方式?

How can you create Shortcuts from an Android Widget?

我正在尝试向我的应用程序添加一个新的小部件功能,它允许您从 'shortcut widget.'

创建固定的快捷方式

通常 Android 中的快捷方式创建方式如下面的视频所示。您长按应用程序,select 一个快捷方式,然后您可以将快捷方式固定到主屏幕上。我的应用目前按照 Android 开发人员指南实现了这样的快捷方式。

但是,我注意到“设置”应用允许您为您的应用创建更多快捷方式,方法是允许通过“设置”小部件创建快捷方式,如下面的视频所示。

我想让我的应用程序的用户能够为我的应用程序中的许多功能创建快捷方式,但是,大多数启动器只能通过长按显示四个快捷方式。

有谁知道如何实现允许您创建许多快捷方式的应用程序小部件,例如已实现的“设置”应用程序?

虽然它是从 App 小部件部分添加的,但它甚至与 appwidgetprovider 无关。 如果您正在尝试创建应用小部件,那您就走错了路。

我从现有项目中获取了一些代码,希望对您有所帮助:)

1.add 需要 AndroidManifest.xml

的权限
    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>

2.add intent-filter <action android:name="android.intent.action.CREATE_SHORTCUT"/> ,所以你的 AndroidManifest.xml 应该是这样的:

    <activity
        android:name=".ui.SetupWizardActivity"
        android:label="@string/create_shortcut_label">
        <intent-filter>
            <action android:name="android.intent.action.CREATE_SHORTCUT"/>
        </intent-filter>
    </activity> 

添加这些行后,当用户将 activity 从小部件部分拖到主页时,将打开所需的 activity。

3.Here用于创建快捷方式的代码:

import android.content.Context;
import android.content.Intent;
import android.widget.Toast;

import androidx.annotation.DrawableRes;
import androidx.core.content.pm.ShortcutInfoCompat;
import androidx.core.content.pm.ShortcutManagerCompat;
import androidx.core.graphics.drawable.IconCompat;

public class ShortcutCreator {

    public static void vCreateShortcutByActivityClass(Context context, String strShortcutID, Class<?> ActivityClass, String strLabelName, @DrawableRes int resourceID){

        if (ShortcutManagerCompat.isRequestPinShortcutSupported(context)){
            Intent intent = new Intent(context, ActivityClass).setAction(Intent.ACTION_MAIN);
            ShortcutInfoCompat sic =
                    new ShortcutInfoCompat.Builder(context, strShortcutID).setIntent(intent).setShortLabel(strLabelName).setIcon(IconCompat.createWithResource(context, resourceID)).build();
            ShortcutManagerCompat.requestPinShortcut(context, sic, null);

        }else{

            Toast.makeText(context, "Device doesn't support creating shortcuts.", Toast.LENGTH_SHORT).show();

        }
    }

}

注意:ShortcutID 用于判断是否存在重复的快捷方式。

4.Now你可以对你想要的activity做如下修改来调用创建快捷方式的代码(显示的activity 许多用于创建不同快捷方式的选项):

        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
    
            final String strIntentAction = getIntent().getAction();
            if (TextUtils.equals(strIntentAction,Intent.ACTION_CREATE_SHORTCUT)) {
                setContentView(R.layout.activity_shortcut);
                //display selections here and let user choose shortcut
                //...deleted
                vCreateShortcutByActivityClass(this, "ID_0", SetupWizardActivity.class, "App Settings", R.mipmap.ic_launcher);
                finish();
                return;
            }
            
            setContentView(R.layout.activity_main);
            //codes of your activity opened from launcher
            //...deleted
        }

或者你也可以创建一个新的空白activity来创建一个“单” 快捷方式,无需调用 setContentView(),如果您只需要 创建一个快捷方式:

        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            vCreateShortcutByActivityClass(this, "ID_0", MainActivity.class, "App Settings", R.mipmap.ic_launcher);
            finish();
        }

注意:对于 Android Nougat(7.1) 以下的设备,快捷方式尝试打开的目标 activity 必须至少包含一个 intent-filter标签(可以是任何,考虑为隐藏活动添加<category android:name="android.intent.category.DEFAULT"/>),否则快捷方式可能会显示“应用程序未安装”。