Windows 构建与开发指南
约 379 字大约 1 分钟
2026-03-20
背景与目标
这篇文档帮助你在 Windows 上完成跑通 Android App 的构建与测试以及文档的构建。
2. 相关目录与工具
SleepIn/
├─ gradlew(.bat) # Gradle Wrapper 入口
├─ app/ # Android 应用模块
│ ├─ src/main/
│ └─ schemas/ # Room schema 输出
└─ docs/SleepIn-Docs/
├─ package.json # 文档依赖与脚本
└─ docs/ # Markdown 文档开发工具建议:
- Android Studio(含 SDK 与 Emulator)
- JDK 17(项目使用 Java 17 toolchain)
- Node.js(用于文档站点)
App 构建流程
在项目根目录执行:
.\gradlew assembleDebug- 作用:构建 Debug 版的 APK。 完了之后,一般编译好的 APK 会在
app/build/outputs/apk/debug/。
或者如果你使用的是 Android Studio,你也可以选择顶部菜单的 Build > Generate App Bundles or APKs > Generate APK 来构建。
然后执行基础测试:
.\gradlew test- 作用:运行 JVM 单元测试,验证 UseCase、Repository 纯逻辑、工具函数等。
你可以在 Android Studio 的 Device Manager 中启动一个模拟器,或者连接一个物理设备。 当你已经连接了你的设备或者启动了一个模拟器,然后可以再点击顶部工具栏的绿色运行按钮, 在你链接的设备上安装并运行应用。
文档站点本地调试
在 docs/SleepIn-Docs 目录执行:
npm install
npm run docs:devdocs:dev用于本地热更新预览。
提交前建议再跑一次构建检查:
npm run docs:build- 作用:检查构建错误和链接问题。
常见问题与排错
未知
