Main

.github/workflows/build-check.yml → .github/workflows/build-action.yml

@@ -1,5 +1,5 @@
 # name 字段用于指定 Workflow 的名字
-name: Build Check
+name: build and get apk
 
 # 在 on 字段下列举触发条件（事件），可以有多种
 on:
@@ -26,7 +26,7 @@ jobs:
   build:
     # 该 job 运行的系统环境，支持 ubuntu 、windows、macOS
     runs-on: ubuntu-latest
-    
+
     # 该 job 的一系列步骤。每个以“-”开头
     steps:
       # 检出我们的源代码
@@ -39,17 +39,30 @@ jobs:
           java-version: '17'
           distribution: 'adopt'
           cache: gradle
+
       # 创建 local.properties 文件
       - name: Create local.properties
         run: |
           cat << EOF > local.properties
           MAPS_API_KEY=${{ secrets.MAPS_API_KEY }}
           MAPS_SAFE_CODE=${{ secrets.MAPS_SAFE_CODE }}
           EOF
+
       # 给 gradlew 增加执行权限
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
-      
-      # 启动构建
+
+      # 启动构建（检查项目是否能编译通过）
       - name: Build with Gradle
         run: ./gradlew build
+
+      # 构建 Debug APK（用于下载测试）
+      - name: Build Debug APK
+        run: ./gradlew assembleDebug
+
+      # 上传 Debug APK 作为可下载的工件
+      - name: Upload Debug APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: app-debug
+          path: app/build/outputs/apk/debug/*.apk

.gitignore

@@ -47,3 +47,18 @@ captures/
 
 # Google Services (e.g. APIs or Firebase)
 google-services.json
+
+# Eclipse / Buildship (project uses Gradle; these are IDE-generated)
+.project
+.classpath
+.settings/
+
+# VS Code
+.vscode/
+
+# Java heap dumps
+*.hprof
+
+# OS files
+.DS_Store
+Thumbs.db

README.md

@@ -1,6 +1,3 @@
-<p align="center">
-<img src="./docs/images/LOGO.png" height="80"/>
-</p>
 
 <div align="center">
 
@@ -20,53 +17,51 @@
 影梭 - 用于 Android 8.0+ 的无需 ROOT 权限的虚拟定位 APP
 </div>
 
-## 简介
-&emsp;&emsp;影梭是一个基于 Android 调试 API + 百度地图及定位 SDK 实现的安卓定位修改工具，并且同时实现了一个可以自由控制移动的摇杆。使用影梭，不需要 ROOT 权限就可以随意修改自己的当前位置以及模拟移动。
-
-1. 源码仓库：[Github](https://github.com/ZCShou/GoGoGo)（推荐）、[Gitee](https://gitee.com/itexp/gogogo)（镜像）
-2. 下载地址：[Github](https://github.com/ZCShou/GoGoGo/releases)（推荐）、[Gitee](https://gitee.com/itexp/gogogo/releases)（镜像）
+## 特别鸣谢ZCShou
 
-## 警告一
-&emsp;&emsp;**最近，有网友直接白嫖影梭后改名为标枪定位，然后添加广告（除了加广告，功能没有任何改变），但是，没有按照 GPLv3 协议的要求进行开源（我已经联系过该网友进了提醒，但并没有收到回复），在此提醒：**
-1. **开源 ≠ 白嫖，请遵循开源协议**
-2. **GPL 的法律效力在国内相关诉讼案例很多，请自行搜索，权衡利弊。影梭保留追究相关侵权人员法律责任的所有权利！**
-3. **开源不易，且行且珍惜**
+## 警告 有任何问题请直接提交issue 或是删除 或是修改 禁止商用行为
 
-## 警告二
-&emsp;&emsp;**最近，有很多人将影梭用在校园运动类 APP（包括但不限于闪动校园、TakeTwo、运动世界校园等）中作弊，开发者也收到了很多人提问为何影梭定位并不起作用或者寻求对影梭的改进，在此提醒：**
-1. **影梭不支持任何校园运动类 APP 的作弊行为**
-2. **影梭开发者也不赞同采用任何形式在校园运动中作弊**
+## 简介
+&emsp;&emsp;影梭是一个基于 Android 调试 API实现的安卓定位修改工具，并且同时实现了一个可以自由控制移动的摇杆。使用影梭，不需要 ROOT 权限就可以随意修改自己的当前位置以及模拟移动。
 
-## 背景
-&emsp;&emsp;之前在玩一款 VR 游戏：一起来捉妖。为了省事，就想有没有可以更改位置的 APP。经过一番摸索发现确实有不少可以修改位置的 APP。但是，绝大多数这种 APP 都是收费的，而且贼贵！
 
-&emsp;&emsp;我比较感兴趣的是这样的技术是如何实现的，因此，决定研究研究自己写一个！现在游戏已经弃坑了，但是技术不能丢。因此，将研究结果开源出来方便大家一起学习！但是请注意（重要的事情说三遍！否则后果自负）：
+## 个人Fork原因及背景
+&emsp;&emsp;将影梭用在校园运动跑步类app（步道乐跑 为本人学校使用）
 
-1. 该 APP 仅仅是为了学习 Android + 百度地图的实现方法，请勿用于游戏作弊！
-2. 该 APP 仅仅是为了学习 Android + 百度地图的实现方法，请勿用于游戏作弊！
-3. 该 APP 仅仅是为了学习 Android + 百度地图的实现方法，请勿用于游戏作弊！
+&emsp;&emsp;原本的那个没有脚本 用起来好累 我就自己借用工具进行了修改
 
 ## 功能
 1. 定位修改
 2. 摇杆控制移动
 3. 历史记录
 4. 位置搜索
 5. 直接输入坐标
+6. 脚本模式（按脚本预设自动移动）
+
+## 脚本模式
+&emsp;&emsp;脚本模式可以先把一串“带移动状态的位置”写成脚本（走 / 跑 / 骑），启动后模拟位置就会按脚本自动移动，不需要手动摇杆。
 
-## 截图
-![joystick.jpg](./docs/images/joystick.jpg)
-![search_history.jpg](./docs/images/search_history.jpg)
-![map.jpg](./docs/images/map.jpg)
+**脚本格式**：一行一个路点，`状态 经度 纬度 [速度] [停留秒数]`，`#` 或 `//` 开头为注释行。
+
+```
+# 先步行，再跑步，最后骑车绕一圈
+walk 116.397 39.908          # 不写速度时使用“设置”里的步行速度
+run  116.401 39.910 4.5      # 跑步，4.5 米/秒
+bike 116.405 39.912 20km/h   # 骑行，也可以写 km/h
+walk 116.410 39.910 1.2 10   # 到达后原地停留 10 秒
+```
+
+1. 状态支持 `步行/跑步/骑行`（`walk/run/bike`），也可以写 `速度4.5`、`停留10` 这类标签形式；
+2. 坐标系可选 `GPS(WGS-84)` 与 `BD09`，两套坐标的值域重叠、无法自动识别，所以需要自己选对；
+3. 每个脚本可以单独设置“单次跑完停止”或者“循环”；
+4. 编辑页支持直接粘贴经纬度，也可以点地图选点（按当前选中的状态插入到光标处）。
 
 ## 用法
 1. 下载 APK 直接安装
 2. 启动影梭，赋予相关权限
 3. 单击地图位置，然后点击启动按钮
 
-## 文档
-&emsp;&emsp;由于本人并不是做移动开发的，很多功能代码写的都比较差。我也第一次写  Android APP，目前还处在学习中。。。此外，就一个简单的 APP，应该也不需要啥文档，开发过程中遇到的一些问题，我一般都会记录在个人博客中，具体参见：https://blog.csdn.net/zcshoucsdn/category_10559121.html
 
-&emsp;&emsp;如果有疑问可以直接搜索 ISSUE 或者 在上面直接提交问题。
 
 ## 参考
 &emsp;&emsp;由于本人也是个新手，纯属业余瞎搞，因此，在写影梭的过程中，参考了很多网友分享的技术文章、示例代码等。包括但不限于以下列出的几个：
@@ -85,9 +80,6 @@ Q：为何定位不是很稳定，偶尔会飘回真实位置？
 
 A：这是是由于实现原理导致的，Android 调试 API 固有的问题。确切的说，应该是由于手机本身还开启了其他定位方式（例如，基站定位、wifi定位等）导致的
 
-Q：是否支持鸿蒙系统？
-
-A：经过测试，影梭可以在鸿蒙系统上正常运行。
 
 Q：为何在微信等腾讯系应用上定位不起作用？