JOJO/agent-Specialization
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
main
agent-Specialization/android-webview-app
History
JOJO 84c40e505e feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 
- HOME_URL 改为构建期注入（BuildConfig）：-P 参数 > local.properties > 环境变量 > 占位符
- network_security_config.xml 删除冗余 domain-config（base-config 已全局禁明文）
- README 重写：移除真实域名，补充注入方式说明
- app_name 更名为 Astrion；链接外跳系统浏览器（1.0.42）+ 1.0.43 版本
- AGENTS.md §8 补充版本检测链路说明；.gitignore 解除 android-webview-app 排除

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
2026-09-02 07:48:36 +08:00
..
app feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
gradle/wrapper feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
.gitignore feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
APP_CHANGELOG.md feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
build.gradle.kts feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
gradle.properties feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
gradlew feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
gradlew.bat feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
README.md feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00
settings.gradle.kts feat(android): 恢复 app 源码追踪——域名构建期注入脱敏 + 应用更名 Astrion 2026-09-02 07:48:36 +08:00

README.md

Astrion Android WebView 壳应用

这个目录是一个最小可用的 Android APK 壳工程：

  • 后端仍运行在你的服务器
  • APK 只承载 WebView 前端

1) 打开工程

Android Studio -> Open -> 选择 android-webview-app。

首次打开会自动下载 Gradle 依赖（需要联网）。

2) 配置后端地址（必须）

仓库代码中不包含真实后端域名，构建前需要通过以下任一方式注入（优先级从高到低）：

  1. 命令行参数：./gradlew assembleRelease -PHOME_URL=https://your-server.example.com
  2. local.properties（本机文件，不纳入版本控制）：添加一行 HOME_URL=https://your-server.example.com
  3. 环境变量：export HOME_URL=https://your-server.example.com

不配置则使用占位地址 https://agent.example.com，App 无法连接真实服务。

3) 可改项

  • 应用名：app/src/main/res/values/strings.xml
  • 后端地址：见上文「配置后端地址」，最终编译进 BuildConfig.HOME_URL

4) 调试打包

  • 连接手机/模拟器后，点击 Run
  • 生成 release APK：
    • 配置签名环境变量 ANDROID_KEYSTORE_PATH / ANDROID_KEYSTORE_PASSWORD / ANDROID_KEY_ALIAS / ANDROID_KEY_PASSWORD
    • ./gradlew assembleRelease

5) 已处理能力

  • JS / DOM Storage 已开启
  • Cookie 已开启
  • 文件上传 (<input type=file>) 已支持
  • 物理返回键支持网页回退
  • 外部链接自动跳转系统浏览器打开

6) Nginx 建议

如后续出现 WebSocket 不稳定，可把 Connection 'upgrade' 改为官方 map 写法（按 upgrade 条件设置）。