添加应用介绍窗口编译资源。

Merge remote-tracking branch 'origin/gpsrelaysentinel' into gpsrelaysentinel

gpsrelaysentinel/README.md

@@ -0,0 +1,127 @@
+# GPSRelaySentinel
+
+## 介绍
+
+### GPSRelaySentinel 应用描述
+
+#### 中文描述 ：
+GPSRelaySentinel 是一款专业的 GPS 定位中继守护工具，支持真实系统 GPS 定位监听与模拟 GPS 坐标仿真双模式运行。应用后台常驻前台服务，实时接收系统 GPS 位置数据，内置订阅者步长阈值判断机制，可对多个 GPS 订阅视图进行定点推送管理。
+提供可视化模拟控制面板，支持选择八大方位、自定义模拟移动距离，自动计算偏移目标经纬度；配备模拟模式勾选开关，可一键切换真实 GPS 工作模式与虚拟仿真模式。模拟状态下系统会接管自定义模拟坐标，忽略原生真实定位数据；普通模式则正常使用设备 GPS 原始位置。
+界面采用深色极简风格，全控件灰色文字与灰色边框统一视觉设计，集成日志实时输出面板，方便调试定位轨迹与订阅推送状态，适合定位开发测试、虚拟位置仿真、GPS 中继转发等场景使用。
+
+#### English Description :
+GPSRelaySentinel is a professional GPS relay and guardian tool, supporting dual modes of real system GPS location monitoring and simulated GPS coordinate simulation. It runs as a foreground persistent background service, receives real-time system GPS location data, and builds-in subscriber step threshold judgment mechanism to manage fixed-point push for multiple GPS subscription views.
+It provides a visual simulation control panel, supports eight direction selections and custom simulated moving distance, and automatically calculates offset target latitude and longitude. With a simulation mode checkbox, you can one-click switch between real GPS working mode and virtual simulation mode.
+In simulation mode, the app takes over custom simulated coordinates and ignores original real location data; in normal mode, it uses the device’s native GPS position normally. The UI adopts a dark minimalist design with unified gray text and gray borders for all controls, and integrates a real-time log output panel for debugging location tracks and subscription push status. It is suitable for location development testing, virtual position simulation, GPS relay forwarding and other scenarios.
+
+## 技术栈
+
+- **编程语言**: Java 7（源码）
+- **编译环境**: Java 11（Gradle 编译）
+- **Gradle 插件**: 7.2.1
+- **安卓 API**:
+  - 最低支持: API 26 (Android 8.0)
+  - 目标版本: API 30 (Android 11)
+  - 编译版本: API 30
+
+## 软件架构
+
+适配以下安卓开发环境的 Gradle 编译结构：
+- AIDE Pro
+- AndroidIDE
+
+## 模块说明
+
+本项目采用多模块结构：
+- `gpsrelaysentinel` - 主应用模块
+- `libappbase` - 基础库模块（提供 OkHttp、Gson、JSch 等基础能力）
+- `libaes` - AES 加密库模块（提供权限请求、二维码、拼音搜索等扩展功能）
+
+## 核心依赖库
+
+### 网络相关
+- OkHttp 4.4.1 / 3.14.9 - HTTP 客户端
+- Gson 2.10.1 - JSON 解析
+
+### 终端模拟
+- Termux: terminal-emulator 0.118.0
+- Termux: terminal-view 0.118.0
+- Termux: termux-shared 0.118.0
+
+### 功能组件
+- ZXing 3.4.1 - 二维码生成与扫描
+- JSch 0.1.55 - SSH/SFTP 客户端
+- Jsoup 1.13.1 - HTML 解析
+- FastJSON 1.2.76 - JSON 处理
+
+### UI 组件
+- Material Design 1.4.0
+- AndroidX 组件库
+- PullRefreshLayout 1.2.0 - 下拉刷新
+
+## Gradle 编译说明
+
+### 调试版编译
+```bash
+gradle assembleDebug
+```
+
+### 阶段版编译（发布）
+```bash
+bash .winboll/bashPublishAPKAddTag.sh gpsrelaysentinel
+```
+
+### 版本管理
+版本信息由 `gpsrelaysentinel/build.properties` 管理：
+- `baseVersion` - 基础版本号
+- `stageCount` - 阶段构建次数
+- `publishVersion` - 发布版本号
+- `buildCount` - 构建次数
+
+## 使用说明
+
+### Termux 应用配置
+
+1. 安装 Termux 应用（包名: `com.termux`）
+2. 配置允许外部应用访问：
+   ```bash
+   echo "allow-external-apps = true" > ~/.termux/termux.properties
+   ```
+
+### 权限说明
+
+应用需要以下权限：
+- 网络访问权限
+- 存储读写权限
+- 相机权限（二维码扫描）
+- 位置权限（GPS 相关功能）
+
+## 项目结构
+
+```
+gpsrelaysentinel/
+├── src/main/
+│   ├── java/          # Java 源码（Java 7 语法）
+│   ├── res/           # 资源文件
+│   ├── libs/          # 本地库文件（含 JNI 库）
+│   └── AndroidManifest.xml
+├── build.gradle       # 模块构建配置
+└── build.properties   # 版本配置文件
+```
+
+## 参与贡献
+
+1. Fork 本仓库
+2. 新建功能分支 (`git checkout -b feat_xxx`)
+3. 提交代码（作者: ZhanGSKen <zhangsken@188.com>）
+4. 新建 Pull Request
+
+## 许可证
+
+[待添加许可证信息]
+
+## 参考文档
+
+- [Android Developer Documentation](https://developer.android.com/)
+- [Termux Wiki](https://wiki.termux.com/)
+- [Gradle User Manual](https://docs.gradle.org/)

gpsrelaysentinel/app_update_description.txt

@@ -0,0 +1 @@
+

gpsrelaysentinel/build.gradle

@@ -0,0 +1,126 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.gpsrelaysentinel"
+        minSdkVersion 26
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.11"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+	
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs'] // 若SO库放在libs目录下
+        }
+    }
+
+    // 确保 Java 7 兼容性
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+}
+
+dependencies {
+	api project(':libgpsrelaysentinel')
+    
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// OkHttp网络请求
+     implementation 'com.squareup.okhttp3:okhttp:3.14.9'
+     // FastJSON解析
+     implementation 'com.alibaba:fastjson:1.2.76'
+    
+	// AndroidX 类库
+    /*api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}

gpsrelaysentinel/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Thu May 07 15:04:39 CST 2026
+stageCount=27
+libraryProject=
+baseVersion=15.11
+publishVersion=15.11.26
+buildCount=33
+baseBetaVersion=15.11.27

gpsrelaysentinel/proguard-rules.pro

@@ -0,0 +1,137 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+

gpsrelaysentinel/src/beta/AndroidManifest.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+

gpsrelaysentinel/src/beta/res/values/strings.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">GPSRelaySentinel★</string>
+	<string name="app_description">一款支持真实/模拟定位的GPS中继工具，可后台常驻，实现位置数据转发、调试与仿真，适配开发测试使用。</string>
+
+</resources>

gpsrelaysentinel/src/main/AndroidManifest.xml

@@ -0,0 +1,62 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.gpsrelaysentinel">
+
+    <!-- 只能在前台获取精确的位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
+
+    <!-- 只有在前台运行时才能获取大致位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+
+    <!-- 在后台使用位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:resizeableActivity="true"
+        android:name=".App">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name=".GlobalApplication$CrashActivity"/>
+
+        <service
+            android:name=".MainService"
+            android:enabled="true"
+            android:exported="false"/>
+
+        <service android:name=".GpsReceiverChildService1"/>
+
+        <service android:name=".GpsReceiverChildService2"/>
+
+        <service android:name=".GpsReceiverChildService3"/>
+
+        <activity android:name=".AboutActivity"/>
+
+    </application>
+
+</manifest>

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/AboutActivity.java

@@ -0,0 +1,58 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.app.Activity;
+import android.os.Bundle;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 15:39
+ */
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+
+public class AboutActivity extends AppCompatActivity {
+
+    public static final String TAG = "AboutActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					finish();
+				}
+			});
+
+        AboutView aboutView = findViewById(R.id.aboutview);
+        aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+    private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "gpsrelaysentinel";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("GPSRelaySentinel");
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=GPSRelaySentinel");
+        appInfo.setAppAPKName("GPSRelaySentinel");
+        appInfo.setAppAPKFolderName("GPSRelaySentinel");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/App.java

