JOJO
84c40e505e
- 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>
46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 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 条件设置）。
|