Android create pinned shortcut创建桌面快捷方式

前言

本文主要针对文章Create shortcuts中动态创建桌面快捷方式的解释和例子。在8.0系统中，创建桌面快捷方式的广播com.android.launcher.action.INSTALL_SHORTCUT不再生效，创建桌面快捷方式需要用另外的方法。由于文章中没有详细的例子而且表达不是很清楚，笔者也一头雾水，经过了多方的尝试，最后才明白其中的意思，希望能给同样遇到困惑的人一点帮助。转载请注明来源「Bug总柴」

主动创建pinned shortcuts

主动创建pinned shortcuts的意思是可以通过代码让用户选择是否需要在桌面快捷方式。

/**
 * 这里用ShortcutManagerCompat是因为ShortcutManager的minsdkversion要求至少是25
 */
private void createShortCut() {
    if (ShortcutManagerCompat.isRequestPinShortcutSupported(this)) {
        ShortcutInfoCompat shortcut = new ShortcutInfoCompat.Builder(this, "id1")
                .setShortLabel("Website")
                .setLongLabel("Open the website")
                .setIcon(IconCompat.createWithResource(this, R.drawable.ic_logo_app))
                .setIntent(new Intent(Intent.ACTION_VIEW,
                    Uri.parse("https://www.mysite.example.com/")))
                    .build();

        Intent pinnedShortcutCallbackIntent = ShortcutManagerCompat.createShortcutResultIntent(this, shortcut);
        PendingIntent successCallback = PendingIntent.getBroadcast(this, /* request code */ 0,
                pinnedShortcutCallbackIntent, /* flags */ 0);

        ShortcutManagerCompat.requestPinShortcut(this, shortcut, successCallback.getIntentSender());
    }
}

运行这段代码后，会有这样的提示给到用户如下图：

device-2018-11-23-151817.png

当用户点击【添加】后会在桌面显示快捷方式，不过现在的快捷方式都带了一个下标如下图：

image.png

通过桌面小部件方式添加快捷方式

这种方式属于用户通过添加桌面小部件方式手动添加，我们需要创建一个activity来表明我们的应用有这样的快捷方式小部件，并且处理添加的行为。

// 在AndoidManifest文件中添加activity

    
        
        
    

然后在Activity中创建快捷方式：

public class AddShortcutActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_add_shortcut);
        Toast.makeText(this, "add shortcut", Toast.LENGTH_SHORT).show();
        if (ShortcutManagerCompat.isRequestPinShortcutSupported(this)) {
            ShortcutInfoCompat shortcut = new ShortcutInfoCompat.Builder(this, "id1")
                    .setShortLabel("Website")
                    .setLongLabel("Open the website")
                    .setIcon(IconCompat.createWithResource(this, R.drawable.ic_logo_app))
                    .setIntent(new Intent(Intent.ACTION_VIEW,
                            Uri.parse("https://www.mysite.example.com/")))
                    .build();

            Intent pinnedShortcutCallbackIntent = ShortcutManagerCompat.createShortcutResultIntent(this, shortcut);
            setResult(RESULT_OK, pinnedShortcutCallbackIntent);
            finish();
        }
    }
}

再次运行代码之后，可以在系统添加桌面小部件的地方看到有我们创建的小部件，这一个时候就可以拖动它到桌面了:)

image.png