# Android 64 位客户端重建策略

新版工程位于 `xunqiu-android64/`，包名为 `com.playlab.xunqiu64`。它不是旧版工程的直接升级，而是一个轻量 64 位客户端，用于复用旧服务端接口并优先恢复核心业务闭环。

## 重建目标

- 不引入旧工程 32 位 native so。
- 使用现代 Android 构建工具链。
- 复用旧服务端账号和业务接口。
- 先打通登录、动态、短视频、日程、球队、球场、球币等路径。
- 通过阶段计划、测试矩阵和 APK 归档控制风险。

## 工程结构

新版是单模块 Android 工程：

- `MainActivity.java`：登录、导航、图片选择回调、会话管理和公共 Host 能力。
- `screen/`：首页、社区、动态、短视频、日程、赛事、球场、球币、个人页等页面。
- `net/ApiClient.java`：旧服务端接口集中封装。
- `net/AuthSession.java`、`LoginResult.java`：登录态和登录结果。
- `util/`：异步执行、UI 工具、摘要算法和内容运营排序。

## 接口复用

新版没有要求服务端先重写接口，而是在客户端集中适配旧接口：

- 登录接口解析旧服务端返回的 userId/token。
- 列表、详情、点赞、评论、发布等接口集中在 `ApiClient`。
- 对字段命名不一致的返回使用 fallback。
- 对媒体 URL 做归一化，减少旧域名和相对路径带来的加载失败。

## 能力分级

真实接入优先级：

- 登录、动态、评论、图片发布。
- 短视频上传、列表、播放、点赞、评论。
- 日程创建、报名、请假和打卡。
- 球队信息、队员、邀请码、临时队员和队费读取。

安全预览或边界能力：

- 支付。
- IM。
- 推送。
- 地图。
- 分享。
- 真实兑换、赛事创建、比分提交等高副作用能力。

这种分级能避免迁移早期误触资金、消息、推送和外部 SDK。

## 阶段验证

项目文档中记录了：

- 本地 Java 编译验证。
- 模拟器启动和页面打开验收。
- 文字动态、图片动态、评论、创建活动、报名、打卡等写入验收。
- 阶段 APK 包名、SHA-256 和功能范围。