14. 附录
[Android Studio] 的安装、模拟器以及手机的设置在“搭建开发环境”一章中描述。这些附录是对该章的补充。
14.1. 使用 Android Studio
- [File / Open]:打开一个项目([examples_kotlin]、[rdvmedecins_kotlin]);[Gradle] 会对它进行“同步”(下载库);
- [Run] 按钮(或 Shift-F10)在工具栏中选定的设备上安装并启动应用;[Debug](Shift-F9)使用调试器(断点、变量)启动应用;
- [Apply Changes] 在可能的情况下,无需重启就替换正在运行的应用的代码;
- 对无参数的 [@Composable] 函数使用注解 [@Preview],可以在编辑器中显示它,而无需模拟器;
- “Layout Inspector”([Tools / Layout Inspector])显示当前屏幕的组件树以及每个组件的重组次数;“App Inspection”显示网络请求([OkHttp])和数据库;
- 在出错处按 Alt-Enter 会给出修正建议(添加 [import] 等);Ctrl-Alt-L 会重新格式化文件;
- 命令行:[adb devices](已连接的设备)、[adb reverse tcp:8080 tcp:8080](设备上的 8080 端口连接到电脑的端口)、[adb install file.apk](安装应用)、[adb logcat](手机日志;在 [Android Studio] 中则是 [Logcat] 窗口)、[emulator -list-avds],然后是 [emulator -avd Pixel_8](不通过 [Android Studio] 启动模拟器)。
14.2. 本文档的截图
截图是由插桩测试自动生成的:[JUnit] 测试在模拟器上运行(与应用处于同一进程内),并通过 [Compose] 测试库来控制它(按文本查找组件、点按它、在其中输入等)。它们位于两个项目的 [app/src/androidTest] 文件夹中:[Captures.kt](每个示例一个测试函数)和 [CaseStudyCaptures.kt](对应用的完整演练)。节选:
脚本 [tools/captures_examples.bat] 和 [tools/captures_case_study.bat] 会在必要时启动模拟器,编译并安装应用及其测试,设置模拟器(语言、处于“演示模式”的状态栏),运行测试([adb shell am instrument]),然后取回图像。必须同时启动 JSON 服务器并设置 [CAPTCHA_TEST=test]。
14.3. 安装 Node.js
[Node.js] 可从 nodejs.org 下载:选择 LTS(长期支持)版本。[Windows] 安装程序也会安装 [npm]。只有 JSON 服务器才需要它。在控制台中验证安装:
14.4. 使用 Laragon 安装 MySQL
JSON 服务器需要 [MySQL] (或 [MariaDB])。[Laragon] (laragon.org)会在 [Windows] 上安装一个开箱即用的实例,并附带 [HeidiSQL] 管理工具。安装之后:
- “Start All”按钮会在 3306 端口启动 [MySQL] 服务器;
- 用户 [root] 没有密码:这是服务器 [.env.example] 文件中的默认值;
- 在 [HeidiSQL] 中(“Database”按钮),菜单项 File / Run SQL 会运行 [database/dbrdvmedecins2.sql] 脚本。
对于 [Linux] 或 [macOS],请使用系统的包管理器安装 [MySQL] 或 [MariaDB] ,并使用命令行客户端运行该脚本:[mysql -u root -p < database/dbrdvmedecins2.sql]。
14.5. 安装 curl
[curl] 已包含在 [Windows] 10 和 11 版本、[macOS] 以及大多数 [Linux] 发行版中。检查它的版本:
本文档中使用的选项 [--json] 自 7.82 版(2022 年)起可用。如果你使用的是较旧的版本,请把 [--json @file] 替换为 [-H "Content-Type: application/json" -d @file],或者从 curl.se 开始安装较新的版本。
在 [PowerShell] 中,必须输入 [curl.exe],而不是 [curl]:在 [PowerShell] 中,[curl] 是另一个命令([Invoke-WebRequest])的别名,该命令不包含 [curl] 的那些选项。命令提示符([cmd])没有这个问题。