agent-Specialization/android-webview-app
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

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.comApp 无法连接真实服务。

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 条件设置)。