@@ -0,0 +1,340 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.res.Resources;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+public class App extends GlobalApplication {
+
+    private static Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+		
+        //CrashHandler.getInstance().registerGlobal(this);
+        //CrashHandler.getInstance().registerPart(this);
+    }
+
+    public static void write(InputStream input, OutputStream output) throws IOException {
+        byte[] buf = new byte[1024 * 8];
+        int len;
+        while ((len = input.read(buf)) != -1) {
+            output.write(buf, 0, len);
+        }
+    }
+
+    public static void write(File file, byte[] data) throws IOException {
+        File parent = file.getParentFile();
+        if (parent != null && !parent.exists()) parent.mkdirs();
+
+        ByteArrayInputStream input = new ByteArrayInputStream(data);
+        FileOutputStream output = new FileOutputStream(file);
+        try {
+            write(input, output);
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static String toString(InputStream input) throws IOException {
+        ByteArrayOutputStream output = new ByteArrayOutputStream();
+        write(input, output);
+        try {
+            return output.toString("UTF-8");
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static void closeIO(Closeable... closeables) {
+        for (Closeable closeable : closeables) {
+            try {
+                if (closeable != null) closeable.close();
+            } catch (IOException ignored) {}
+        }
+    }
+
+    public static class CrashHandler {
+
+        public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+
+        private static CrashHandler sInstance;
+
+        private PartCrashHandler mPartCrashHandler;
+
+        public static CrashHandler getInstance() {
+            if (sInstance == null) {
+                sInstance = new CrashHandler();
+            }
+            return sInstance;
+        }
+
+        public void registerGlobal(Context context) {
+            registerGlobal(context, null);
+        }
+
+        public void registerGlobal(Context context, String crashDir) {
+            Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandlerImpl(context.getApplicationContext(), crashDir));
+        }
+
+        public void unregister() {
+            Thread.setDefaultUncaughtExceptionHandler(DEFAULT_UNCAUGHT_EXCEPTION_HANDLER);
+        }
+
+        public void registerPart(Context context) {
+            unregisterPart(context);
+            mPartCrashHandler = new PartCrashHandler(context.getApplicationContext());
+            MAIN_HANDLER.postAtFrontOfQueue(mPartCrashHandler);
+        }
+
+        public void unregisterPart(Context context) {
+            if (mPartCrashHandler != null) {
+                mPartCrashHandler.isRunning.set(false);
+                mPartCrashHandler = null;
+            }
+        }
+
+        private static class PartCrashHandler implements Runnable {
+
+            private final Context mContext;
+
+            public AtomicBoolean isRunning = new AtomicBoolean(true);
+
+            public PartCrashHandler(Context context) {
+                this.mContext = context;
+            }
+
+            @Override
+            public void run() {
+                while (isRunning.get()) {
+                    try {
+                        Looper.loop();
+                    } catch (final Throwable e) {
+                        e.printStackTrace();
+                        if (isRunning.get()) {
+                            MAIN_HANDLER.post(new Runnable(){
+
+                                    @Override
+                                    public void run() {
+                                        Toast.makeText(mContext, e.toString(), Toast.LENGTH_LONG).show();
+                                    }
+                                });
+                        } else {
+                            if (e instanceof RuntimeException) {
+                                throw (RuntimeException)e;
+                            } else {
+                                throw new RuntimeException(e);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        private static class UncaughtExceptionHandlerImpl implements UncaughtExceptionHandler {
+
+            private static DateFormat DATE_FORMAT = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss");
+
+            private final Context mContext;
+
+            private final File mCrashDir;
+
+            public UncaughtExceptionHandlerImpl(Context context, String crashDir) {
+                this.mContext = context;
+                this.mCrashDir = TextUtils.isEmpty(crashDir) ? new File(mContext.getExternalCacheDir(), "crash") : new File(crashDir);
+            }
+
+            @Override
+            public void uncaughtException(Thread thread, Throwable throwable) {
+                try {
+
+                    String log = buildLog(throwable);
+                    writeLog(log);
+
+                    try {
+                        Intent intent = new Intent(mContext, CrashActivity.class);
+                        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                        intent.putExtra(Intent.EXTRA_TEXT, log);
+                        mContext.startActivity(intent);
+                    } catch (Throwable e) {
+                        e.printStackTrace();
+                        writeLog(e.toString());
+                    }
+
+                    throwable.printStackTrace();
+                    android.os.Process.killProcess(android.os.Process.myPid());
+                    System.exit(0);
+
+                } catch (Throwable e) {
+                    if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+                }
+            }
+
+            private String buildLog(Throwable throwable) {
+                String time = DATE_FORMAT.format(new Date());
+
+                String versionName = "unknown";
+                long versionCode = 0;
+                try {
+                    PackageInfo packageInfo = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0);
+                    versionName = packageInfo.versionName;
+                    versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+                } catch (Throwable ignored) {}
+
+                LinkedHashMap<String, String> head = new LinkedHashMap<String, String>();
+                head.put("Time Of Crash", time);
+                head.put("Device", String.format("%s, %s", Build.MANUFACTURER, Build.MODEL));
+                head.put("Android Version", String.format("%s (%d)", Build.VERSION.RELEASE, Build.VERSION.SDK_INT));
+                head.put("App Version", String.format("%s (%d)", versionName, versionCode));
+                head.put("Kernel", getKernel());
+                head.put("Support Abis", Build.VERSION.SDK_INT >= 21 && Build.SUPPORTED_ABIS != null ? Arrays.toString(Build.SUPPORTED_ABIS): "unknown");
+                head.put("Fingerprint", Build.FINGERPRINT);
+
+                StringBuilder builder = new StringBuilder();
+
+                for (String key : head.keySet()) {
+                    if (builder.length() != 0) builder.append("\n");
+                    builder.append(key);
+                    builder.append(" :    ");
+                    builder.append(head.get(key));
+                }
+
+                builder.append("\n\n");
+                builder.append(Log.getStackTraceString(throwable));
+
+                return builder.toString(); 
+            }
+
+            private void writeLog(String log) {
+                String time = DATE_FORMAT.format(new Date());
+                File file = new File(mCrashDir, "crash_" + time + ".txt");
+                try {
+                    write(file, log.getBytes("UTF-8"));
+                } catch (Throwable e) {
+                    e.printStackTrace();
+                } 
+            }
+
+            private static String getKernel() {
+                try {
+                    return App.toString(new FileInputStream("/proc/version")).trim();
+                } catch (Throwable e) {
+                    return e.getMessage();
+                }
+            }
+        }
+    }
+
+    public static final class CrashActivity extends Activity {
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+
+            setTheme(android.R.style.Theme_DeviceDefault);
+            setTitle("App Crash");
+
+            mLog = getIntent().getStringExtra(Intent.EXTRA_TEXT);
+
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView horizontalScrollView = new HorizontalScrollView(this);
+
+            TextView textView = new TextView(this);
+            int padding = dp2px(16);
+            textView.setPadding(padding, padding, padding, padding);
+            textView.setText(mLog);
+            textView.setTextIsSelectable(true);
+            textView.setTypeface(Typeface.DEFAULT);
+            textView.setLinksClickable(true);
+
+            horizontalScrollView.addView(textView);
+            contentView.addView(horizontalScrollView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+
+            setContentView(contentView);
+        }
+
+        private void restart() {
+            Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        private static int dp2px(float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(Menu menu) {
+            menu.add(0, android.R.id.copy, 0, android.R.string.copy)
+                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return super.onCreateOptionsMenu(menu);
+        }
+
+        @Override
+        public boolean onOptionsItemSelected(MenuItem item) {
+            switch (item.getItemId()) {
+                case android.R.id.copy:
+                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                    return true;
+            }
+            return super.onOptionsItemSelected(item);
+        }
+
+        @Override
+        public void onBackPressed() {
+            restart();
+        }
+    }
+}

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService1.java

@@ -0,0 +1,27 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Intent;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+import cc.winboll.studio.libgpsrelaysentinel.service.GpsSubscribeReceiverService;
+
+public final class GpsReceiverChildService1 extends GpsSubscribeReceiverService {
+
+    public static final String TAG = "GpsReceiverChildService1";
+
+    @Override
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config) {
+        super.onReceiveGpsData(point, config);
+        //当前独立接收日志
+        LogUtils.d(TAG,"独立接收服务1 成功收到GPS消息");
+        LogUtils.d(TAG,"纬度:"+point.getLatitude()+" 经度:"+point.getLongitude());
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        return START_NOT_STICKY;
+    }
+}
+

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService2.java

@@ -0,0 +1,26 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Intent;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+import cc.winboll.studio.libgpsrelaysentinel.service.GpsSubscribeReceiverService;
+
+public final class GpsReceiverChildService2 extends GpsSubscribeReceiverService {
+
+    public static final String TAG = "GpsReceiverChildService2";
+
+    @Override
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config) {
+        super.onReceiveGpsData(point, config);
+        LogUtils.d(TAG,"独立接收服务2 成功收到GPS消息");
+        LogUtils.d(TAG,"纬度:"+point.getLatitude()+" 经度:"+point.getLongitude());
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        return START_NOT_STICKY;
+    }
+}
+

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService3.java

@@ -0,0 +1,26 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Intent;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+import cc.winboll.studio.libgpsrelaysentinel.service.GpsSubscribeReceiverService;
+
+public final class GpsReceiverChildService3 extends GpsSubscribeReceiverService {
+
+    public static final String TAG = "GpsReceiverChildService3";
+
+    @Override
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config) {
+        super.onReceiveGpsData(point, config);
+        LogUtils.d(TAG,"独立接收服务3 成功收到GPS消息");
+        LogUtils.d(TAG,"纬度:"+point.getLatitude()+" 经度:"+point.getLongitude());
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        return START_NOT_STICKY;
+    }
+}
+

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainActivity.java

@@ -0,0 +1,358 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.AdapterView;
+import android.widget.ArrayAdapter;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.CompoundButton;
+import android.widget.EditText;
+import android.widget.Spinner;
+import android.widget.Switch;
+import android.widget.TextView;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.gpsrelaysentinel.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * WinBoLL Studio
+ * GPSRelaySentinel 主控制页面
+ * Java7 | API26~30
+ * 新增：模拟模式勾选控制 + 按钮互斥可用状态
+ */
+public final class MainActivity extends AppCompatActivity {
+
+    //原有控件
+    private Toolbar mToolbar;
+    private LogView mLogView;
+    private Switch mSwitchService;
+
+    //新增
+    private CheckBox mCheckBoxSimMode;
+    private Button btnSendLastGps;
+    private Spinner spinDirection;
+    private EditText etSimDistance;
+    private TextView tvTargetPreview;
+    private Button btnSimSend;
+
+    //全局模式标识 供给MainService判断
+    public static boolean IS_GPS_SIM_MODE = false;
+
+    //最后真实GPS坐标
+    public static double lastLat = 30.5928;
+    public static double lastLng = 114.3055;
+
+    //全局模拟坐标 供给MainService使用
+    public static double simLat = 30.5928;
+    public static double simLng = 114.3055;
+
+    //方位对应角度(正北0° 顺时针)
+    private double currentAngle = 0.0D;
+
+    //权限请求常量
+    private static final int REQUEST_LOCATION_PERMISSION = 1;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        initView();
+        initToolbar();
+        initSwitchEvent();
+        initSimPanelEvent();
+        initSimModeCheck();
+
+        ToastUtils.show("onCreate");
+    }
+
+    /**
+     * 全部控件绑定
+     */
+    private void initView() {
+        //原有
+        mToolbar = findViewById(R.id.toolbar);
+        mLogView = findViewById(R.id.logview);
+        mSwitchService = findViewById(R.id.switch_service);
+
+        //新增
+        mCheckBoxSimMode = findViewById(R.id.checkbox_sim_mode);
+        btnSendLastGps = findViewById(R.id.btn_send_last_gps);
+        spinDirection = findViewById(R.id.spin_direction);
+        etSimDistance = findViewById(R.id.et_sim_distance);
+        tvTargetPreview = findViewById(R.id.tv_target_point_preview);
+        btnSimSend = findViewById(R.id.btn_sim_send_gps);
+
+		//方位下拉 全局灰色文字
+		ArrayAdapter<CharSequence> dirAdapter = ArrayAdapter.createFromResource(
+			this,
+			R.array.direction_list,
+			R.layout.spinner_item_gray
+		);
+		dirAdapter.setDropDownViewResource(R.layout.spinner_item_gray);
+		spinDirection.setAdapter(dirAdapter);
+
+        //初始化开关状态
+        mSwitchService.setChecked(hasLocationPermission());
+        refreshButtonEnableStatus();
+        refreshTargetPreview();
+    }
+
+    //模拟勾选框监听
+    private void initSimModeCheck() {
+        mCheckBoxSimMode.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+					IS_GPS_SIM_MODE = isChecked;
+					refreshButtonEnableStatus();
+					if (isChecked) {
+						ToastUtils.show("已进入GPS模拟模式");
+					} else {
+						ToastUtils.show("退出模拟模式，使用真实GPS");
+					}
+				}
+			});
+    }
+
+    //刷新按钮互斥可用状态
+    private void refreshButtonEnableStatus() {
+        if (IS_GPS_SIM_MODE) {
+            //模拟模式：真实按钮禁用、模拟按钮可用
+            btnSendLastGps.setEnabled(false);
+            btnSimSend.setEnabled(true);
+        } else {
+            //正常模式：真实可用、模拟禁用
+            btnSendLastGps.setEnabled(true);
+            btnSimSend.setEnabled(false);
+        }
+    }
+
+    /**
+     * 初始化标题栏
+     */
+    private void initToolbar() {
+        setSupportActionBar(mToolbar);
+    }
+
+    /**
+     * GPS服务开关监听
+     */
+    private void initSwitchEvent() {
+        mSwitchService.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+					if (isChecked) {
+						if (hasLocationPermission()) {
+							startGpsService();
+						} else {
+							requestLocationPermission();
+							mSwitchService.setChecked(false);
+						}
+					} else {
+						stopGpsService();
+					}
+				}
+			});
+    }
+
+    /**
+     * 模拟发送面板 全部事件初始化
+     */
+    private void initSimPanelEvent() {
+        //1.原按钮：发送最后一条真实GPS
+        btnSendLastGps.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					sendLastRealGpsBroadcast();
+				}
+			});
+
+        //2.方位下拉选择 -> 切换角度并刷新预览
+        spinDirection.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
+				@Override
+				public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
+					currentAngle = getDirectionAngle(position);
+					refreshTargetPreview();
+				}
+
+				@Override
+				public void onNothingSelected(AdapterView<?> parent) {}
+			});
+
+        //3.距离输入变化自动预览
+        etSimDistance.setOnFocusChangeListener(new View.OnFocusChangeListener() {
+				@Override
+				public void onFocusChange(View v, boolean hasFocus) {
+					if (!hasFocus) {
+						refreshTargetPreview();
+					}
+				}
+			});
+
+        //4.模拟发送按钮：计算偏移并赋值全局模拟坐标
+        btnSimSend.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					saveSimGpsData();
+					ToastUtils.show("已设置当前模拟GPS坐标");
+				}
+			});
+    }
+
+    /**
+     * 保存模拟坐标到全局静态变量 供给MainService使用
+     */
+    private void saveSimGpsData() {
+        String disText = etSimDistance.getText().toString().trim();
+        double distance = 10D;
+        try {
+            distance = Double.parseDouble(disText);
+        } catch (Exception e) {
+            ToastUtils.show("请输入合法距离");
+            return;
+        }
+        double[] target = calculateOffsetLatLng(lastLat, lastLng, distance, currentAngle);
+        simLat = target[0];
+        simLng = target[1];
+        refreshTargetPreview();
+    }
+
+    /**
+     * 根据下拉position获取对应方位角度
+     */
+    private double getDirectionAngle(int pos) {
+        switch (pos) {
+            case 0: return 0.0D;    //正北
+            case 1: return 180.0D;  //正南
+            case 2: return 90.0D;   //正东
+            case 3: return 270.0D;  //正西
+            case 4: return 45.0D;   //东北
+            case 5: return 315.0D;  //西北
+            case 6: return 135.0D;  //东南
+            case 7: return 225.0D;  //西南
+            default:return 0.0D;
+        }
+    }
+
+    /**
+     * 根据基准坐标+距离+角度 计算偏移经纬度
+     */
+    private double[] calculateOffsetLatLng(double lat, double lng, double distanceMeter, double angle) {
+        double radAngle = Math.toRadians(angle);
+        double radLat = Math.toRadians(lat);
+
+        double meterPerLat = 111320D;
+        double meterPerLng = Math.cos(radLat) * 111320D;
+
+        double offsetLat = (distanceMeter * Math.cos(radAngle)) / meterPerLat;
+        double offsetLng = (distanceMeter * Math.sin(radAngle)) / meterPerLng;
+
+        return new double[]{lat + offsetLat , lng + offsetLng};
+    }
+
+    /**
+     * 刷新目标坐标预览
+     */
+    private void refreshTargetPreview() {
+        String disText = etSimDistance.getText().toString().trim();
+        double distance = 10D;
+        try {
+            distance = Double.parseDouble(disText);
+        } catch (Exception e) {}
+
+        double[] target = calculateOffsetLatLng(lastLat, lastLng, distance, currentAngle);
+        String info = "目标模拟坐标："
+			+ String.format("%.6f", target[0])
+			+ " , "
+			+ String.format("%.6f", target[1]);
+        tvTargetPreview.setText(info);
+    }
+
+    /**
+     * 发送【最后真实GPS】广播
+     */
+    private void sendLastRealGpsBroadcast() {
+        Intent broadcast = new Intent("GPS_DATA_BROADCAST");
+        broadcast.putExtra("isSim", false);
+        broadcast.putExtra("lat", lastLat);
+        broadcast.putExtra("lng", lastLng);
+        sendBroadcast(broadcast);
+        LogUtils.d("GPS_SEND", "发送真实GPS -> lat:" + lastLat + " lng:" + lastLng);
+    }
+
+    //—————— 原有权限 & 服务启停 完全原样保留 ——————
+
+    private boolean hasLocationPermission() {
+        boolean basicPermission = checkSelfPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
+			|| checkSelfPermission(android.Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED;
+
+        if (basicPermission && android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
+            return checkSelfPermission(android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;
+        }
+        return basicPermission;
+    }
+
+    private void requestLocationPermission() {
+        String[] permissionArray;
+        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
+            permissionArray = new String[]{
+				android.Manifest.permission.ACCESS_FINE_LOCATION,
+				android.Manifest.permission.ACCESS_COARSE_LOCATION,
+				android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
+            };
+        } else {
+            permissionArray = new String[]{
+				android.Manifest.permission.ACCESS_FINE_LOCATION,
+				android.Manifest.permission.ACCESS_COARSE_LOCATION
+            };
+        }
+        requestPermissions(permissionArray, REQUEST_LOCATION_PERMISSION);
+    }
+
+    private void startGpsService() {
+        Intent serviceIntent = new Intent(MainActivity.this, MainService.class);
+        startForegroundService(serviceIntent);
+        ToastUtils.show("GPS Service started");
+        LogUtils.d(MainService.TAG, "GPS Service started from MainActivity");
+    }
+
+    private void stopGpsService() {
+        getSharedPreferences(MainService.PREF_NAME, Context.MODE_PRIVATE)
+			.edit()
+			.putBoolean(MainService.KEY_SERVICE_ENABLED, false)
+			.apply();
+
+        Intent serviceIntent = new Intent(MainActivity.this, MainService.class);
+        stopService(serviceIntent);
+        ToastUtils.show("GPS Service stopped");
+        LogUtils.d(MainService.TAG, "GPS Service stopped from MainActivity");
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        if (requestCode == REQUEST_LOCATION_PERMISSION) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                mSwitchService.setChecked(true);
+                startGpsService();
+            } else {
+                ToastUtils.show("需要位置权限才能使用GPS服务");
+                mSwitchService.setChecked(false);
+            }
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        mLogView.start();
+    }
+}
+

gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainService.java

@@ -0,0 +1,269 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.location.Location;
+import android.location.LocationListener;
+import android.location.LocationManager;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.IBinder;
+
+import androidx.core.app.NotificationCompat;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.manager.GpsSubscribeManager;
+import cc.winboll.studio.libgpsrelaysentinel.manager.SubscribeLocationManager;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+
+import java.util.Map;
+
+/**
+ * WinBoLL Studio
+ * GPS定位核心前台服务
+ * 负责GPS持续监听、订阅者步长判断、基准坐标刷新、前台常驻通知
+ * Java7 | API26~30
+ * 新增：实时同步最新GPS到MainActivity静态坐标
+ */
+public final class MainService extends Service {
+
+    //日志标签
+    public static final String TAG = "MainService";
+
+    //前台通知常量
+    private static final String CHANNEL_ID = "gps_relay_channel";
+    private static final int NOTIFICATION_ID = 1;
+
+    //SP配置常量
+    static final String PREF_NAME = "gps_relay_service_prefs";
+    static final String KEY_SERVICE_ENABLED = "service_enabled";
+
+    //系统定位 & 通知控件
+    private LocationManager mLocationManager;
+    private LocationListener mLocationListener;
+    private NotificationManager mNotificationManager;
+    private NotificationCompat.Builder mNotificationBuilder;
+
+    //运行状态 & 计数
+    private boolean mIsRunning = false;
+    private int mGpsLocationCount = 0;
+
+    //订阅管理器
+    private GpsSubscribeManager mSubscribeManager;
+    private SubscribeLocationManager mLocationRuleManager;
+
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "Service onCreate");
+
+        initManager();
+        initNotificationConfig();
+
+        //上次开启状态则自动重启GPS监听
+        if (checkServiceEnableStatus()) {
+            LogUtils.d(TAG, "历史服务已启用，自动启动GPS监听");
+            startGpsLocationListen();
+        }
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "Service onStartCommand");
+        saveServiceEnableStatus(true);
+        startGpsLocationListen();
+        return START_STICKY;
+    }
+
+    /**
+     * 初始化订阅规则管理器
+     */
+    private void initManager() {
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationRuleManager = SubscribeLocationManager.getInstance();
+    }
+
+    /**
+     * 初始化通知渠道与管理类
+     */
+    private void initNotificationConfig() {
+        mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
+        createSystemNotificationChannel();
+    }
+
+    /**
+     * 读取服务启用状态
+     */
+    private boolean checkServiceEnableStatus() {
+        return getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE)
+			.getBoolean(KEY_SERVICE_ENABLED, false);
+    }
+
+    /**
+     * 保存服务启用状态
+     */
+    private void saveServiceEnableStatus(boolean enabled) {
+        getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE)
+			.edit()
+			.putBoolean(KEY_SERVICE_ENABLED, enabled)
+			.apply();
+        LogUtils.d(TAG, "服务启用状态已设置：" + enabled);
+    }
+
+    /**
+     * 启动GPS定位监听核心逻辑
+     */
+    private void startGpsLocationListen() {
+        if (mIsRunning) {
+            LogUtils.d(TAG, "GPS监听已正在运行，无需重复启动");
+            return;
+        }
+
+        mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
+        initLocationListener();
+
+        try {
+            if (mLocationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
+                //定位间隔：1000毫秒 / 最小位移1米
+                mLocationManager.requestLocationUpdates(
+					LocationManager.GPS_PROVIDER,
+					1000,
+					1,
+					mLocationListener
+                );
+                mIsRunning = true;
+                startServiceForegroundNotification();
+                LogUtils.d(TAG, "GPS定位监听已成功注册");
+            }
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "定位权限缺失，监听启动失败：" + e.getMessage());
+        }
+    }
+
+    /**
+     * 初始化定位监听回调
+     */
+    private void initLocationListener() {
+        mLocationListener = new LocationListener() {
+            @Override
+            public void onLocationChanged(Location location) {
+                handleLocationUpdate(location);
+            }
+
+            @Override
+            public void onStatusChanged(String provider, int status, Bundle extras) {
+                LogUtils.d(TAG, "GPS状态变更 -> 提供者：" + provider + " 状态：" + status);
+            }
+
+            @Override
+            public void onProviderEnabled(String provider) {
+                LogUtils.d(TAG, "GPS提供者已启用：" + provider);
+            }
+
+            @Override
+            public void onProviderDisabled(String provider) {
+                LogUtils.d(TAG, "GPS提供者已禁用：" + provider);
+            }
+        };
+    }
+
+    /**
+     * 处理每次定位刷新｜核心：步长判断 + 基准坐标更新
+     * 新增：同步最新坐标到MainActivity静态变量
+     */
+    private void handleLocationUpdate(Location location) {
+        mGpsLocationCount ++;
+        String locationInfo = "纬度：" + location.getLatitude() + " , 经度：" + location.getLongitude();
+        LogUtils.d(TAG, "定位刷新 -> " + locationInfo);
+
+        //========== 新增关键代码：实时同步最新真实GPS坐标 ==========
+        MainActivity.lastLat = location.getLatitude();
+        MainActivity.lastLng = location.getLongitude();
+        //==========================================================
+
+        //更新前台通知文案
+        updateForegroundNotification(locationInfo);
+
+        //遍历全部订阅者进行推送规则判断
+        Map<String, GpsSubscribeMsg> subscribeAllMap = mSubscribeManager.getSubscribeMap();
+        for (Map.Entry<String, GpsSubscribeMsg> entry : subscribeAllMap.entrySet()) {
+            final String subscribeSid = entry.getKey();
+            final GpsSubscribeMsg subscribeConfig = entry.getValue();
+
+            double currentLat = location.getLatitude();
+            double currentLng = location.getLongitude();
+
+            //判断是否满足推送条件(全订阅/步长阈值)
+            boolean allowPush = mLocationRuleManager.isNeedPush(subscribeSid, currentLat, currentLng);
+            if (allowPush) {
+                //推送成功后刷新该订阅者基准定点坐标
+                mLocationRuleManager.updateSubscriberPoint(subscribeSid, currentLat, currentLng);
+            }
+        }
+    }
+
+    /**
+     * 创建系统通知渠道
+     */
+    private void createSystemNotificationChannel() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            NotificationChannel notificationChannel = new NotificationChannel(
+				CHANNEL_ID,
+				"GPS Relay Service",
+				NotificationManager.IMPORTANCE_LOW
+            );
+            notificationChannel.setDescription("GPSRelaySentinel 后台常驻服务通知");
+            mNotificationManager.createNotificationChannel(notificationChannel);
+        }
+    }
+
+    /**
+     * 开启前台常驻通知
+     */
+    private void startServiceForegroundNotification() {
+        mNotificationBuilder = new NotificationCompat.Builder(this, CHANNEL_ID)
+			.setContentTitle("GPS 中继服务")
+			.setContentText("等待GPS定位数据...")
+			.setSmallIcon(android.R.drawable.ic_menu_mylocation)
+			.setOngoing(true);
+
+        Notification notification = mNotificationBuilder.build();
+        startForeground(NOTIFICATION_ID, notification);
+    }
+
+    /**
+     * 动态更新通知内容
+     */
+    private void updateForegroundNotification(String locationText) {
+        if (mNotificationBuilder != null) {
+            mNotificationBuilder.setContentText(locationText + " | 定位次数：" + mGpsLocationCount);
+            mNotificationManager.notify(NOTIFICATION_ID, mNotificationBuilder.build());
+        }
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        //注销定位监听
+        if (mLocationManager != null && mLocationListener != null) {
+            try {
+                mLocationManager.removeUpdates(mLocationListener);
+            } catch (SecurityException e) {
+                LogUtils.e(TAG, "移除定位监听权限异常：" + e.getMessage());
+            }
+        }
+        mIsRunning = false;
+        LogUtils.d(TAG, "MainService 已销毁，GPS监听已停止");
+    }
+}
+

