From fcc478ff63685be1b2a0466d252454ab34acca5e Mon Sep 17 00:00:00 2001
From: 2dust <31833384+2dust@users.noreply.github.com>
Date: Wed, 15 Apr 2026 19:04:26 +0800
Subject: [PATCH] Add launcher shortcuts to start/stop service

https://github.com/2dust/v2rayNG/issues/5485
---
 V2rayNG/app/src/fdroid/res/xml/shortcuts.xml  | 30 +++++++++++++++++++
 V2rayNG/app/src/main/AndroidManifest.xml      | 12 ++++++++
 .../java/com/v2ray/ang/ui/ScStartActivity.kt  | 20 +++++++++++++
 .../java/com/v2ray/ang/ui/ScStopActivity.kt   | 19 ++++++++++++
 .../main/res/drawable/ic_qu_start_24dp.xml    | 13 ++++++++
 .../src/main/res/drawable/ic_qu_stop_24dp.xml | 13 ++++++++
 .../src/main/res/values-zh-rCN/strings.xml    |  4 +--
 V2rayNG/app/src/main/res/xml/shortcuts.xml    | 28 +++++++++++++++++
 8 files changed, 137 insertions(+), 2 deletions(-)
 create mode 100644 V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStartActivity.kt
 create mode 100644 V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStopActivity.kt
 create mode 100644 V2rayNG/app/src/main/res/drawable/ic_qu_start_24dp.xml
 create mode 100644 V2rayNG/app/src/main/res/drawable/ic_qu_stop_24dp.xml

diff --git a/V2rayNG/app/src/fdroid/res/xml/shortcuts.xml b/V2rayNG/app/src/fdroid/res/xml/shortcuts.xml
index 1e39ab474..c8deac081 100644
--- a/V2rayNG/app/src/fdroid/res/xml/shortcuts.xml
+++ b/V2rayNG/app/src/fdroid/res/xml/shortcuts.xml
@@ -30,4 +30,34 @@
             android:targetPackage="com.v2ray.ang.fdroid" />
         <categories android:name="android.shortcut.conversation" />
     </shortcut>
+    <shortcut
+        android:enabled="true"
+        android:icon="@drawable/ic_qu_start_24dp"
+        android:shortcutDisabledMessage="@string/toast_services_start"
+        android:shortcutId="shortcuts_start"
+        android:shortcutLongLabel="@string/toast_services_start"
+        android:shortcutShortLabel="@string/toast_services_start">
+
+        <!--suppress AndroidDomInspection -->
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetClass="com.v2ray.ang.ui.ScStartActivity"
+            android:targetPackage="com.v2ray.ang.fdroid" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+    <shortcut
+        android:enabled="true"
+        android:icon="@drawable/ic_qu_stop_24dp"
+        android:shortcutDisabledMessage="@string/toast_services_stop"
+        android:shortcutId="shortcuts_stop"
+        android:shortcutLongLabel="@string/toast_services_stop"
+        android:shortcutShortLabel="@string/toast_services_stop">
+
+        <!--suppress AndroidDomInspection -->
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetClass="com.v2ray.ang.ui.ScStopActivity"
+            android:targetPackage="com.v2ray.ang.fdroid" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
 </shortcuts>
\ No newline at end of file
diff --git a/V2rayNG/app/src/main/AndroidManifest.xml b/V2rayNG/app/src/main/AndroidManifest.xml
index 900ab5154..038251433 100644
--- a/V2rayNG/app/src/main/AndroidManifest.xml
+++ b/V2rayNG/app/src/main/AndroidManifest.xml
@@ -122,6 +122,18 @@
             android:exported="false"
             android:process=":RunSoLibV2RayDaemon"
             android:theme="@style/AppThemeDayNight.NoActionBar.Translucent" />
+        <activity
+            android:name=".ui.ScStartActivity"
+            android:excludeFromRecents="true"
+            android:exported="false"
+            android:process=":RunSoLibV2RayDaemon"
+            android:theme="@style/AppThemeDayNight.NoActionBar.Translucent" />
+        <activity
+            android:name=".ui.ScStopActivity"
+            android:excludeFromRecents="true"
+            android:exported="false"
+            android:process=":RunSoLibV2RayDaemon"
+            android:theme="@style/AppThemeDayNight.NoActionBar.Translucent" />
 
         <activity
             android:name=".ui.UrlSchemeActivity"
