uniapp 安卓快捷方式插件（桌面长按app图标） Ba-Shortcut

简介（下载地址）

Ba-Shortcut 是一款App Shortcuts（安卓快捷方式）插件。Shortcuts是指在桌面长按app图标而出现的快捷方式, 可以为你的app的关键功能添加更快速的入口而不用先打开app,点击快捷方式可以访问应用功能, 并且这种快捷方式也可以被拖拽到桌面单独放置, 变成单独的桌面快捷方式。

• 支持创建多个快捷方式
• 支持自定义图标
• 支持设置长文本和短文本（优先显示长文本，空间不够时自动显示短文本）
• 支持创建、更新、删除
• 应用添加App Shortcuts是Android 7.1(API 25)的API, 所以只能在Android 7.1的设备上显示, 同时需要launcher支持, 比如Pixel launcher(Pixel设备的默认launcher), Now launcher(Nexus设备上的launcher)现在就支持, 其他launcher也可以提供支持.

效果展示

使用方法

引用

在 script 中引入组件

	const shortcut = uni.requireNativePlugin('Ba-Shortcut')
1

示例1（App.vue）

可在App.vue中快速集成，创建在onLauncher和onShow都可，点击事件在onShow中监听

<script>
	const shortcut = uni.requireNativePlugin('Ba-Shortcut')
	export default {
		onLaunch: function() {
			console.log('App Launch')
			//创建快捷方式
			shortcut.create({
					shortcutId: "MyCamera",//快捷方式id
					shortLabel: "随手拍",//快捷方式显示短文本
					longLabel: "随时随地，拍一拍",//快捷方式显示长文本
					iconName: "ic_camera",//快捷方式图标资源名称，参照‘UI 图标设置’
				},
				(res) => {
					console.log(res);
				});
		},
		onShow: function() {
			console.log('App Show')
			//快捷方式点击事件监听
            var args = plus.runtime.arguments;
            if (args) {
                if(args.shortcutId){
                    //args参数如：{"shortLabel":"随手拍","shortcutId":"MyCamera"}
                    //根据快捷方式的 shortcutId 判断
                    //这里写你的处理逻辑
                }
                console.log(args);    
            }
		},
		onHide: function() {
			console.log('App Hide')
		}
	}
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

示例2（页面）

可在页面 script 中调用（示例参考，可根据自己业务和调用方法自行修改）

		data() {
			return {
				shortcutId: "MyCamera",
				shortLabel: "随手拍",
				longLabel: "随时随地，拍一拍",
				iconName: "ic_camera",
			}
		},
		methods: {
			create() { //创建
				shortcut.create({
						shortcutId: this.shortcutId,
						shortLabel: this.shortLabel,
						longLabel: this.longLabel,
						iconName: this.iconName,
					},
					(res) => {
						console.log(res);
						uni.showToast({
							title: res.msg,
							icon: "none",
							duration: 3000
						})
					});
			},
			update() { //更新
				shortcut.update({
						shortcutId: this.shortcutId,
						shortLabel: this.shortLabel,
						longLabel: this.longLabel,
					},
					(res) => {
						console.log(res);
						uni.showToast({
							title: res.msg,
							icon: "none",
							duration: 3000
						})
					});
			},
			deleteS() { //删除
				shortcut.delete({
						shortcutId: this.shortcutId,
					},
					(res) => {
						console.log(res);
						uni.showToast({
							title: res.msg,
							icon: "none",
							duration: 3000
						})
					});
			},
		}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

UI 图标设置

• 快捷方式图标：在项目的 “nativeplugins\Ba-Shortcut\android\res\drawable” 目录下（没有就新建），任意添加图片（支持png、jpg、xml矢量图），名字在 create 方法的 “iconName”字段设置即可。如添加自定义图片"ic_camera.png"，那么设置 iconName 为 “ic_camera”。注意：更改后需要重新制作基座才能生效，建议提前配置。
  

快捷方式点击事件监听

