安卓7.1 新特性Shortcut

介绍

Shortcut 是谷歌在API25提出来的类似苹果3D touch 但是没有压力感应.在安卓中完全就是长按.

来看下效果吧:

是不是很赞? 那么请随本文一起学习吧

更新

新建项目在你项目下的build.gradle下
以下目的很简单更新你编译工具和指定项目版本
1. compileSdkVersion 25
2. buildToolsVersion “25.0.0”
3. minSdkVersion 25
4. targetSdkVersion 25
更新platform-tools 到25

打开SDK Manager

如果你的Android SDK Platform-tools小于25那么请勾选然后点右下角更新

静态写法

静态写法?说白了和BroadcastReceiver(广播接受者)一样 .一个在清单文件中注册广播我们称为静态,用代码注册称为动态

在res创建xml文件夹
在res/xml下新建一个文件命名为my_shortcut.xml字符串貌似必须引用方法比如@string/xxxx

具体内容
```
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">

    <shortcut

        android:shortcutId="settings"

        android:enabled="true"

        android:icon="@mipmap/ic_launcher"

        android:shortcutShortLabel="@string/my_short"

        android:shortcutLongLabel="@string/my_long"

        android:shortcutDisabledMessage="@string/my_disable">

        <intent

            android:action="android.intent.action.VIEW"

            android:targetPackage="com.example.administrator.myapplication"

            android:targetClass="com.example.administrator.myapplication.MainActivity" />

        <intent

            android:action="android.intent.action.VIEW"

            android:targetPackage="com.example.administrator.myapplication"

            android:targetClass="com.example.administrator.myapplication.SettingsActivity" />

        <categories android:name="android.shortcut.conversation"/>

    </shortcut>

</shortcuts>
```
参数说明

shortcut 属性说明:

android:shortcutId 就是一个id标志后面动态注册会讲到

android:enabled 是否可用如果不可用那么将不显示此快捷

android:shortcutShortLabel 快捷短名:大家注意到一开始的效果图没?快捷是可以脱出来在变成一个桌面快捷方式图标.那么此图标的名字就是这个

android:shortcutLongLabel :快捷长名长按下图标弹出来列表框中每个快捷名

android:shortcutDisabledMessage: 当快捷不可用时用户点击会提示此文字后面动态会详细说明

intent属性说明:

假设1:shortcut (看清楚不是shorcuts 没有s哦)下只有一个intent 那么结果:用户点击此快捷用户跳转到intent制定的activity

假设2:shortcut 下有两个intent 我们按照顺序命名为intent1 和intent2 那么用户点击快捷的时候将会跳转到intent2 此时若用户按下back键(返回键) 那么将会跳转到intent1的界面

categories 属性说明

反正就一个值就是上面写的写死即可

在清单文件注册

注意一个小坑:注册信息必须要在activity为启动项的activity的根标签注册写下<meta-data>

 <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/my_shortcut"/>

        </activity>

做法如下:

下面少打错了”android.app.shortcuts” 下面少打了个s (电脑实在太卡了,不想重录)注意!!!!!!!!

效果展示:
小知识点

假如:你打开快捷item的程序所在的应用已经有多个activity在回退栈请猜猜会怎么样?这里留给读者自行尝试..哪怕什么都没有反生你也可以增加记忆嘛

动态写法 -添加

特点和广播接受者一样灵活

核心代码(本例只要点击”创建”按钮会执行下面方法生成快捷):

 //动态添加

    public void onclick2(View view) {

        mShortcutManager = getSystemService(ShortcutManager.class);

        List<ShortcutInfo> infos = new ArrayList<>();

        //快捷最多只能有5个

        // getMaxShortcutCountPerActivity只能返回5

        for (int i = 0; i < mShortcutManager.getMaxShortcutCountPerActivity(); i++) {

            Intent intent = new Intent(this, SettingsActivity.class);

            intent.setAction(Intent.ACTION_VIEW);

            Intent intent2 = new Intent();

            intent2.setAction("fmy.fmy");

            intent2.setClassName(getPackageName(),getPackageName()+".MainActivity.java");

            Intent[] intents = new Intent[2];

            //开始点击快捷时跳进此 返回键跳入intent2 其他类似

            intents[0]=intent;

            intents[1]=intent2;

                //第一个参数 上下文

                //第二个参数id嘛

            ShortcutInfo info = new ShortcutInfo.Builder(this, "id" + i)

                    .setShortLabel("短的名字"+i+"")

                    .setLongLabel("长的名字:" + i+"")

                    .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))

//                   .setIntent(intent)

                    .setIntents(intents)

                    .build();

            infos.add(info);

        }

        mShortcutManager.setDynamicShortcuts(infos);

    }

效果:

解析:下图我一开始没有点击”创建”按钮直接在桌面长按按钮发现没有任何反应.然后进入程序按下创建按钮并返回桌面发现可以长按点出快捷