gpsrelaysentinel/src/main/res/drawable-v24/ic_launcher_foreground.xml

@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>

gpsrelaysentinel/src/main/res/drawable/border_gray.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    android:shape="rectangle">
+    <!-- 灰色边框 -->
+    <stroke
+        android:width="1dp"
+        android:color="#555555"/>
+    <!-- 内部深色背景 -->
+    <solid android:color="#222222"/>
+    <!-- 轻微圆角 -->
+    <corners android:radius="4dp"/>
+</shape>
+

gpsrelaysentinel/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>

gpsrelaysentinel/src/main/res/layout/activity_about.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:orientation="vertical">
+
+        <com.google.android.material.appbar.AppBarLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+
+            <androidx.appcompat.widget.Toolbar
+                android:id="@+id/toolbar"
+                android:layout_width="match_parent"
+                android:layout_height="?attr/actionBarSize"
+                app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+        </com.google.android.material.appbar.AppBarLayout>
+
+        <cc.winboll.studio.libappbase.views.AboutView
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:id="@+id/aboutview"/>
+
+    </LinearLayout>
+
+</FrameLayout>

gpsrelaysentinel/src/main/res/layout/activity_main.xml

@@ -0,0 +1,198 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical"
+	android:background="#1c1c1c">
+
+	<com.google.android.material.appbar.AppBarLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+
+		<androidx.appcompat.widget.Toolbar
+			android:id="@+id/toolbar"
+			android:layout_width="match_parent"
+			android:layout_height="?attr/actionBarSize"
+			app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+	</com.google.android.material.appbar.AppBarLayout>
+
+	<!-- 数据面板容器 -->
+	<LinearLayout
+		android:id="@+id/container_data_panel"
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_horizontal">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="GPSRelaySentinel"
+			android:textColor="#888888"
+			android:padding="6dp"
+			android:background="@drawable/border_gray"
+			android:textAppearance="?android:attr/textAppearanceLarge"/>
+
+		<LinearLayout
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal"
+			android:gravity="center_vertical"
+			android:layout_marginTop="8dp"
+			android:spacing="12dp">
+
+			<CheckBox
+				android:id="@+id/checkbox_sim_mode"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="模拟模式"
+				android:textColor="#999999"
+				android:padding="4dp"
+				android:background="@drawable/border_gray"
+				android:textSize="11sp"/>
+
+			<Switch
+				android:id="@+id/switch_service"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="GPS Service"
+				android:textColor="#999999"
+				android:padding="4dp"
+				android:background="@drawable/border_gray"
+				android:checked="false"/>
+
+			<Button
+				android:id="@+id/btn_send_last_gps"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="发送最后GPS"
+				android:textColor="#bbbbbb"
+				android:background="@drawable/border_gray"
+				android:textSize="12sp"/>
+
+		</LinearLayout>
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:layout_marginTop="16dp"
+			android:padding="12dp"
+			android:background="@drawable/border_gray">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="模拟移动GPS发送面板"
+				android:textColor="#999999"
+				android:textSize="12sp"/>
+
+			<LinearLayout
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:orientation="horizontal"
+				android:layout_marginTop="8dp"
+				android:spacing="8dp">
+
+				<Spinner
+					android:id="@+id/spin_direction"
+					android:layout_width="0dp"
+					android:layout_height="wrap_content"
+					android:layout_weight="1"
+					android:background="@drawable/border_gray"/>
+
+				<EditText
+					android:id="@+id/et_sim_distance"
+					android:layout_width="0dp"
+					android:layout_height="wrap_content"
+					android:layout_weight="1"
+					android:hint="移动距离(米)"
+					android:inputType="numberDecimal"
+					android:text="10"
+					android:background="@drawable/border_gray"
+					android:textColor="#aaaaaa"
+					android:textColorHint="#666666"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:id="@+id/tv_target_point_preview"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="目标坐标：等待计算..."
+				android:textColor="#999999"
+				android:background="@drawable/border_gray"
+				android:padding="6dp"
+				android:textSize="11sp"
+				android:layout_marginTop="8dp"/>
+
+			<Button
+				android:id="@+id/btn_sim_send_gps"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="发送模拟移动GPS"
+				android:textColor="#bbbbbb"
+				android:background="@drawable/border_gray"
+				android:layout_marginTop="10dp"/>
+
+		</LinearLayout>
+		
+	</LinearLayout>
+
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<!-- 订阅面板容器 -->
+		<LinearLayout
+			android:id="@+id/container_subscribe_panel"
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center_horizontal"
+			android:padding="12dp">
+
+			<cc.winboll.studio.libgpsrelaysentinel.view.GpsSubscribeControlView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginTop="10dp"
+				android:background="@drawable/border_gray"/>
+
+			<cc.winboll.studio.libgpsrelaysentinel.view.GpsSubscribeControlView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginTop="10dp"
+				android:background="@drawable/border_gray"/>
+
+			<cc.winboll.studio.libgpsrelaysentinel.view.GpsSubscribeControlView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginTop="10dp"
+				android:background="@drawable/border_gray"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="200dp"
+		android:orientation="vertical"
+		android:id="@+id/container_log_show"
+		android:background="@drawable/border_gray">
+
+		<cc.winboll.studio.libappbase.LogView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/logview"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+

