博客

Android快捷方式的创建

  • Post author:
  • Post category:其他


转载自：http://blog.csdn.net/lenmoyouzi/article/details/16939977

一、在日常开发中，我们经常会遇到这样的需求就是网桌面添加快捷方式：常见的快捷方式有两种：一是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 plain


copy



  1. /*


  2. * Copyright (C) 2008 The Android Open Source Project


  3. *


  4. * Licensed under the Apache License, Version 2.0 (the “License”);


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


  6. * You may obtain a copy of the License at


  7. *


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


  9. *


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


  11. * distributed under the License is distributed on an “AS IS” BASIS,


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


  13. * See the License for the specific language governing permissions and


  14. * limitations under the License.


  15. */



  17. package


    com.android.launcher2;



  19. import


    java.util.ArrayList;



  21. import


    android.content.BroadcastReceiver;


  22. import


    android.content.Context;


  23. import


    android.content.Intent;


  24. import


    android.widget.Toast;



  26. import


    com.android.launcher.R;



  28. public




    class


    InstallShortcutReceiver


    extends


    BroadcastReceiver {


  29. public




    static




    final


    String ACTION_INSTALL_SHORTCUT =


  30. “com.android.launcher.action.INSTALL_SHORTCUT”


    ;



  32. // A mime-type representing shortcut data


  33. public




    static




    final


    String SHORTCUT_MIMETYPE =


  34. “com.android.launcher/shortcut”


    ;



  36. private




    final




    int


    [] mCoordinates =


    new




    int


    [


    2


    ];



  38. public




    void


    onReceive(Context context, Intent data) {


  39. if


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


  40. return


    ;

  41. }



  43. int


    screen = Launcher.getScreen();



  45. if


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


  46. // The target screen is full, let’s try the other screens


  47. for


    (


    int


    i =


    0


    ; i < Launcher.SCREEN_COUNT; i++) {


  48. if


    (i != screen && installShortcut(context, data, i))


    break


    ;

  49. }

  50. }

  51. }



  53. private




    boolean


    installShortcut(Context context, Intent data,


    int


    screen) {

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



  56. if


    (findEmptyCell(context, mCoordinates, screen)) {

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


  58. if


    (intent !=


    null


    ) {


  59. if


    (intent.getAction() ==


    null


    ) {

  60. intent.setAction(Intent.ACTION_VIEW);

  61. }



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


  64. // different places)


  65. boolean


    duplicate = data.getBooleanExtra(Launcher.EXTRA_SHORTCUT_DUPLICATE,


    true


    );


  66. if


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

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

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

  69. LauncherSettings.Favorites.CONTAINER_DESKTOP, screen, mCoordinates[

    0


    ],

  70. mCoordinates[

    1


    ],


    true


    );

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

  72. Toast.LENGTH_SHORT).show();

  73. }

    else


    {

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

  75. Toast.LENGTH_SHORT).show();

  76. }



  78. return




    true


    ;

  79. }

  80. }

    else


    {

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

  82. Toast.LENGTH_SHORT).show();

  83. }



  85. return




    false


    ;

  86. }



  88. private




    static




    boolean


    findEmptyCell(Context context,


    int


    [] xy,


    int


    screen) {


  89. final




    int


    xCount = LauncherModel.getCellCountX();


  90. final




    int


    yCount = LauncherModel.getCellCountY();


  91. boolean


    [][] occupied =


    new




    boolean


    [xCount][yCount];


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

  94. ItemInfo item =

    null


    ;


  95. int


    cellX, cellY, spanX, spanY;


  96. for


    (


    int


    i =


    0


    ; i < items.size(); ++i) {

  97. item = items.get(i);


  98. if


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


  99. if


    (item.screen == screen) {

  100. cellX = item.cellX;

  101. cellY = item.cellY;

  102. spanX = item.spanX;

  103. spanY = item.spanY;


  104. for


    (


    int


    x = cellX; x < cellX + spanX && x < xCount; x++) {


  105. for


    (


    int


    y = cellY; y < cellY + spanY && y < yCount; y++) {

  106. occupied[x][y] =

    true


    ;

  107. }

  108. }

  109. }

  110. }

  111. }



  113. return


    CellLayout.findVacantCell(xy,


    1


    ,


    1


    , xCount, yCount, occupied);

  114. }

  115. }


通过以上源代码的阅读，我相信你基本了解创建的原理了。那么我们来实现自动创建快捷方式的逻辑。在activity中创建的代码：



[java]


view plain


copy



  1. private




    void


    createShortcut() {

  2. Intent shortcut =

    new


    Intent(


    “com.android.launcher.action.INSTALL_SHORTCUT”


    );

  3. shortcut.putExtra(Intent.EXTRA_SHORTCUT_NAME, getString(R.string.app_name));

  4. shortcut.putExtra(

    “duplicate”


    ,


    false


    );


    //设置是否重复创建

  5. Intent intent =

    new


    Intent(Intent.ACTION_MAIN);

  6. intent.addCategory(Intent.CATEGORY_LAUNCHER);

  7. intent.setClass(

    this


    , WelcomeActivity.


    class


    );


    //设置第一个页面

  8. shortcut.putExtra(Intent.EXTRA_SHORTCUT_INTENT, intent);

  9. ShortcutIconResource iconRes = Intent.ShortcutIconResource.fromContext(

    this


    , R.drawable.logo);

  10. shortcut.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, iconRes);

  11. sendBroadcast(shortcut);

  12. }




