android - How to add app's shortcut to the home screen

Question

I know it's not documented and won't work on every device, but I see more and more apps placing their shortcuts on the home screen after they got installed. Found bunch of code chunks how to do it but for me they don't fit together. This is what I got for now.

1. Need a permission in the manifest.

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

2. Create an Intent of activity that should be called. Ex (from cgeek):

   Intent shortcutIntent = new Intent();
   shortcutIntent.setClassName("com.example.androidapp", "SampleIntent");
   shortcutIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
   shortcutIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
   

3. Create shortcut itself

   Intent addIntent = new Intent();
   addIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);
   addIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, "Shortcut Name");
   addIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, Intent.ShortcutIconResource.fromContext(context, R.drawable.icon));
   addIntent.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
   context.sendBroadcast(addIntent);
   

My questions is: Where this code should go to make shortcut added after .apk installed? I tried this code in the launcher activity, it creates broken(another story) shortcut every time app starts.

Answer 1

As far as I know, that's an optional feature of the Market app, not of the apps themselves. By design an application does not receive a broadcast about itself being installed. If that codes works, the soonest you can execute it is the first time the user launches the app. That said:

Do. Not. Automatically. Create. App. Shortcuts.

Ever.

Don't usurp the user's UI design.