Android添加快捷方式(Short)到手機桌面

一、在日常開發中，我們經常會遇到這樣的需求就是網桌面添加快捷方式：常見的快捷方式有兩種：一是APP的快捷方式，一是widget插件的快捷方式。下面詳細介紹這兩種情況的應用：

參考網站：http://www.cnblogs.com/lhxin/archive/2012/05/30/2526525.html

http://blog.csdn.net/xubin341719/article/details/7059285

二、APP的快捷方式：

1、 app快捷方式的實現又有兩種情況，一是直接在桌面生成；一是通過長按桌面，在彈出的快捷菜單中生成。

2、直接生成快捷方式主要是通過發送系統廣播InstallShortcutReceiver實現的。

我們先來看一下InstallShortcutReceiver的源代碼。位於packages\apps\Launcher2\src\com\android\launcher2下面：

[java]view
plaincopy

/* 

 * Copyright (C) 2008 The Android Open Source Project 

 * 

 * Licensed under the Apache License, Version 2.0 (the "License"); 

 * you may not use this file except in compliance with the License. 

 * You may obtain a copy of the License at 

 * 

 *      http://www.apache.org/licenses/LICENSE-2.0 

 * 

 * Unless required by applicable law or agreed to in writing, software 

 * distributed under the License is distributed on an "AS IS" BASIS, 

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 

 * See the License for the specific language governing permissions and 

 * limitations under the License. 

 */  

package com.android.launcher2;  

import java.util.ArrayList;  

import android.content.BroadcastReceiver;  

import android.content.Context;  

import android.content.Intent;  

import android.widget.Toast;  

import com.android.launcher.R;  

public class InstallShortcutReceiver extends BroadcastReceiver {  

    public static final String ACTION_INSTALL_SHORTCUT =  

            "com.android.launcher.action.INSTALL_SHORTCUT";  

    // A mime-type representing shortcut data  

    public static final String SHORTCUT_MIMETYPE =  

            "com.android.launcher/shortcut";  

    private final int[] mCoordinates = new int[2];  

    public void onReceive(Context context, Intent data) {  

        if (!ACTION_INSTALL_SHORTCUT.equals(data.getAction())) {  

            return;  

        }  

        int screen = Launcher.getScreen();  

        if (!installShortcut(context, data, screen)) {  

            // The target screen is full, let's try the other screens  

            for (int i = 0; i < Launcher.SCREEN_COUNT; i++) {  

                if (i != screen && installShortcut(context, data, i)) break;  

            }  

        }  

    }  

    private boolean installShortcut(Context context, Intent data, int screen) {  

        String name = data.getStringExtra(Intent.EXTRA_SHORTCUT_NAME);  

        if (findEmptyCell(context, mCoordinates, screen)) {  

            Intent intent = data.getParcelableExtra(Intent.EXTRA_SHORTCUT_INTENT);  

            if (intent != null) {  

                if (intent.getAction() == null) {  

                    intent.setAction(Intent.ACTION_VIEW);  

                }  

                // By default, we allow for duplicate entries (located in  

                // different places)  

                boolean duplicate = data.getBooleanExtra(Launcher.EXTRA_SHORTCUT_DUPLICATE, true);  

                if (duplicate || !LauncherModel.shortcutExists(context, name, intent)) {  

                    LauncherApplication app = (LauncherApplication) context.getApplicationContext();  

                    app.getModel().addShortcut(context, data,  

                            LauncherSettings.Favorites.CONTAINER_DESKTOP, screen, mCoordinates[0],  

                            mCoordinates[1], true);  

                    Toast.makeText(context, context.getString(R.string.shortcut_installed, name),  

                            Toast.LENGTH_SHORT).show();  

                } else {  

                    Toast.makeText(context, context.getString(R.string.shortcut_duplicate, name),  

                            Toast.LENGTH_SHORT).show();  

                }  

                return true;  

            }  

        } else {  

            Toast.makeText(context, context.getString(R.string.out_of_space),  

                    Toast.LENGTH_SHORT).show();  

        }  

        return false;  

    }  