如果在创建快捷方式的时候，我们没有指定“duplicate”属性，我们又不想重复创建，那么我们在创建之前就要判断是否存在快捷方式：



[java]


view plain


copy



  1. // 判读是否已经存在快捷方式


  2. public




    boolean


    isExistShortCut() {


  3. boolean


    isInstallShortcut =


    false


    ;


  4. final


    ContentResolver cr = MainActivity.


    this


    .getContentResolver();


  5. // 本人的2.2系统是”com.android.launcher2.settings”,网上见其他的为”com.android.launcher.settings”


  6. final


    String AUTHORITY =


    “com.android.launcher2.settings”


    ;


  7. final


    Uri CONTENT_URI = Uri.parse(


    “content://”


    + AUTHORITY +


    “/favorites?notify=true”


    );

  8. Cursor c = cr.query(CONTENT_URI,

    new


    String[] {


    “title”


    ,


    “iconResource”


    },


    “title=?”


    ,


    new


    String[] { getString(R.string.app_name) },


    null


    );


  9. if


    (c !=


    null


    && c.getCount() >


    0


    ) {

  10. isInstallShortcut =

    true


    ;

  11. System.out.println(

    “已经存在快捷方式”


    );

  12. }


  13. return


    isInstallShortcut;

  14. }


注意要添加上对应的权限：<uses-permission android:name=”com.android.launcher.permission.INSTALL_SHORTCUT”/>




三、通过系统长按方式实现的原理和上面差不多。单实现起来稍微要简单些。


首先在注册activity时，需要添加一个action为

android

.intent.action.CREATE_SHOERTCUT的intentFilter.如下所示：


[java]


view plain


copy



  1. <activity android:name=


    “ShortCutTest”


    >

  2. <intent-filter>

  3. <action android:name=

    “android.intent.action.CREATE_SHORTCUT”


    />

  4. </intent-filter>

  5. </activity>


接下来就是就是设置快捷方式的图标、名称、事件等属性。这里图表的生成，android里提供了专门的方法来生成。


[java]


view plain


copy



  1. public




    class


    ShortCutTest


    extends


    Activity{


  2. @Override


  3. protected




    void


    onCreate(Bundle savedInstanceState) {


  4. // TODO Auto-generated method stub


  5. super


    .onCreate(savedInstanceState);

  6. createShortCut();

  7. }



  9. public




    void


    createShortCut(){

  10. Intent addShortCut;


  11. //判断是否需要添加快捷方式


  12. if


    (getIntent().getAction().equals(Intent.ACTION_CREATE_SHORTCUT)){

  13. addShortCut =

    new


    Intent();


  14. //快捷方式的名称

  15. addShortCut.putExtra(Intent.EXTRA_SHORTCUT_NAME ,

    “我的快捷方式”


    );


  16. //显示的图片

  17. Parcelable icon = ShortcutIconResource.fromContext(

    this


    , R.drawable.icon);

  18. addShortCut.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, icon);


  19. //快捷方式激活的activity，需要执行的intent，自己定义

  20. addShortCut.putExtra(Intent.EXTRA_SHORTCUT_INTENT,

    new


    Intent());


  21. //OK，生成

  22. setResult(RESULT_OK, addShortCut);

  23. }

    else


    {


  24. //取消

  25. setResult(RESULT_CANCELED);

  26. }

  27. }

  28. }


四、快捷方式的手机适配问题：




在开发中我们还会遇到这样的情况，一个APP要创建多个快捷方式，但是对应的快捷方式打开的activity的类名又是一样的，




例如：打开的都是activity都是com.test.MainActivity,然后根据传入的参数选择具体哪个tab下面的界面。例如创建语句为：



[java]


view plain


copy



  1. ComponentName componentName =


    new


    ComponentName(context.getPackageName(),


    “com.test.MainActivity”


    );

  2. Intent shortcutIntent =

    new


    Intent(


    “com.android.launcher.action.INSTALL_SHORTCUT”


    );

  3. shortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, res.getString(nameResourceId));

  4. shortcutIntent.putExtra(

    “duplicate”


    , duplicate);


    // 是否允许重复创建

  5. shortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT,

    new


    Intent(Intent.ACTION_MAIN).setComponent(componentName).putExtra(


    “tab_contact_flag”


    , tabPosition));

  6. shortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON, ((BitmapDrawable) res.getDrawable(iconResourceId)).getBitmap());

  7. context.sendBroadcast(shortcutIntent);


问题在于手机的适配，大部分手机会直接根据我们传入的：Intent.EXTRA_SHORTCUT_NAME对应的值去获取ApplicationInfo 的title.一些手机却根据我们传入的activity去找activity对应的name。由于我们传入的activity类名一样，所以获取到的ApplicationInfo 的title也是一样的。这时候的解决办法为跟activity取一个别名。





[java]


view plain


copy



  1. <activity-alias

  2. android:name=

    “com.test.tmpcontacts”

  3. android:clearTaskOnLaunch=

    “true”

  4. android:icon=

    “@drawable/ic_launcher_shortcut_contact”

  5. android:label=

    “@string/shortcut_contact”

  6. android:launchMode=

    “singleTask”

  7. android:targetActivity=

    “com.test.MainActivity”


    >

  8. <intent-filter>

  9. <action android:name=

    “android.intent.action.CREATE_SHORTCUT”


    />


  11. <category android:name=

    “android.intent.category.DEFAULT”


    />

  12. </intent-filter>

  13. </activity-alias>


在传递应用包名的时候，就传递我们取的别名