docs: 记录 Android 包名修改设计

docs/superpowers/specs/2026-07-17-android-package-name-design.md

+# Android 包名修改设计
+
+## 目标
+
+将 Android 应用包名统一为 `com.zijin.book.flutter_book`，确保 Gradle 配置、Android namespace 与启动 Activity 的 Java 包路径一致。
+
+## 范围
+
+- 将 `android/app/build.gradle` 中的 `applicationId` 和 `namespace` 修改为 `com.zijin.book.flutter_book`。
+- 将 `MainActivity.java` 的 package 声明修改为 `com.zijin.book.flutter_book`。
+- 将 `MainActivity.java` 移至与包声明匹配的目录 `android/app/src/main/java/com/zijin/book/flutter_book/`。
+- 保留 Android Manifest 中的相对 Activity 名 `.MainActivity`。
+
+以下内容不在本次修改范围内：
+
+- iOS Bundle Identifier。
+- 内购商品 ID。
+- Flutter 包名 `flutter_book`。
+- 业务代码、依赖版本和构建参数。
+
+## 兼容性与风险
+
+Android 会把新的 `applicationId` 视为与旧包名不同的应用。如果设备或应用商店中使用的是其他包名，新包无法作为原应用的直接升级包。此次修改按明确指定的目标包名执行，不增加兼容迁移逻辑。
+
+源码目录、Java package、Gradle namespace 和 applicationId 必须保持一致，以避免启动 Activity 无法解析或构建产物使用错误标识。
+
+## 验证
+
+1. 搜索 Android 有效源码，确认旧值 `com.zijing.book.flutterBook` 不再存在。
+2. 检查目标值同时出现在 `applicationId`、`namespace` 和 `MainActivity` package 声明中。
+3. 运行 Android debug 构建或等价 Gradle 编译任务，确认启动 Activity 能被正确编译和打包。
+