gpsrelaysentinel/src/main/res/layout/spinner_item_gray.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<TextView xmlns:android="http://schemas.android.com/apk/res/android"
+    android:id="@android:id/text1"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:padding="8dp"
+    android:textColor="#999999"
+    android:gravity="center_vertical"/>
+

gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

gpsrelaysentinel/src/main/res/values/arrays.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string-array name="direction_list">
+        <item>正北</item>
+        <item>正南</item>
+        <item>正东</item>
+        <item>正西</item>
+        <item>东北</item>
+        <item>西北</item>
+        <item>东南</item>
+        <item>西南</item>
+    </string-array>
+</resources>
+

gpsrelaysentinel/src/main/res/values/colors.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+</resources>

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

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+	
+    <string name="app_name">GPSRelaySentinel</string>
+    <string name="app_description">A GPS relay tool supporting real and simulated positioning, running in background for location forwarding, debugging and simulation.</string>
+
+</resources>

gpsrelaysentinel/src/main/res/values/styles.xml

@@ -0,0 +1,11 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="MyAppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+</resources>

gpsrelaysentinel/src/stage/AndroidManifest.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+

gpsrelaysentinel/src/stage/res/values/strings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>

libgpsrelaysentinel/.gitignore

@@ -0,0 +1 @@
+/build

libgpsrelaysentinel/build.gradle

@@ -0,0 +1,35 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 26
+        targetSdkVersion 30
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+}
+
+dependencies {
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}

libgpsrelaysentinel/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Fri May 01 17:09:11 HKT 2026
+stageCount=57
+libraryProject=libdebugtemp
+baseVersion=15.0
+publishVersion=15.0.56
+buildCount=0
+baseBetaVersion=15.0.57

libgpsrelaysentinel/proguard-rules.pro

@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

libgpsrelaysentinel/src/main/AndroidManifest.xml

@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.libgpsrelaysentinel">
+
+    <application>
+		<service
+			android:name=".service.GpsSubscribeReceiverService"
+			android:exported="true"
+			android:enabled="true">
+			<intent-filter>
+				<action android:name="cc.winboll.studio.libgpsrelaysentinel.action.RECEIVE" />
+			</intent-filter>
+		</service>
+		
+        <receiver android:name=".receiver.GpsSubscribeObserverReceiver">
+
+            <intent-filter>
+
+                <action android:name=".receiver.GpsSubscribeObserverReceiver"/>
+
+            </intent-filter>
+
+        </receiver>
+    </application>
+
+</manifest>

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/GpsSubscribeManager.java