在应用生命周期app.vue的onLaunch事件中设置监听：

	export default {
		...
        onLaunch: function() {
			this.checkArguments();
			// 重点是以下： 一定要监听后台恢复 ！一定要   
			plus.globalEvent.addEventListener('newintent', (e) => {
				this.checkArguments(); // 检测启动参数  
			});
		},
		onShow: function() {
		},
		onHide: function() {
		},
		methods: {
			checkArguments() {
				var args = plus.runtime.arguments;
				if (args) {
				    console.log(args);	
					let args1 = JSON.parse(args);
					if(args1.shortcutId){
						//args参数如：{"shortLabel":"随手拍","shortcutId":"MyCamera"}
						//根据快捷方式的 shortcutId 判断
						//这里写你的处理逻辑
					}
					// 处理args参数，如直达到某新页面等
				}
			},
		}
		...
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

方法清单

create 方法参数

创建快捷方式

update 方法参数

更新快捷方式

delete 方法参数

删除快捷方式

系列插件

图片选择插件 Ba-MediaPicker （文档）

图片编辑插件 Ba-ImageEditor （文档）

文件选择插件 Ba-FilePicker （文档）

应用消息通知插件（多种样式，新增支持常驻通知模式） Ba-Notify（文档）

应用未读角标插件 Ba-Shortcut-Badge （文档）

应用开机自启插件 Ba-Autoboot（文档）

扫码原生插件（毫秒级、支持多码）Ba-Scanner-G（文档）

扫码原生插件 - 新（可任意自定义界面版本；支持连续扫码；支持设置扫码格式）Ba-Scanner（文档）

动态修改状态栏、导航栏背景色、字体颜色插件 Ba-AppBar（文档）

原生sqlite本地数据库管理 Ba-Sqlite（文档）

安卓保活插件（采用多种主流技术） Ba-KeepAlive（文档）

安卓快捷方式（桌面长按app图标） Ba-Shortcut（文档）

自定义图片水印（任意位置） Ba-Watermark（文档）

最接近微信的图片压缩插件 Ba-ImageCompressor（文档）

视频压缩、视频剪辑插件 Ba-VideoCompressor（文档）

动态切换应用图标、名称（如新年、国庆等） Ba-ChangeIcon（文档）

原生Toast弹窗提示（穿透所有界面、穿透原生；自定义颜色、图标 ） Ba-Toast（文档）

图片涂鸦、画笔 Ba-ImagePaint（文档）

pdf阅读（手势缩放、显示页数） Ba-Pdf（文档）

声音提示、震动提示、语音播报 Ba-Beep（文档）

websocket原生服务（自动重连、心跳检测） Ba-Websocket（文档）

短信监听（验证码） Ba-Sms（文档）

智能安装（自动升级） Ba-SmartUpgrade（文档）

监听系统广播、自定义广播 Ba-Broadcast（文档）

监听通知栏消息（支持白名单、黑名单、过滤） Ba-NotifyListener（文档）

全局置灰、哀悼置灰（可动态、同时支持nvue、vue） Ba-Gray（文档）

获取设备唯一标识（OAID、AAID、IMEI等） Ba-IdCode（文档）

实时定位（系统、后台运行、支持息屏）插件 Ba-Location（文档）

实时定位（高德、后台运行、支持息屏、坐标转换、距离计算） Ba-LocationAMap（文档）

窗口小工具、桌面小部件、微件 Ba-AppWidget（文档）

窗口小工具、桌面小部件、微件（日历、时间） Ba-AwCalendarS（文档）

画中画悬浮窗（视频） Ba-VideoPip（文档）

悬浮窗（在其他应用上层显示） Ba-FloatWindow（文档）

悬浮窗（应用内、无需授权） Ba-FloatWindow2（文档）

悬浮窗（悬浮球、动态菜单、在其他应用上层显示） Ba-FloatBall（文档）

添加到“用其他应用打开”中，用于文件传递、分享等 Ba-ShareReceive（文档）

获取地图数据（高德、地理编码、反地理编码） Ba-AMapData（文档）