今天給手上的Nexus6P手機升級系統至Android7.1,體驗了一下新功能:App Shortcuts(圖示快捷方式),如下圖所示:
如何實現這樣的快捷方式呢?
官方給出的實現步驟:App Shortcuts | Android Developers
分類
圖示快捷方式(App Shortcuts)分為兩種:
- Static shortcuts(靜態快捷方式)
- Dynamic shortcuts(動態快捷方式)
靜態快捷方式是寫在xml檔案中,而動態快捷方式是在Java程式碼中編寫.
實現
環境要求
- 只有Android7.1(25)及以上手機才能使用該功能
- 要求SDK版本為25及以上
- 最低相容版本為23(因為動態快捷方式使用Icon類)
module 的build.gradle配置如下:
apply plugin: 'com.android.application'
android {
compileSdkVersion 25
buildToolsVersion "25.0.0"
defaultConfig {
applicationId "net.devwiki.shortcuts"
minSdkVersion 23
targetSdkVersion 25
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:25.0.0'
testCompile 'junit:junit:4.12'
}
複製程式碼
靜態快捷方式
1.在專案的res/資料夾下建立 xml目錄
2.在xml目錄建立shortcuts.xml檔案,內容如下
<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<shortcut
android:shortcutId="compose"
android:enabled="true"
android:icon="@drawable/ic_share_red_700_48dp"
android:shortcutShortLabel="@string/activity_short_label"
android:shortcutLongLabel="@string/activity_long_label"
android:shortcutDisabledMessage="@string/activity_disable_message">
<intent
android:action="android.intent.action.VIEW"
android:targetPackage="net.devwiki.shortcuts"
android:targetClass="net.devwiki.shortcuts.StaticActivity" />
<!-- If your shortcut is associated with multiple intents, include them
here. The last intent in the list is what the user sees when they
launch this shortcut. -->
<categories android:name="android.shortcut.conversation" />
</shortcut>
<!-- Specify more shortcuts here. -->
</shortcuts>
複製程式碼
屬性含義和圖片說明如下:
shortcutId : 快捷方式的ID
enabled : 是否可用,不可用時點選Toast提示shortcutDisabledMessage
icon : 快捷方式圖示
shortcutShortLabel : 快捷圖示放置到桌面時的標題
shortcutLongLabel : 長按圖示出現快捷方式時的標題
shortcutDisabledMessage : 快捷圖示禁用時的提示語
複製程式碼
3.在AndroidManifest.xml檔案中設定靜態快捷方式
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.devwiki.shortcuts">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
<meta-data android:name="android.app.shortcuts"
android:resource="@xml/shortcuts" />
</activity>
<activity android:name=".StaticActivity">
</activity>
</application>
</manifest>
複製程式碼
動態快捷方式
動態快捷方式即在程式碼中新增,更新快捷圖示.
ShortcutManager
提供了新增,移除,更新,禁用,啟動,獲取靜態快捷方式,獲取動態快捷方式,獲取固定在桌面的快捷方式等方法.
可在Java程式碼中動態對圖示快捷方式進行操作.
新增快捷方式
private void addShortcut() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
List<ShortcutInfo> infoList = shortcutManager.getDynamicShortcuts();
String shortcutId = null;
for (ShortcutInfo shortcutInfo : infoList) {
if (ShortcutsId.WEB_DEVWIKI.equals(shortcutInfo.getId())) {
shortcutId = shortcutInfo.getId();
}
}
if (shortcutId == null) {
ShortcutInfo shortcut = new ShortcutInfo.Builder(this, ShortcutsId.WEB_DEVWIKI)
.setShortLabel(getString(R.string.blog_short_label))
.setLongLabel(getString(R.string.blog_long_label))
.setIcon(Icon.createWithResource(this, R.drawable.ic_blog_logo))
.setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("http://blog.devwiki.net")))
.build();
shortcutManager.addDynamicShortcuts(Arrays.asList(shortcut));
Toast.makeText(this, R.string.add_shortcut_success, Toast.LENGTH_SHORT).show();
} else {
Toast.makeText(this, R.string.shortcut_already_exist, Toast.LENGTH_SHORT).show();
}
} else {
Toast.makeText(this, R.string.not_support_function, Toast.LENGTH_SHORT).show();
}
}
複製程式碼
移除快捷方式
private void removeShortcut() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
List<ShortcutInfo> infoList = shortcutManager.getDynamicShortcuts();
String shortcutId = null;
for (ShortcutInfo shortcutInfo : infoList) {
if (ShortcutsId.WEB_DEVWIKI.equals(shortcutInfo.getId())) {
shortcutId = shortcutInfo.getId();
}
}
if (shortcutId == null) {
Toast.makeText(this, R.string.shortcut_not_exist, Toast.LENGTH_SHORT).show();
} else {
shortcutManager.removeDynamicShortcuts(Arrays.asList(shortcutId));
Toast.makeText(this, R.string.remove_shortcut_success, Toast.LENGTH_SHORT).show();
}
} else {
Toast.makeText(this, R.string.not_support_function, Toast.LENGTH_SHORT).show();
}
}
複製程式碼
專案程式碼
專案程式碼在此處:Shortcuts