@@ -0,0 +1,75 @@
+package cc.winboll.studio.libgpsrelaysentinel.manager;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:25
+ */
+
+import android.content.Context;
+import android.content.Intent;
+import java.util.HashMap;
+import java.util.Map;
+
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeResult;
+
+public final class GpsSubscribeManager {
+
+    private static GpsSubscribeManager instance;
+    private final Map<String,GpsSubscribeMsg> subscribeMap;
+    private Context appContext;
+
+    private GpsSubscribeManager(){
+        subscribeMap = new HashMap<String, GpsSubscribeMsg>();
+    }
+
+    public static GpsSubscribeManager getInstance(){
+        if(instance == null){
+            instance = new GpsSubscribeManager();
+        }
+        return instance;
+    }
+
+    public void initContext(final Context context){
+        this.appContext = context.getApplicationContext();
+    }
+
+    public void addSubscribe(final GpsSubscribeMsg subscribeMsg){
+        if(subscribeMsg == null){
+            return;
+        }
+        subscribeMap.put(subscribeMsg.getSubscribeUniqueId(),subscribeMsg);
+    }
+
+    public void removeSubscribe(final String sid){
+        if(sid == null){
+            return;
+        }
+        subscribeMap.remove(sid);
+        SubscribeLocationManager.getInstance().removeSubscribe(sid);
+    }
+
+    public boolean isSubscribeExist(final String sid){
+        return subscribeMap.containsKey(sid);
+    }
+
+    public void sendSubscribeResult(final GpsSubscribeResult result){
+        if(appContext == null || result == null){
+            return;
+        }
+        Intent intent = new Intent(GpsSubscribeConst.ACTION_SUBSCRIBE_CALLBACK);
+        intent.putExtra("data",result);
+        appContext.sendBroadcast(intent);
+    }
+
+    public void clearAllSubscribe(){
+        subscribeMap.clear();
+        SubscribeLocationManager.getInstance().clearAll();
+    }
+
+    public Map<String, GpsSubscribeMsg> getSubscribeMap() {
+        return subscribeMap;
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/SubscribeLocationManager.java

@@ -0,0 +1,128 @@
+package cc.winboll.studio.libgpsrelaysentinel.manager;
+
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public final class SubscribeLocationManager {
+
+    private static SubscribeLocationManager instance;
+
+    //订阅配置
+    private final Map<String,GpsSubscribeMsg> subscribeConfigMap;
+    //基准定点坐标
+    private final Map<String,LocationPoint> subscriberPointMap;
+    //真实推送计数(精准统计)
+    private final Map<String,Integer> subscriberPushCountMap;
+
+    private SubscribeLocationManager(){
+        subscribeConfigMap = new HashMap<String, GpsSubscribeMsg>();
+        subscriberPointMap = new HashMap<String, LocationPoint>();
+        subscriberPushCountMap = new HashMap<String, Integer>();
+    }
+
+    public static SubscribeLocationManager getInstance(){
+        if(instance == null){
+            instance = new SubscribeLocationManager();
+        }
+        return instance;
+    }
+
+    //========= 订阅配置 =========
+    public void putSubscribeConfig(String sid,GpsSubscribeMsg msg){
+        subscribeConfigMap.put(sid,msg);
+    }
+
+    public GpsSubscribeMsg getSubscribeConfig(String sid){
+        return subscribeConfigMap.get(sid);
+    }
+
+    //========= 基准定点坐标 =========
+    public void initSubscriberPoint(String sid,double lat,double lng){
+        subscriberPointMap.put(sid,new LocationPoint(lat,lng,System.currentTimeMillis()));
+    }
+
+    public void updateSubscriberPoint(String sid,double lat,double lng){
+        subscriberPointMap.put(sid,new LocationPoint(lat,lng,System.currentTimeMillis()));
+    }
+
+    public LocationPoint getLastPoint(String sid){
+        return subscriberPointMap.get(sid);
+    }
+
+    //========= 精准推送计数 =========
+    public void addPushCount(String sid){
+        int current = subscriberPushCountMap.get(sid) == null ? 0 : subscriberPushCountMap.get(sid);
+        subscriberPushCountMap.put(sid,current + 1);
+    }
+
+    public int getPushCount(String sid){
+        return subscriberPushCountMap.get(sid) == null ? 0 : subscriberPushCountMap.get(sid);
+    }
+
+    public void clearPushCount(String sid){
+        subscriberPushCountMap.put(sid,0);
+    }
+
+    //========= 步长规则判断 =========
+    public boolean isNeedPush(String sid,double nowLat,double nowLng){
+        GpsSubscribeMsg config = getSubscribeConfig(sid);
+        if(config == null){
+            return false;
+        }
+
+        //全量订阅直接放行
+        if(config.getSubscribeMode() == GpsSubscribeConst.SUB_TYPE_ALL){
+            return true;
+        }
+
+        //无初始定点 → 先建立第一个基准点
+        LocationPoint lastPoint = getLastPoint(sid);
+        if(lastPoint == null){
+            return true;
+        }
+
+        //计算实际移动距离
+        double distance = calculateDistance(
+			lastPoint.getLatitude(),lastPoint.getLongitude(),
+			nowLat,nowLng
+        );
+
+        return distance >= config.getStepDistanceM();
+    }
+
+    //两点经纬度距离计算(米)
+    private double calculateDistance(double lat1,double lng1,double lat2,double lng2){
+        double radLat1 = Math.toRadians(lat1);
+        double radLat2 = Math.toRadians(lat2);
+        double radLng1 = Math.toRadians(lng1);
+        double radLng2 = Math.toRadians(lng2);
+
+        double latDiff = radLat1 - radLat2;
+        double lngDiff = radLng1 - radLng2;
+
+        double value = 2 * Math.asin(Math.sqrt(
+										 Math.pow(Math.sin(latDiff / 2),2)
+										 + Math.cos(radLat1) * Math.cos(radLat2)
+										 * Math.pow(Math.sin(lngDiff / 2),2)
+									 ));
+        return value * 6378137;
+    }
+
+    //========= 移除 & 清空 =========
+    public void removeSubscribe(String sid){
+        subscribeConfigMap.remove(sid);
+        subscriberPointMap.remove(sid);
+        subscriberPushCountMap.remove(sid);
+    }
+
+    public void clearAll(){
+        subscribeConfigMap.clear();
+        subscriberPointMap.clear();
+        subscriberPushCountMap.clear();
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeConst.java

@@ -0,0 +1,46 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:22
+ * WinBoLL Studio
+ * Java7 | API26-30
+ */
+public final class GpsSubscribeConst {
+	
+	// 新增：GPS定位推送广播
+	public static final String ACTION_GPS_LOCATION = "cc.winboll.studio.ACTION_GPS_LOCATION";
+
+    //订阅运行模式
+    public static final int SUB_TYPE_ALL = 1;
+    public static final int SUB_TYPE_STEP_DISTANCE = 2;
+
+    //原始数据订阅类型
+    public static final int SUBSCRIBE_TYPE_LOCATION = 1;
+    public static final int SUBSCRIBE_TYPE_SATELLITE = 2;
+    public static final int SUBSCRIBE_TYPE_NMEA = 3;
+
+    //订阅返回码
+    public static final int RESULT_SUCCESS = 0;
+    public static final int RESULT_PERMISSION_DENY = 1;
+    public static final int RESULT_PARAM_ERROR = 2;
+    public static final int RESULT_GPS_NOT_AVAILABLE = 3;
+    public static final int RESULT_SYSTEM_LIMIT = 4;
+
+    //GPS设备状态
+    public static final int GPS_STATE_CLOSE = 0;
+    public static final int GPS_STATE_SCANNING = 1;
+    public static final int GPS_STATE_LOCATED = 2;
+    public static final int GPS_STATE_SIGNAL_WEAK = 3;
+
+    //广播Action
+    public static final String ACTION_SUBSCRIBE_REQUEST = "cc.winboll.studio.GPS_SUBSCRIBE_REQUEST";
+    public static final String ACTION_SUBSCRIBE_CALLBACK = "cc.winboll.studio.GPS_SUBSCRIBE_CALLBACK";
+
+    //超时毫秒
+    public static final long SUBSCRIBE_TIME_OUT = 5000;
+
+    //地球半径 距离计算常量
+    public static final double EARTH_RADIUS = 6378137.0;
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeMsg.java

@@ -0,0 +1,137 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:24
+ */
+import android.os.Bundle;
+import android.os.Parcel;
+import android.os.Parcelable;
+
+public final class GpsSubscribeMsg implements Parcelable {
+
+    private final String subscribePackage;
+    private final int subscribeMode;
+    private final float stepDistanceM;
+
+    private final int subscribeType;
+    private final long updateInterval;
+    private final float minDistance;
+    private final boolean backgroundPush;
+    private final String subscribeUniqueId;
+
+    public GpsSubscribeMsg(String subscribePackage,
+                           int subscribeMode,
+                           float stepDistanceM,
+                           int subscribeType,
+                           long updateInterval,
+                           float minDistance,
+                           boolean backgroundPush,
+                           String subscribeUniqueId) {
+        this.subscribePackage = subscribePackage;
+        this.subscribeMode = subscribeMode;
+        this.stepDistanceM = stepDistanceM;
+        this.subscribeType = subscribeType;
+        this.updateInterval = updateInterval;
+        this.minDistance = minDistance;
+        this.backgroundPush = backgroundPush;
+        this.subscribeUniqueId = subscribeUniqueId;
+    }
+
+    public String getSubscribePackage() {
+        return subscribePackage;
+    }
+
+    public int getSubscribeMode() {
+        return subscribeMode;
+    }
+
+    public float getStepDistanceM() {
+        return stepDistanceM;
+    }
+
+    public int getSubscribeType() {
+        return subscribeType;
+    }
+
+    public long getUpdateInterval() {
+        return updateInterval;
+    }
+
+    public float getMinDistance() {
+        return minDistance;
+    }
+
+    public boolean isBackgroundPush() {
+        return backgroundPush;
+    }
+
+    public String getSubscribeUniqueId() {
+        return subscribeUniqueId;
+    }
+
+    @Override
+    public int describeContents() {
+        return 0;
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        dest.writeString(subscribePackage);
+        dest.writeInt(subscribeMode);
+        dest.writeFloat(stepDistanceM);
+        dest.writeInt(subscribeType);
+        dest.writeLong(updateInterval);
+        dest.writeFloat(minDistance);
+        dest.writeByte((byte) (backgroundPush ? 1 : 0));
+        dest.writeString(subscribeUniqueId);
+    }
+
+    public static final Creator<GpsSubscribeMsg> CREATOR = new Creator<GpsSubscribeMsg>() {
+        @Override
+        public GpsSubscribeMsg createFromParcel(Parcel in) {
+            return new GpsSubscribeMsg(
+				in.readString(),
+				in.readInt(),
+				in.readFloat(),
+				in.readInt(),
+				in.readLong(),
+				in.readFloat(),
+				in.readByte() == 1,
+				in.readString()
+            );
+        }
+
+        @Override
+        public GpsSubscribeMsg[] newArray(int size) {
+            return new GpsSubscribeMsg[size];
+        }
+    };
+
+    public Bundle convertToBundle() {
+        Bundle bundle = new Bundle();
+        bundle.putString("pkg", subscribePackage);
+        bundle.putInt("subMode",subscribeMode);
+        bundle.putFloat("stepM",stepDistanceM);
+        bundle.putInt("type", subscribeType);
+        bundle.putLong("interval", updateInterval);
+        bundle.putFloat("distance", minDistance);
+        bundle.putBoolean("bgPush", backgroundPush);
+        bundle.putString("sid", subscribeUniqueId);
+        return bundle;
+    }
+
+    public static GpsSubscribeMsg createByBundle(Bundle bundle) {
+        return new GpsSubscribeMsg(
+			bundle.getString("pkg"),
+			bundle.getInt("subMode"),
+			bundle.getFloat("stepM"),
+			bundle.getInt("type"),
+			bundle.getLong("interval"),
+			bundle.getFloat("distance"),
+			bundle.getBoolean("bgPush"),
+			bundle.getString("sid")
+        );
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeResult.java

@@ -0,0 +1,115 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:25
+ */
+
+import android.os.Bundle;
+import android.os.Parcel;
+import android.os.Parcelable;
+
+public final class GpsSubscribeResult implements Parcelable {
+
+    private final String subscribeUniqueId;
+    private final int resultCode;
+    private final String resultDesc;
+    private final int gpsRunningState;
+    private final long realEffectiveInterval;
+    private final long currentTimeStamp;
+
+    public GpsSubscribeResult(String subscribeUniqueId,
+                              int resultCode,
+                              String resultDesc,
+                              int gpsRunningState,
+                              long realEffectiveInterval,
+                              long currentTimeStamp) {
+        this.subscribeUniqueId = subscribeUniqueId;
+        this.resultCode = resultCode;
+        this.resultDesc = resultDesc;
+        this.gpsRunningState = gpsRunningState;
+        this.realEffectiveInterval = realEffectiveInterval;
+        this.currentTimeStamp = currentTimeStamp;
+    }
+
+    public String getSubscribeUniqueId() {
+        return subscribeUniqueId;
+    }
+
+    public int getResultCode() {
+        return resultCode;
+    }
+
+    public String getResultDesc() {
+        return resultDesc;
+    }
+
+    public int getGpsRunningState() {
+        return gpsRunningState;
+    }
+
+    public long getRealEffectiveInterval() {
+        return realEffectiveInterval;
+    }
+
+    public long getCurrentTimeStamp() {
+        return currentTimeStamp;
+    }
+
+    @Override
+    public int describeContents() {
+        return 0;
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        dest.writeString(subscribeUniqueId);
+        dest.writeInt(resultCode);
+        dest.writeString(resultDesc);
+        dest.writeInt(gpsRunningState);
+        dest.writeLong(realEffectiveInterval);
+        dest.writeLong(currentTimeStamp);
+    }
+
+    public static final Creator<GpsSubscribeResult> CREATOR = new Creator<GpsSubscribeResult>() {
+        @Override
+        public GpsSubscribeResult createFromParcel(Parcel in) {
+            return new GpsSubscribeResult(
+				in.readString(),
+				in.readInt(),
+				in.readString(),
+				in.readInt(),
+				in.readLong(),
+				in.readLong()
+            );
+        }
+
+        @Override
+        public GpsSubscribeResult[] newArray(int size) {
+            return new GpsSubscribeResult[size];
+        }
+    };
+
+    public Bundle convertToBundle() {
+        Bundle bundle = new Bundle();
+        bundle.putString("sid", subscribeUniqueId);
+        bundle.putInt("code", resultCode);
+        bundle.putString("desc", resultDesc);
+        bundle.putInt("gpsState", gpsRunningState);
+        bundle.putLong("realInterval", realEffectiveInterval);
+        bundle.putLong("time", currentTimeStamp);
+        return bundle;
+    }
+
+    public static GpsSubscribeResult createByBundle(Bundle bundle) {
+        return new GpsSubscribeResult(
+			bundle.getString("sid"),
+			bundle.getInt("code"),
+			bundle.getString("desc"),
+			bundle.getInt("gpsState"),
+			bundle.getLong("realInterval"),
+			bundle.getLong("time")
+        );
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/LocationPoint.java

@@ -0,0 +1,37 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+import java.io.Serializable;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:23
+ * 订阅者基准定点坐标
+ * 每次推送成功自动更新
+ */
+public final class LocationPoint implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    private final double latitude;
+    private final double longitude;
+    private final long recordTime;
+
+    public LocationPoint(double latitude, double longitude, long recordTime) {
+        this.latitude = latitude;
+        this.longitude = longitude;
+        this.recordTime = recordTime;
+    }
+
+    public double getLatitude() {
+        return latitude;
+    }
+
+    public double getLongitude() {
+        return longitude;
+    }
+
+    public long getRecordTime() {
+        return recordTime;
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/receiver/GpsSubscribeObserverReceiver.java

@@ -0,0 +1,42 @@
+package cc.winboll.studio.libgpsrelaysentinel.receiver;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:27
+ */
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeResult;
+
+public final class GpsSubscribeObserverReceiver extends BroadcastReceiver {
+
+    private OnSubscribeResultListener listener;
+
+    public void setOnSubscribeResultListener(OnSubscribeResultListener listener){
+        this.listener = listener;
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent.getAction();
+        if(GpsSubscribeConst.ACTION_SUBSCRIBE_CALLBACK.equals(action)){
+            GpsSubscribeResult result = intent.getParcelableExtra("data");
+            if(listener != null && result != null){
+                listener.onResultBack(result);
+            }
+        }
+    }
+
+    public interface OnSubscribeResultListener{
+        void onResultBack(GpsSubscribeResult result);
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/service/GpsSubscribeReceiverService.java

@@ -0,0 +1,39 @@
+package cc.winboll.studio.libgpsrelaysentinel.service;
+
+import android.app.Service;
+import android.content.Intent;
+import android.os.IBinder;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+
+/**
+ * 全局消息接收父类服务
+ * 所有应用内接收服务全部继承此类
+ */
+public abstract class GpsSubscribeReceiverService extends Service {
+
+    public static final String TAG_PARENT = "GpsSubscribeReceiverService";
+
+    //当前绑定的视图订阅SID
+    protected String bindViewSid;
+
+    public void bindControlSid(String sid){
+        this.bindViewSid = sid;
+    }
+
+    /**
+     * 统一接收GPS推送入口
+     */
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config){
+        //父类统一日志溯源
+        LogUtils.d(TAG_PARENT,"【消息溯源】接收视图SID：" + bindViewSid);
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/util/TimeCountUtil.java

@@ -0,0 +1,51 @@
+package cc.winboll.studio.libgpsrelaysentinel.util;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:26
+ */
+
+import android.os.Handler;
+import android.os.Message;
+
+public final class TimeCountUtil {
+
+    private final Handler mHandler;
+    private long totalTime;
+    private boolean isRunning;
+    public static final int COUNT_FINISH = 1001;
+
+    public TimeCountUtil(final OnCountListener listener) {
+        mHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                if(msg.what == COUNT_FINISH){
+                    isRunning = false;
+                    if(listener != null){
+                        listener.onTimeOut();
+                    }
+                }
+            }
+        };
+    }
+
+    public void start(long time){
+        if(isRunning){
+            return;
+        }
+        totalTime = time;
+        isRunning = true;
+        mHandler.sendEmptyMessageDelayed(COUNT_FINISH,totalTime);
+    }
+
+    public void cancel(){
+        mHandler.removeMessages(COUNT_FINISH);
+        isRunning = false;
+    }
+
+    public interface OnCountListener{
+        void onTimeOut();
+    }
+}
+

libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/view/GpsSubscribeControlView.java

@@ -0,0 +1,226 @@
+package cc.winboll.studio.libgpsrelaysentinel.view;
+
+import android.content.Context;
+import android.content.Intent;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.RadioButton;
+import android.widget.RadioGroup;
+import android.widget.Switch;
+import android.widget.TextView;
+
+import cc.winboll.studio.libgpsrelaysentinel.R;
+import cc.winboll.studio.libgpsrelaysentinel.manager.GpsSubscribeManager;
+import cc.winboll.studio.libgpsrelaysentinel.manager.SubscribeLocationManager;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+
+import java.util.UUID;
+
+public final class GpsSubscribeControlView extends LinearLayout {
+
+    //常量抽取
+    private static final long REFRESH_INTERVAL = 600;
+
+    private RadioGroup rgSubscribeMode;
+    private RadioButton rbModeAll;
+    private RadioButton rbModeStep;
+    private EditText etStepMeter;
+    private Switch switchSubscribe;
+    private TextView tvSubscribeSid;
+    private TextView tvSubscribeRecord;
+
+    private String currentSubscribeSid;
+    //一对一专属绑定的接收服务
+    private Class<?> mBindReceiverServiceClazz;
+
+    //final管理器 构造器初始化
+    private final GpsSubscribeManager mSubscribeManager;
+    private final SubscribeLocationManager mLocationManager;
+
+    private final Handler mRefreshHandler = new Handler(Looper.getMainLooper());
+
+
+    public GpsSubscribeControlView(Context context) {
+        super(context);
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationManager = SubscribeLocationManager.getInstance();
+        initView(context);
+    }
+
+    public GpsSubscribeControlView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationManager = SubscribeLocationManager.getInstance();
+        initView(context);
+    }
+
+    private void initView(Context context) {
+        LayoutInflater.from(context).inflate(R.layout.view_gps_subscribe_control, this, true);
+
+        rgSubscribeMode = findViewById(R.id.rg_subscribe_mode);
+        rbModeAll = findViewById(R.id.rb_mode_all);
+        rbModeStep = findViewById(R.id.rb_mode_step);
+        etStepMeter = findViewById(R.id.et_step_meter);
+        switchSubscribe = findViewById(R.id.switch_subscribe);
+        tvSubscribeSid = findViewById(R.id.tv_subscribe_sid);
+        tvSubscribeRecord = findViewById(R.id.tv_subscribe_record);
+
+        initDefaultConfig();
+        initModeSwitch();
+        initSubscribeSwitch();
+        startAutoRefreshRecord();
+    }
+
+    private void initDefaultConfig() {
+        currentSubscribeSid = UUID.randomUUID().toString().substring(0, 16);
+        tvSubscribeSid.setText("订阅SID：" + currentSubscribeSid);
+        rbModeAll.setChecked(true);
+        etStepMeter.setText("10");
+    }
+
+    /**
+     * 外部绑定当前视图专属的接收服务Class
+     */
+    public void bindReceiverService(Class<?> serviceClazz){
+        this.mBindReceiverServiceClazz = serviceClazz;
+    }
+
+    private void initModeSwitch() {
+        rgSubscribeMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(RadioGroup group, int checkedId) {
+					etStepMeter.setVisibility(checkedId == R.id.rb_mode_step ? VISIBLE : GONE);
+				}
+			});
+    }
+
+    private void initSubscribeSwitch() {
+        switchSubscribe.setOnCheckedChangeListener(new android.widget.CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(android.widget.CompoundButton buttonView, boolean isChecked) {
+					if (isChecked) {
+						startSubscribe();
+					} else {
+						stopSubscribe();
+					}
+				}
+			});
+    }
+
+    private void startSubscribe() {
+        int subMode = GpsSubscribeConst.SUB_TYPE_ALL;
+        float stepVal = 10f;
+
+        if (rbModeStep.isChecked()) {
+            subMode = GpsSubscribeConst.SUB_TYPE_STEP_DISTANCE;
+            try {
+                stepVal = Float.parseFloat(etStepMeter.getText().toString().trim());
+            } catch (Exception ignored) {}
+        }
+
+        GpsSubscribeMsg subscribeMsg = new GpsSubscribeMsg(
+			getContext().getPackageName(),
+			subMode,
+			stepVal,
+			GpsSubscribeConst.SUBSCRIBE_TYPE_LOCATION,
+			1000,
+			1f,
+			true,
+			currentSubscribeSid
+        );
+
+        mSubscribeManager.addSubscribe(subscribeMsg);
+        mLocationManager.putSubscribeConfig(currentSubscribeSid, subscribeMsg);
+        mLocationManager.clearPushCount(currentSubscribeSid);
+
+        //开启订阅自动启动专属接收服务
+        if(mBindReceiverServiceClazz != null){
+            Intent startServiceIntent = new Intent(getContext(), mBindReceiverServiceClazz);
+            getContext().startService(startServiceIntent);
+        }
+    }
+
+    private void stopSubscribe() {
+        mSubscribeManager.removeSubscribe(currentSubscribeSid);
+        mLocationManager.removeSubscribe(currentSubscribeSid);
+        tvSubscribeRecord.setText("状态：未订阅");
+
+        //关闭订阅 同步停止专属接收服务
+        if(mBindReceiverServiceClazz != null){
+            Intent stopServiceIntent = new Intent(getContext(), mBindReceiverServiceClazz);
+            getContext().stopService(stopServiceIntent);
+        }
+    }
+
+    private void startAutoRefreshRecord() {
+        mRefreshHandler.postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					refreshRecordInfo();
+					mRefreshHandler.postDelayed(this, REFRESH_INTERVAL);
+				}
+			}, REFRESH_INTERVAL);
+    }
+
+    private void refreshRecordInfo() {
+        if (!switchSubscribe.isChecked()) {
+            tvSubscribeRecord.setText("状态：空闲未订阅");
+            return;
+        }
+
+        GpsSubscribeMsg config = mLocationManager.getSubscribeConfig(currentSubscribeSid);
+        LocationPoint lastPoint = mLocationManager.getLastPoint(currentSubscribeSid);
+
+        if (config == null) {
+            tvSubscribeRecord.setText("状态：已订阅｜等待管理器加载");
+            return;
+        }
+
+        String modeText = config.getSubscribeMode() == GpsSubscribeConst.SUB_TYPE_ALL
+			? "全量订阅" : "步长订阅";
+
+        int realPushCount = mLocationManager.getPushCount(currentSubscribeSid);
+
+        StringBuilder record = new StringBuilder();
+        record.append("【订阅实时数据表】\n");
+        record.append("订阅模式：").append(modeText).append("\n");
+        record.append("步长阈值：").append(config.getStepDistanceM()).append(" 米\n");
+
+        if(lastPoint != null){
+            record.append("基准定点：").append(lastPoint.getLatitude()).append(" , ").append(lastPoint.getLongitude()).append("\n");
+        }else{
+            record.append("基准定点：等待首次定位建立\n");
+        }
+
+        record.append("真实推送次数：").append(realPushCount).append(" 次");
+
+        tvSubscribeRecord.setText(record);
+    }
+
+    public String getCurrentSid() {
+        return currentSubscribeSid;
+    }
+
+    public boolean isSubscribeOpen() {
+        return switchSubscribe.isChecked();
+    }
+
+    /**
+     * 视图销毁：强制停止订阅 + 停止服务 + 清空刷新任务
+     */
+    @Override
+    protected void onDetachedFromWindow() {
+        if(switchSubscribe.isChecked()){
+            switchSubscribe.setChecked(false);
+        }
+        mRefreshHandler.removeCallbacksAndMessages(null);
+        super.onDetachedFromWindow();
+    }
+}
+

libgpsrelaysentinel/src/main/res/layout/view_gps_subscribe_control.xml

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="14dp"
+    android:layout_marginVertical="6dp"
+    android:background="#282828"
+    android:clipToPadding="false">
+
+    <!-- SID标识 -->
+    <TextView
+        android:id="@+id/tv_subscribe_sid"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textColor="#999999"
+        android:textSize="11sp"/>
+
+    <!-- 订阅模式选择 -->
+    <RadioGroup
+        android:id="@+id/rg_subscribe_mode"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:layout_marginTop="8dp">
+
+        <RadioButton
+            android:id="@+id/rb_mode_all"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="全量订阅"
+            android:textColor="#FFFFFF"/>
+
+        <RadioButton
+            android:id="@+id/rb_mode_step"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="步长订阅"
+            android:layout_marginStart="18dp"
+            android:textColor="#FFFFFF"/>
+    </RadioGroup>
+
+    <!-- 步长输入 -->
+    <EditText
+        android:id="@+id/et_step_meter"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="移动阈值(米)"
+        android:inputType="numberDecimal"
+        android:text="10"
+        android:visibility="gone"
+        android:textColor="#ffffff"
+        android:textColorHint="#666666"
+        android:layout_marginTop="8dp"/>
+
+    <!-- 订阅开关 -->
+    <Switch
+        android:id="@+id/switch_subscribe"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="开启独立订阅"
+        android:textColor="#EEEEEE"
+        android:layout_marginTop="10dp"/>
+
+    <!-- 分割线 -->
+    <View
+        android:layout_width="match_parent"
+        android:layout_height="1px"
+        android:background="#444444"
+        android:layout_marginTop="12dp"/>
+
+    <!-- 订阅数据记录表【ID完全对应源码 tv_subscribe_record】 -->
+    <TextView
+        android:id="@+id/tv_subscribe_record"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textColor="#88EE88"
+        android:textSize="10sp"
+        android:layout_marginTop="10dp"
+        android:gravity="start"/>
+
+</LinearLayout>
+

libgpsrelaysentinel/src/main/res/values-v21/styles.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Material.Light">
+	</style>
+</resources>

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

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libdebugtemp</string>
+    <string name="hello_world">Hello world!</string>
+    <string name="text_libraryactivity">LibraryActivity</string>
+
+</resources>

libgpsrelaysentinel/src/main/res/values/styles.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Holo.Light">
+	</style>
+</resources>

settings.gradle-demo

@@ -77,3 +77,8 @@
 // RegExpUtils 项目编译设置
 //include ':regexputils'
 //rootProject.name = "regexputils"
+
+// GPSRelaySentinel 项目编译设置
+//include ':gpsrelaysentinel'
+//include ':libgpsrelaysentinel'
+//rootProject.name = "gpsrelaysentinel"