注意和静态写法一起的坑(算本人经验吧):

那些年我们一起踩过的坑—>>上面的代码会动态创建5个快捷点击item.但是如果你此时静态写一个了快捷item那么恭喜你见红了(出现异常)

Caused by: java.lang.IllegalArgumentException: Max number of dynamic shortcuts exceeded

解决:先获取其已有的快捷item数量然后要么移除原来的,要么减少你创建.或者更新这就是我为什么知道只能创建5个原因.解决方法读者看完 “动态写法-更新(覆盖)”和”动态写法-删除”自然会明白,如果想先解决问题那么请直接拷贝更新和删除中部分核心代码

动态写法 -更新(覆盖)

如果你想某些时候改变某些快捷item的名字或者意图(intent)那么请参照以下代码

 public void onclick3(View view) {

        Intent intent2 = new Intent();

        intent2.setAction("fmy.fmy");

        intent2.setClassName(getPackageName(),getPackageName()+".MainActivity.java");

//设置id为id1 会覆盖原来快捷item为id为id1的快捷

//如果没有则什么都不会发生

        ShortcutInfo info = new ShortcutInfo.Builder(this,"id1")

                .setIntent(intent2)

                .setLongLabel("动态更新的长名")

                .setShortLabel("动态更新的短名")

                .build();

        mShortcutManager = getSystemService(ShortcutManager.class);

        List<ShortcutInfo> dynamicShortcuts = mShortcutManager.getDynamicShortcuts();

        mShortcutManager.updateShortcuts(Arrays.asList(info));

    }

效果:

动态写法 -删除(不可用)

下面一小段描述转载的(我不想写,再说次作者写这个描述非常不错此段描述原作者地址)

我们先来介绍一个名词-Pinning Shortcuts, 这是个啥玩意呢? 其实对于Shortcut, Android是允许我们直接放到桌面的, 这样就更加方便了用户的操作, google把他称作为Pinning Shortcuts, 具体啥样, 我们来张图就明白了.

对于这个Pinning Shortcuts, google的文档说, 我们开发者是没有权利去删除的, 能删除它的只有用户. 那我该项功能删除了咋办? 这东西还在桌面上, 是不是APP要崩? 当然Google考虑到了这点, 它允许我们去disable这个shortcut. 让其变为灰色用户点击时提示个小土司

好了引用结束感谢原作者

我们在桌面长按拖出来的快捷item到桌面这个item对象为ShortcutInfo

代码是最好的老师:

//删除

    public void onclick(View view) {

        mShortcutManager = getSystemService(ShortcutManager.class);

        //获取所有被拉取出来的快捷item(如果一个item都没有被拉出那么返回长度为0)

        List<ShortcutInfo> infos = mShortcutManager.getPinnedShortcuts();

        //遍历所有的被拉出的item 然后让其变成灰色不可点击

        for (ShortcutInfo info :

                infos ) {

            //此时被拉出的快捷item 变为灰色 用户再点击 会弹出吐司内容为第二个参数 "不可点击哦"

           // 此时桌面长按原程序图标弹出的快捷列表已经没有了

            mShortcutManager.disableShortcuts(Arrays.asList(info.getId()), "不可点击哦");

            List<ShortcutInfo> dynamicShortcuts = mShortcutManager.getDynamicShortcuts();

            Log.e("TAG","大小"+dynamicShortcuts.size());

            //虽然不可见但是你 依然要移除在动态添加列表里的东西 不过我调用disableShortcuts

            // 后发现其大小变了.内部应该调用此方法了.由于电脑太卡没下载源码 所以保险起见写上吧

            mShortcutManager.removeDynamicShortcuts(Arrays.asList(info.getId()));

        }

        List<ShortcutInfo> dynamicShortcuts = mShortcutManager.getDynamicShortcuts();

        Log.e("TAG","大小"+dynamicShortcuts.size());

    }

小知识点

用户删除数据时被拖出来快捷item会被删除
用户删除数据时动态创建的item 你在桌面在长按程序图标也没有需要重新写入
用户卸载时被拖出来快捷item会被删除

关于这篇博文

我偶然看到这个7.1新特性于是一直在找学习资料.然后想写下期间看了几篇文章并结合自己体会写下来.这篇博客用到模拟器要用SDK manager 下载镜像因为只有它有7.1镜像 genymotion 最新的也就只有7.0 而已.运行谷歌自带镜像及其耗费内存我就4G内存开完stuio和博客和模拟器内存只剩下80mb 卡的程度可想而知.但是一直想写一篇高质量的博文.于是硬着头皮卡了5个小时写下了.由于时间仓促错漏在所难免,由于卡到不行不敢点击源码去看而且我也没下载.如果以上文字对你有那么一点带你帮助将是我最大的欣慰;