diff --git a/V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStartActivity.kt b/V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStartActivity.kt
new file mode 100644
index 000000000..6bbc12257
--- /dev/null
+++ b/V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStartActivity.kt
@@ -0,0 +1,20 @@
+package com.v2ray.ang.ui
+
+import android.os.Bundle
+import com.v2ray.ang.R
+import com.v2ray.ang.handler.V2RayServiceManager
+
+class ScStartActivity : BaseActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        moveTaskToBack(true)
+
+        setContentView(R.layout.activity_none)
+
+        if (!V2RayServiceManager.isRunning()) {
+            V2RayServiceManager.startVServiceFromToggle(this)
+        }
+        finish()
+    }
+}
+
diff --git a/V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStopActivity.kt b/V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStopActivity.kt
new file mode 100644
index 000000000..58f24ac83
--- /dev/null
+++ b/V2rayNG/app/src/main/java/com/v2ray/ang/ui/ScStopActivity.kt
@@ -0,0 +1,19 @@
+package com.v2ray.ang.ui
+
+import android.os.Bundle
+import com.v2ray.ang.R
+import com.v2ray.ang.handler.V2RayServiceManager
+
+class ScStopActivity : BaseActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        moveTaskToBack(true)
+
+        setContentView(R.layout.activity_none)
+
+        if (V2RayServiceManager.isRunning()) {
+            V2RayServiceManager.stopVService(this)
+        }
+        finish()
+    }
+}
diff --git a/V2rayNG/app/src/main/res/drawable/ic_qu_start_24dp.xml b/V2rayNG/app/src/main/res/drawable/ic_qu_start_24dp.xml
new file mode 100644
index 000000000..526f41e7c
--- /dev/null
+++ b/V2rayNG/app/src/main/res/drawable/ic_qu_start_24dp.xml
@@ -0,0 +1,13 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="1024"
+    android:viewportHeight="1024">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M0,512C0,229.23 229.81,0 512,0 794.77,0 1024,229.81 1024,512 1024,794.77 794.19,1024 512,1024 229.23,1024 0,794.19 0,512Z" />
+
+    <path
+        android:fillColor="#FF000000"
+        android:pathData="M213.333333 789.461333V234.538667C213.333333 168.533333 285.013333 127.530667 341.930667 160.981333l471.68 277.461334c56.106667 32.981333 56.106667 114.133333 0 147.114666L341.930667 863.018667C285.056 896.469333 213.333333 855.466667 213.333333 789.461333z" />
+</vector>
\ No newline at end of file
diff --git a/V2rayNG/app/src/main/res/drawable/ic_qu_stop_24dp.xml b/V2rayNG/app/src/main/res/drawable/ic_qu_stop_24dp.xml
new file mode 100644
index 000000000..1834b92b8
--- /dev/null
+++ b/V2rayNG/app/src/main/res/drawable/ic_qu_stop_24dp.xml
@@ -0,0 +1,13 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="1024"
+    android:viewportHeight="1024">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M0,512C0,229.23 229.81,0 512,0 794.77,0 1024,229.81 1024,512 1024,794.77 794.19,1024 512,1024 229.23,1024 0,794.19 0,512Z" />
+
+    <path
+        android:fillColor="#FF000000"
+        android:pathData="M256 192h512c35.392 0 64 28.608 64 64v512c0 35.392-28.608 64-64 64H256c-35.392 0-64-28.608-64-64V256c0-35.392 28.608-64 64-64z" />
+</vector>
\ No newline at end of file
diff --git a/V2rayNG/app/src/main/res/values-zh-rCN/strings.xml b/V2rayNG/app/src/main/res/values-zh-rCN/strings.xml
index b54fbc81c..f801f73c7 100644
--- a/V2rayNG/app/src/main/res/values-zh-rCN/strings.xml
+++ b/V2rayNG/app/src/main/res/values-zh-rCN/strings.xml
@@ -15,8 +15,8 @@
     <string name="toast_permission_denied">无法取得权限</string>
     <string name="toast_permission_denied_notification">无法取得通知权限</string>
     <string name="notification_action_more">点击了解更多</string>
-    <string name="toast_services_start">启动服务中</string>
-    <string name="toast_services_stop">关闭中</string>
+    <string name="toast_services_start">启动服务</string>
+    <string name="toast_services_stop">关闭服务</string>
     <string name="toast_services_success">启动服务成功</string>
     <string name="toast_services_failure">启动服务失败</string>
 
diff --git a/V2rayNG/app/src/main/res/xml/shortcuts.xml b/V2rayNG/app/src/main/res/xml/shortcuts.xml
index 8874a7185..8d18a74c0 100644
--- a/V2rayNG/app/src/main/res/xml/shortcuts.xml
+++ b/V2rayNG/app/src/main/res/xml/shortcuts.xml
@@ -28,4 +28,32 @@
             android:targetPackage="com.v2ray.ang" />
         <categories android:name="android.shortcut.conversation" />
     </shortcut>
+    <shortcut
+        android:enabled="true"
+        android:icon="@drawable/ic_qu_start_24dp"
+        android:shortcutDisabledMessage="@string/toast_services_start"
+        android:shortcutId="shortcuts_start"
+        android:shortcutLongLabel="@string/toast_services_start"
+        android:shortcutShortLabel="@string/toast_services_start">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetClass="com.v2ray.ang.ui.ScStartActivity"
+            android:targetPackage="com.v2ray.ang" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+    <shortcut
+        android:enabled="true"
+        android:icon="@drawable/ic_qu_stop_24dp"
+        android:shortcutDisabledMessage="@string/toast_services_stop"
+        android:shortcutId="shortcuts_stop"
+        android:shortcutLongLabel="@string/toast_services_stop"
+        android:shortcutShortLabel="@string/toast_services_stop">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetClass="com.v2ray.ang.ui.ScStopActivity"
+            android:targetPackage="com.v2ray.ang" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
 </shortcuts>
\ No newline at end of file