{"id":632,"date":"2017-06-21T05:49:16","date_gmt":"2017-06-21T05:49:16","guid":{"rendered":"http:\/\/devser.net\/moveoapps-redesign\/blog\/?p=632"},"modified":"2018-12-06T09:52:12","modified_gmt":"2018-12-06T09:52:12","slug":"how-to-code-android-app-shortcuts-like-a-pro","status":"publish","type":"post","link":"https:\/\/www.moveoapps.com\/blog\/how-to-code-android-app-shortcuts-like-a-pro\/","title":{"rendered":"How To Code Android App Shortcuts Like A Pro"},"content":{"rendered":"

With the new Android Nougat update, Google has introduced a number of interesting features\u00a0<\/a>like Multi-Window Support, Direct Reply from Notification, Quick Settings Tile API, VR Support, and Image Keyboard Support. Among all these features, we will shed light on App Shortcuts.<\/p>\n

App Shortcuts were introduced in Android 7.1 (API level 25). App Shortcuts allow users to perform multiple actions within a short period of time with relatively less effort. Shortcuts let users quickly start common or recommended tasks within your app.<\/p>\n

You can have a maximum of five Shortcuts at a time for your application.<\/p>\n

Users want to finish tasks in as few clicks as possible with minimal navigation. That\u2019s exactly what App Shortcuts let us do. Some of the tasks that can be easily performed with App Shortcuts are:<\/p>\n

\u00a0 \u00a0 1)<\/strong> Opening your company website
\n\u00a0 \u00a0 2)<\/strong> Replying to the conversation you had previously
\n\u00a0 \u00a0 3)<\/strong> Playing\/Pausing the media your app is playing currently
\n\u00a0 \u00a0 4)<\/strong> Logging out of the application<\/p>\n

Two types of App Shortcuts are available:<\/p>\n

Static:<\/strong> This cannot be changed until you make a change in the file and re-install it on a device.<\/p>\n

Dynamic:<\/strong> This can be changed during runtime also. You can make a change without re-installing it on the device.<\/p>\n

By defining your common tasks into shortcuts, you can allow users to perform those action without spending much time navigating through various screens.<\/p>\n

App Shortcuts can be launched by long-pressing on Application icon.<\/p>\n

Static Shortcuts<\/b><\/strong><\/h2>\n

Using static shortcuts in an application is very simple. Let\u2019s see how your coding will be affected.<\/p>\n

Define following meta-data tag in your AndroidManifest.xml<\/strong><\/p>\n

