Skip to content

7. 第 6 章 - 结论与后续步骤

7.1. 已构建的内容

本文档把 [RdvMedecins] 应用的核心功能和身份验证从 2014 年的原始文档移植到了原生 Android 应用:

  • 一个完整的 [NestJS] 服务器(与课程的 Angular、React、Vue.js 和 Flutter 版本相同,已在第 2 章中安装并测试,但此处不涉及其代码),公开与原 Spring 4 服务器相同的 JSON 业务路由,全部受 JWT 令牌保护;
  • 一个使用 [Kotlin] 和 [Jetpack Compose] (Material 3)编写的 Android 客户端,提供与原 AngularJS 1.x 客户端相同的功能——选择医生和日期、查看日程、预订和取消预约——另外还有登录屏幕、持久会话([SharedPreferences])、根据已登录用户角色定制的界面,以及在法语和英语之间切换界面的能力([TranslationsService],使用课程其他版本的字典)。

该客户端逐个文件地复刻了 Flutter 客户端的架构。最显著的差异源于平台而不是语言:屏幕旋转时 Activity 会被重建,这需要 [ViewModel] 和 [rememberSaveable];主线程上禁止网络访问,这需要协程;以及清单中的设置(权限 [INTERNET] 和明文 HTTP)。在界面方面,Compose 使代码比 Flutter 更短:用函数而不是类,用自动被观察的状态而不是 [setState(...)] 和 [notifyListeners()]。

7.2. 仍不在范围内或有待处理的内容

7.2.1. 法语/英语国际化——本文档已涵盖

原始文档提出使用 angular-translate 库在法语和英语之间切换界面。本移植版本使用 [TranslationsService](见第 4 章)以及来自课程其他版本的字典 [fr.json]/[en.json] 实现了这一功能,这些字典嵌入在应用的 [assets/] 文件夹中。与前几个版本一样,它可以动态切换语言,无需重启应用。

7.2.2. 客户端的“调试”模式——有意排除在范围之外

原始文档包含一种技术性的显示模式,可以访问当前视图的原始模板。本移植版本没有重新实现它:如今 Android Studio 在应用之外提供了功能全面得多的工具——调试器、布局检查器([Layout Inspector],它显示 @Composable 函数树、它们的参数以及重组次数)和日志([Logcat])。

7.2.3. 人为网络延迟——推迟

原始文档允许在每次服务器响应之前设置一个人为延迟,以观察界面在慢速网络下的行为。本移植版本目前还没有与之对应的功能。不过,Android 模拟器可以模拟慢速网络([Extended Controls / Cellular / Network type])。

7.3. 关于本文档所用方法的说明

本文档中描述的客户端是由 Claude 本人在审阅者计算机上的 Android 模拟器中,经审阅者同意后编译并运行的:每项功能都经过了测试(使用两种角色登录、登录失败、选择医生和日期、预订、取消、切换语言、登出、屏幕旋转),第 4 章中的截图就是在这些测试中截取的。这些测试发现了两个问题,已予以纠正并记录在第 5 章中:在这台计算机上地址 [10.0.2.2] 无法访问,以及手机窄屏幕上有一个按钮被截断。

7.4. 现在就可以进一步深入的方向

  • 添加一个预约详情屏幕,使用 [Navigation Compose] 库来探索屏幕导航;
  • 在服务器调用期间显示加载指示器([CircularProgressIndicator]),方法是添加一个 [inProgress] 状态(位于 [AppViewModel] 中);
  • 用 [DataStore] 替换 [SharedPreferences],这是目前推荐的完全异步的存储 API([suspend] 函数和 [Flow]);
  • 编写测试:为 [decodeResponse(...)] 或 [TranslationsService.t(...)] 编写单元测试,然后使用 [compose-ui-test] 库编写界面测试;
  • 查看每个客户端文件夹中的 README 文件:每个文件都概述了其中所含文件的用途。