    private static boolean findEmptyCell(Context context, int[] xy, int screen) {  

        final int xCount = LauncherModel.getCellCountX();  

        final int yCount = LauncherModel.getCellCountY();  

        boolean[][] occupied = new boolean[xCount][yCount];  

        ArrayList<ItemInfo> items = LauncherModel.getItemsInLocalCoordinates(context);  

        ItemInfo item = null;  

        int cellX, cellY, spanX, spanY;  

        for (int i = 0; i < items.size(); ++i) {  

            item = items.get(i);  

            if (item.container == LauncherSettings.Favorites.CONTAINER_DESKTOP) {  

                if (item.screen == screen) {  

                    cellX = item.cellX;  

                    cellY = item.cellY;  

                    spanX = item.spanX;  

                    spanY = item.spanY;  

                    for (int x = cellX; x < cellX + spanX && x < xCount; x++) {  

                        for (int y = cellY; y < cellY + spanY && y < yCount; y++) {  

                            occupied[x][y] = true;  

                        }  

                    }  

                }  

            }  

        }  

        return CellLayout.findVacantCell(xy, 1, 1, xCount, yCount, occupied);  

    }  

}

通過以上源代碼的閱讀，我相信你基本瞭解創建的原理了。

權限

　　要在手機桌面上添加快捷方式，首先需要在manifest中添加權限。

    <!-- 添加快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
    <!-- 移除快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT" />
    <!-- 查詢快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />

添加快捷方式

　　添加快捷方式，是向桌面應用(launcher)發送相關action的廣播，相關的action如下：

　　public static final String ACTION_ADD_SHORTCUT = "com.android.launcher.action.INSTALL_SHORTCUT";

　　添加快捷方式：

    private void addShortcut(String name) {
        Intent addShortcutIntent = new Intent(ACTION_ADD_SHORTCUT);

        // 不允許重複創建
        addShortcutIntent.putExtra("duplicate", false);// 經測試不是根據快捷方式的名字判斷重複的
        // 應該是根據快鏈的Intent來判斷是否重複的,即Intent.EXTRA_SHORTCUT_INTENT字段的value
        // 但是名稱不同時，雖然有的手機系統會顯示Toast提示重複，仍然會建立快鏈
        // 屏幕上沒有空間時會提示
        // 注意：重複創建的行爲MIUI和三星手機上不太一樣，小米上似乎不能重複創建快捷方式

        // 名字
        addShortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);

        // 圖標
        addShortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
                Intent.ShortcutIconResource.fromContext(MainActivity.this,
                        R.drawable.ic_launcher));

        // 設置關聯程序
        Intent launcherIntent = new Intent(Intent.ACTION_MAIN);
        launcherIntent.setClass(MainActivity.this, MainActivity.class);
        launcherIntent.addCategory(Intent.CATEGORY_LAUNCHER);

        addShortcutIntent
                .putExtra(Intent.EXTRA_SHORTCUT_INTENT, launcherIntent);

        // 發送廣播
        sendBroadcast(addShortcutIntent);
    }

移除快捷方式

　　移除快捷方式的action：

public static final String ACTION_REMOVE_SHORTCUT = "com.android.launcher.action.UNINSTALL_SHORTCUT";

　　移除快捷方式的方法：

    private void removeShortcut(String name) {
        // remove shortcut的方法在小米系統上不管用，在三星上可以移除
        Intent intent = new Intent(ACTION_REMOVE_SHORTCUT);

        // 名字
        intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);

        // 設置關聯程序
        Intent launcherIntent = new Intent(MainActivity.this,
                MainActivity.class).setAction(Intent.ACTION_MAIN);

        intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, launcherIntent);

        // 發送廣播
        sendBroadcast(intent);
    }

　　在兩個手機上測試，發現小米手機上添加了快捷方式後不能移除，三星手機可以。

查詢快捷方式

　　查詢快捷方式是否存在的方法是從網上其他資料那裏查來的，但是測試查詢的時候失敗了，兩個手機(小米、三星)都查不到。

　　先留着代碼以後看看是什麼原因吧：

    private boolean hasInstallShortcut(String name) {

        boolean hasInstall = false;

        final String AUTHORITY = "com.android.launcher2.settings";
        Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY
                + "/favorites?notify=true");

        // 這裏總是failed to find provider info
        // com.android.launcher2.settings和com.android.launcher.settings都不行
        Cursor cursor = this.getContentResolver().query(CONTENT_URI,
                new String[] { "title", "iconResource" }, "title=?",
                new String[] { name }, null);

        if (cursor != null && cursor.getCount() > 0) {
            hasInstall = true;
        }

        return hasInstall;

    }

參考資料

　　Android之生成桌面快捷方式（一）

　　Android之生成桌面快捷方式（二）

　　http://blog.csdn.net/ldj299/article/details/6298452

