当前位置：首页 > uni-app

uniapp 安卓桌面

2026-02-06 10:07:30uni-app

uniapp 实现安卓桌面快捷方式的方法

使用 uniapp 开发的应用可以通过原生插件或第三方服务实现安卓桌面快捷方式的创建。以下是几种常用方法：

使用 uni-app 原生插件

uniapp 官方提供了原生插件机制，可以通过编写原生代码实现快捷方式功能。需要修改原生工程代码：

在 AndroidManifest.xml 中添加权限：

<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>

在原生代码中添加创建快捷方式的方法：

private void createShortcut() {
 Intent shortcutIntent = new Intent();
 shortcutIntent.setClassName("your.package.name", "your.MainActivity");
 shortcutIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
 shortcutIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

 Intent addIntent = new Intent();
 addIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);
 addIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, "应用名称");
 addIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
     Intent.ShortcutIconResource.fromContext(this, R.mipmap.ic_launcher));
 addIntent.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
 sendBroadcast(addIntent);
}

使用第三方插件

市场上已有封装好的 uniapp 插件可以直接使用：

安装插件如 uni-create-shortcut：
```
npm install uni-create-shortcut --save
```

在页面中调用：


import createShortcut from 'uni-create-shortcut'

createShortcut({ name: '我的应用', icon: '/static/logo.png' }).then(res => { console.log('创建成功') })



### 注意事项

不同安卓版本对快捷方式的权限控制不同，Android 8.0 及以上版本需要特殊处理。部分厂商系统可能限制此功能。

应用需要在后台运行时才能创建快捷方式，部分手机需要在设置中允许创建快捷方式的权限。测试时需在真机上进行，模拟器可能无法正常创建。

### 替代方案

如果无法通过代码创建，可以考虑引导用户手动添加：
1. 打开应用后长按应用图标
2. 选择"添加到主屏幕"
3. 这种方式无需特殊权限，但需要用户手动操作

以上方法可根据实际需求选择使用，原生插件方式功能最完整但开发成本较高，第三方插件相对简便但可能有兼容性问题。

uniapp 安卓桌面