doc: 2.0

.github/workflows/ci_build.yml

@@ -36,6 +36,12 @@ jobs:
           repository: libxposed/api
           path: libxposed/api
 
+      - name: Checkout libxposed/service
+        uses: actions/checkout@v4
+        with:
+          repository: libxposed/service
+          path: libxposed/service
+
       - name: Setup Java
         uses: actions/setup-java@v4
         with:
@@ -56,6 +62,8 @@ jobs:
           echo 'android.native.buildOutput=verbose' >> ~/.gradle/gradle.properties
           cd api
           ./gradlew publishToMavenLocal
+          cd ../service
+          ./gradlew publishToMavenLocal
 
       - name: Setup Java
         uses: actions/setup-java@v4

README.md

@@ -2,21 +2,52 @@
 
 简体中文  |  [English](https://github.com/parallelcc/MiCTS/blob/main/README_en.md)
 
-小米系统桌面开启圈定即搜（Circle to Search）功能
+在任意Android 9–15设备上触发圈定即搜（Circle to Search）功能
 
-## 操作步骤
+*本应用只负责触发圈定即搜，无法处理触发成功后可能出现的问题*
 
-1. 安装最新版[Google](https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox)应用，开启`自启动`权限，`省电策略`选择`无限制`
+## 使用方法
 
+1. 安装最新版[Google](https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox)应用，开启自启动，关闭后台限制，将默认助理应用设置为Google
 
-2. 安装并启用模块，重启手机
 
+2. 安装并打开MiCTS
+    - 如果幸运的话，可以在不用root的情况下直接触发圈定即搜
+    - 否则需要在LSPosed里激活模块，在MiCTS设置里开启`Google机型伪装`后，强制重启Google
+    - 如果还是没有反应，尝试清除Google的数据，然后打开Google，再强制重启Google
 
-3. 执行相应的动作触发
-    - 如果是全面屏手势，需要在`桌面设置-系统导航方式`里，关闭`隐藏手势提示线`，之后长按底部小白条触发
-    - 如果是经典导航键（三按钮），需要在`桌面设置-系统导航方式-按键快捷方式-长按Home键`里，选择`语音助手`，之后长按Home键触发
 
+3. 设置触发方式
+    - 打开MiCTS即可触发，因此可以利用其他软件，比如悬浮球、Xposed Edge、ShortX等，将动作设置为打开MiCTS，实现自定义触发方式
+    - MiCTS提供了一个触发磁贴，可将其添加到快速设置面板里，通过点击磁贴触发
+    - 对于小米设备，MiCTS内置了长按小白条触发和长按Home键触发的功能，可以在MiCTS设置里开启（安装MiCTS后需要激活模块并重启手机才能使用）
 
-4. 如果没有反应，尝试执行以下选项后重试:
-    - 在`设置-应用设置-右上角其他设置-默认应用设置-助手和语音输入-数字助理应用`里选择Google
-    - 在Google的应用信息里`清除全部数据`，再打开Google，再到应用信息里`结束运行`并开启`自启动`
+## 设置
+
+### 进入设置的方式
+- 长按MiCTS应用图标，出现设置选项，点击进入
+- 从LSPosed模块页面，点击MiCTS，再点击设置图标进入
+- 长按快速设置面板的磁贴进入
+
+### 应用设置
+- 默认触发延迟：通过打开MiCTS触发的延迟
+- 磁贴触发延迟：通过点击快速设置面板的磁贴触发的延迟
+
+### 模块设置
+需要在LSPosed里激活模块
+- 系统触发服务：触发所使用的系统服务，只会显示当前支持的选项，依赖作用域选择系统框架
+   - VIS：支持Android 9–15，需要将默认助理应用设置为Google，触发时屏幕边缘会闪，没有激活模块的情况下只能使用此服务
+   - CSHelper：支持Android 14 QPR3及以上，不需要设置默认助理应用，触发时屏幕边缘不会闪
+
+
+- 长按小白条触发：仅支持小米设备，依赖作用域选择系统桌面
+
+
+- 长按Home键触发：仅支持小米设备，依赖作用域选择系统框架
+
+
+- Google机型伪装：依赖作用域选择Google
+   - 制造商：修改Google读取到的ro.product.manufacturer
+   - 品牌：修改Google读取到的ro.product.brand
+   - 型号：修改Google读取到的ro.product.model
+   - 设备：修改Google读取到的ro.product.device 

README_en.md

@@ -2,21 +2,52 @@
 
 [简体中文](/README.md)  |  English
 
-Enable Circle to Search for Xiaomi System Launcher / POCO Launcher
+Trigger Circle to Search on any Android 9–15 device
 
-## Usage
+*This app only aims to triggers Circle to Search and cannot handle issues that may occur after triggering successfully*
 
-1. Install the latest version of [Google](https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox). In Google's `App info`, turn on `Autostart` if it exists and select `No restrictions` in `Battery saver`
+## How to Use
 
+1. Install the latest version of the [Google](https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox), enable auto-start, disable background restrictions, and set Google as the default assistant app
 
-2. Install and enable the module, restart your phone
 
+2. Install and launch MiCTS
+   - If you're lucky, Circle to Search can be triggered directly without root
+   - Otherwise, activate the module in LSPosed, enable `Device Spoof for Google` in the MiCTS settings, and force restart Google
+   - If it still doesn't work, try clearing Google’s data, then launch Google and force restart it
 
-3. Perform the action to trigger
-    - For `Gesture`, turn off `Hide full screen indicator` in `Home Screen Settings - System Navigation`, and then long press the navigation handle at the bottom to trigger
-    - For `Buttons`, select `Launch Google Assistant` in `Home Screen Settings - System Navigation - Button shortcuts - Long press the Home button`, and then long press the home button to trigger
 
+3. Set up the trigger method
+   - Launching MiCTS will trigger, so you can use other apps like Quick Ball, Xposed Edge, ShortX, etc., set launching MiCTS as the action to customizing the trigger method
+   - MiCTS provides a trigger tile, so you can add it to the Quick Settings panel and trigger by clicking it
+   - For Xiaomi devices, MiCTS has built-in support for `Trigger by long press gesture handle` and `Trigger by long press home button`, which can be enabled in the MiCTS settings (need to activate the module and restart phone after installing MiCTS)
 
-4. If it doesn't work, try performing the following options and then retry:
-    - select Google in `Settings - Apps - Manage apps - Other Settings in the upper right corner - Default apps - Assist & voice input - Digital Assistant App`
-    - `Clear all data` in Google's `App info`, open Google, then go back to `App info`, `Force stop` and turn on `Autostart` if it exists
+## Settings
+
+### How to enter Settings
+- Long press the MiCTS app icon to show the Settings option, then click to enter
+- From Modules page in LSPosed, click MiCTS, then click the settings icon to enter
+- Long press the Quick Settings panel tile to enter
+
+### App Settings
+- Default trigger delay: The delay when triggering by launching MiCTS
+- Tile trigger delay: The delay when triggering by the Quick Settings panel tile
+
+### Module Settings
+Need to activate the module in LSPosed
+- System trigger service: The system service used by triggering. Only the services supported will be shown. Need to add System Framework to the scope in LSPosed
+   - VIS: Supports on Android 9-15. Need to set Google as the default assistant app and the screen edge will flash when triggering. If the module is not activated, only this service will be used
+   - CSHelper: Supports on Android 14 QPR3 and above. Don’t need to set Google as the default assistant app and the screen edge will not flash when triggering
+
+
+- Trigger by long press gesture handle: Only supports on Xiaomi devices. Need to add System Launcher/POCO Launcher to the scope in LSPosed
+
+
+- Trigger by long press home button: Only supports on Xiaomi devices. Need to add System Framework to the scope in LSPosed
+
+
+- Device Spoof for Google: Need to add Google to the scope in LSPosed
+   - Manufacturer: Modify the `ro.product.manufacturer` value that Google reads
+   - Brand: Modify the `ro.product.brand` value that Google reads
+   - Model: Modify the `ro.product.model` value that Google reads
+   - Device: Modify the `ro.product.device` value that Google reads

app/src/main/res/values-zh/strings.xml

@@ -1,6 +1,6 @@
 <resources>
     <string name="tile_label">圈定即搜</string>
-    <string name="xposed_description">小米系统桌面开启圈定即搜（Circle to Search）功能\nGitHub @parallelcc</string>
+    <string name="xposed_description">在任意Android 9–15设备上触发圈定即搜（Circle to Search）功能</string>
     <string name="title_activity_settings">设置</string>
 
     <string name="trigger_failed">触发失败！</string>

app/src/main/res/values/strings.xml

@@ -1,7 +1,7 @@
 <resources>
     <string name="app_name" translatable="false">MiCTS</string>
     <string name="tile_label">Circle to Search</string>
-    <string name="xposed_description">Enable Circle to Search for Xiaomi System Launcher / POCO Launcher\nGitHub @parallelcc</string>
+    <string name="xposed_description">Trigger Circle to Search on any Android 9–15 device</string>
     <string name="title_activity_settings">Settings</string>
 
     <string name="trigger_failed">Trigger failed!</string>