　　http://www.xmumu.com/post/2012-04-01/17357119

　　http://www.cnblogs.com/CoolPigs/p/3317234.html

權限

　　要在手機桌面上添加快捷方式，首先需要在manifest中添加權限。

    <!-- 添加快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
    <!-- 移除快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT" />
    <!-- 查詢快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />

添加快捷方式

　　添加快捷方式，是向桌面應用(launcher)發送相關action的廣播，相關的action如下：

　　public static final String ACTION_ADD_SHORTCUT = "com.android.launcher.action.INSTALL_SHORTCUT";

　　添加快捷方式：

    private void addShortcut(String name) {
        Intent addShortcutIntent = new Intent(ACTION_ADD_SHORTCUT);

        // 不允許重複創建
        addShortcutIntent.putExtra("duplicate", false);// 經測試不是根據快捷方式的名字判斷重複的
        // 應該是根據快鏈的Intent來判斷是否重複的,即Intent.EXTRA_SHORTCUT_INTENT字段的value
        // 但是名稱不同時，雖然有的手機系統會顯示Toast提示重複，仍然會建立快鏈
        // 屏幕上沒有空間時會提示
        // 注意：重複創建的行爲MIUI和三星手機上不太一樣，小米上似乎不能重複創建快捷方式

        // 名字
        addShortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);

        // 圖標
        addShortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
                Intent.ShortcutIconResource.fromContext(MainActivity.this,
                        R.drawable.ic_launcher));

        // 設置關聯程序
        Intent launcherIntent = new Intent(Intent.ACTION_MAIN);
        launcherIntent.setClass(MainActivity.this, MainActivity.class);
        launcherIntent.addCategory(Intent.CATEGORY_LAUNCHER);

        addShortcutIntent
                .putExtra(Intent.EXTRA_SHORTCUT_INTENT, launcherIntent);

        // 發送廣播
        sendBroadcast(addShortcutIntent);
    }

移除快捷方式

　　移除快捷方式的action：

public static final String ACTION_REMOVE_SHORTCUT = "com.android.launcher.action.UNINSTALL_SHORTCUT";

　　移除快捷方式的方法：

    private void removeShortcut(String name) {
        // remove shortcut的方法在小米系統上不管用，在三星上可以移除
        Intent intent = new Intent(ACTION_REMOVE_SHORTCUT);

        // 名字
        intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);

        // 設置關聯程序
        Intent launcherIntent = new Intent(MainActivity.this,
                MainActivity.class).setAction(Intent.ACTION_MAIN);

        intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, launcherIntent);

        // 發送廣播
        sendBroadcast(intent);
    }

　　在兩個手機上測試，發現小米手機上添加了快捷方式後不能移除，三星手機可以。

查詢快捷方式

　　查詢快捷方式是否存在的方法是從網上其他資料那裏查來的，但是測試查詢的時候失敗了，兩個手機(小米、三星)都查不到。

　　先留着代碼以後看看是什麼原因吧：

    private boolean hasInstallShortcut(String name) {

        boolean hasInstall = false;

        final String AUTHORITY = "com.android.launcher2.settings";
        Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY
                + "/favorites?notify=true");

        // 這裏總是failed to find provider info
        // com.android.launcher2.settings和com.android.launcher.settings都不行
        Cursor cursor = this.getContentResolver().query(CONTENT_URI,
                new String[] { "title", "iconResource" }, "title=?",
                new String[] { name }, null);

        if (cursor != null && cursor.getCount() > 0) {
            hasInstall = true;
        }

        return hasInstall;

    }

參考資料

　　Android之生成桌面快捷方式（一）

　　Android之生成桌面快捷方式（二）

　　http://blog.csdn.net/ldj299/article/details/6298452

　　http://www.xmumu.com/post/2012-04-01/17357119

　　http://www.cnblogs.com/CoolPigs/p/3317234.html

Android添加快捷方式(Short)到手機桌面

權限

添加快捷方式

移除快捷方式

查詢快捷方式

參考資料

權限

添加快捷方式

移除快捷方式

查詢快捷方式

參考資料

JNI學習小結

1.Java的集合類 2.Vector,ArrayList,LinkedList,SynchronizedList 3.HashMap與ConcurrentHashMap的區別

android 佈局優化標籤、、

Android 可拖拽的GridView效果實現, 長按可拖拽和item實時交換

Ted Mosby - 一個MVP框架的軟件架構

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結