<application ...>\r\n ...\r\n <activity>\r\n <\/activity>\r\n \u2026\r\n \u2026\r\n\r\n <meta-data\r\n android:name=\"android.app.shortcuts\"\r\n android:resource=\"@xml\/shortcuts\" \/>\r\n<\/application><\/pre>\n
Here, android:resource will the source of your shortcuts. Create shortcuts.xml<\/strong> file under res\/xml<\/strong> folder. Here, you can define all your static shortcuts.<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<shortcuts xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\">\r\n <shortcut\r\n android:icon=\"@mipmap\/ic_launcher\"\r\n android:enabled=\"true\"\r\n android:shortcutDisabledMessage=\"@string\/disabled_message_text\"\r\n android:shortcutLongLabel=\"@string\/shortcut_long_text\"\r\n android:shortcutShortLabel=\"@string\/shortcut_short_text\">\r\n \r\n <intent\r\n android:action=\"android.intent.action.VIEW\"\r\n android:targetClass=\"<applicationId>.SecondActivity\"\r\n android:targetPackage=\"<applicationId>\" \/>\r\n \r\n <\/shortcut>\r\n<\/shortcuts><\/pre>\n
As you can see, the root element is <shortcuts>, inside which you can define multiple shortcuts using <shortcut> tag.<\/p>\n
Properties used with <shortcut> tag:<\/p>\n
Icon:<\/strong> It will be shown as an image on the left side of the shortcut.<\/p>\n
Enabled:<\/strong> It indicates whether or not shortcut will be enabled. If enabled = \u201cfalse\u201d, it won\u2019t be shown when user long-presses on the Application icon.<\/p>\n
ShortcutDisabledMessage:<\/strong> A string shown to users if they try to launch a disabled shortcut pinned to their home screen.<\/p>\n
ShortcutLongLabel:<\/strong> This text will be shown if shortcut launcher gets enough space.<\/p>\n
ShortcutShortLabel:<\/strong> This is a mandatory field. This text will be shown to most users when they see your shortcut on launcher.<\/p>\n
Intent:<\/strong> Define an intent which will be launched when users click on any shortcut.<\/p>\n
Note:<\/strong> Don\u2019t forget to mention your applicationId<\/strong> in android:targetClass and android:targetPackage, otherwise you may get App isn\u2019t installed<\/strong> error.<\/p>\n
The output of the above code will be as follows:<\/p>\n
\"\"<\/div>\n
It looks very simple, but did you notice one thing? Upon pressing the \u2018Back\u2019 button on the application launched, it closes the app and shows the home screen. This doesn\u2019t seem correct. Instead, users should be moved to the main screen of application.<\/p>\n
To do this, you need to add one more intent inside <shortcut> tag and you are done.<\/p>\n
<shortcut\r\n ...\r\n\r\n <intent\r\n android:action=\"android.intent.action.MAIN\"\r\n android:targetClass=\"<applicationId>.MainActivity\"\r\n android:targetPackage=\"<applicationId>\" \/>\r\n\r\n <intent\r\n android:action=\"android.intent.action.VIEW\"\r\n android:targetClass=\"<applicationId>.SecondActivity\"\r\n android:targetPackage=\"<applicationId>\" \/>\r\n\r\n <\/shortcut><\/pre>\n
Make sure you add android:action=”android.intent.action.MAIN”<\/em> inside <intent> for your main screen. Now every time users press \u2018Back\u2019 from SecondActivity, he\/she will be moved to the MainActivity.<\/p>\n
\"\"<\/div>\n
That\u2019s all there is about static shortcuts. Isn\u2019t that simple? Now let\u2019s move on to dynamic shortcuts.<\/p>\n
Dynamic Shortcuts<\/b><\/strong><\/h2>\n
Dynamic shortcuts allow users to define shortcuts during runtime. Behaviour of each shortcut will be defined programmatically. This means we don\u2019t need any kind of shortcuts.xml<\/strong><\/p>\n
ShortcutManager<\/a> is used to manage all the dynamic Shortcuts. ShortcutInfo<\/a> represents single shortcut, which will then be added to ShortcutManager via ShortcutInfo.Builder<\/a>.<\/p>\n
Let\u2019s consider a sample code to get a better idea.<\/p>\n
ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);\r\n\r\nIntent thirdIntent = new Intent(this,ThirdActivity.class);\r\nthirdIntent.setAction(Intent.ACTION_VIEW);\r\n\r\nShortcutInfo thirdScreenShortcut = new ShortcutInfo.Builder(this, \"shortcut_third\")\r\n .setShortLabel(\"Third Activity\")\r\n .setLongLabel(\"This is long description for Third Activity\")\r\n .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))\r\n .setIntent(thirdIntent)\r\n .build();\r\n shortcutManager.setDynamicShortcuts(Collections.singletonList(thirdScreenShortcut));<\/pre>\n
All the methods remain the same as static shortcuts. The only change that can be seen is in the ID. Shortcut ID will be given in ShortcutInfo.Builder(). As you can see here, we have used shortcut_third as an ID of the shortcut.<\/p>\n
Once you are done with setting all the properties of shortcut using ShortcutInfo.Builder(), we will add that in ShortcutManager as a list using setDynamicShortcuts()<\/a>.<\/p>\n
\"\"<\/div>\n
Now let\u2019s see how to create back stack for dynamic shortcuts. It is almost the same as what we have done in static shortcuts.<\/p>\n
Intent thirdIntent = new Intent(this, ThirdActivity.class);\r\nthirdIntent.setAction(Intent.ACTION_VIEW);\r\n\r\nShortcutInfo thirdScreenShortcut = new ShortcutInfo.Builder(this, \"shortcut_third\")\r\n .setShortLabel(\"Third Activity\")\r\n .setLongLabel(\"This is long description for Third Activity\")\r\n .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))\r\n .setIntents(new Intent[]{\r\n new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK),\r\n thirdIntent\r\n })\r\n .build();<\/pre>\n
You only need to add one more Intent with the reference of MainActivity or your home activity. Every time users open the shortcut and press the \u2018Back\u2019 button, MainActivity will be opened instead of directly moving to home screen.<\/p>\n
\"\"<\/div>\n
As the name suggests, it is dynamic; so there should be a way to perform certain operations at runtime too. Let us see a few of them.<\/p>\n
Update Shortcut Text at Runtime<\/b><\/strong><\/h2>\n
We can change\/update the name of shortcuts according to our needs. We need to use ShortcutInfo object and updateShortcuts()<\/a> of ShortcutManager.<\/p>\n
findViewById(R.id.btnChnageText).setOnClickListener(new View.OnClickListener() {\r\n @Override\r\n public void onClick(View v) {\r\n ShortcutInfo thirdShortcut = new ShortcutInfo.Builder(MainActivity.this, \"shortcut_third\")\r\n .setShortLabel(\"Changed Third Activity\")\r\n .build();\r\n\r\n shortcutManager.updateShortcuts(Arrays.asList(thirdShortcut));\r\n }\r\n });<\/pre>\n
Here, we are updating the text of \u201cThird Activity\u201d to \u201cChanged Third Activity\u201d. In order to perform this action, we need to reference the shortcut we created earlier. We will get ShortcutInfo object by using shortcut ID. In our case, it will be \u201cshortcut_third\u201d.<\/p>\n
To update in ShortcutManager, we need to use updateShortcuts() which will update all the given shortcuts. It accepts the list of ShortcutInfo.<\/p>\n
Output will be as follows:<\/p>\n
\"\"<\/div>\n
Update Shortcut Order at Runtime<\/b><\/strong><\/h2>\n
We need to use setRank() method in order to change the display order of all the shortcuts.<\/p>\n
To understand this scenario, we have created one more dynamic shortcut with ID \u201cshortcut_four\u201d<\/p>\n
ShortcutInfo thirdShortcut = new ShortcutInfo.Builder(MainActivity.this, \"shortcut_third\")\r\n .setRank(2)\r\n .build();\r\n\r\n ShortcutInfo fourthShortcut = new ShortcutInfo.Builder(MainActivity.this, \"shortcut_four\")\r\n .setRank(1)\r\n .build();\r\n\r\n shortcutManager.updateShortcuts(Arrays.asList(thirdShortcut,fourthShortcut));<\/pre>\n
setRank() will accept non-negative value. The shortcut that has the higher value will be displayed on top. In the above code, we can see that the third shortcut has the higher value, so it is displayed on top after updating it.<\/p>\n
\"\"<\/a><\/div>\n
So, that is all about App Shortcuts. If you have done something interesting with App Shortcuts, do share it with us so that other people can also know about it.<\/p>\n
Happy coding!
\n