14. 附录
14.1. 安装 Flutter
[Flutter] SDK 可以下载自docs.flutter.dev(选择[Windows],然后选择[Android])。它是一个简单的压缩文件夹,请将其解压到一个不含空格或重音字符的文件夹中(例如 [C:\dev\flutter]),然后将其子文件夹[bin] 添加到用户的环境变量[Path]中。[Dart] SDK 已包含在内。请在新的控制台中验证安装:
[flutter doctor] 会检查[Flutter] 所需的一切:SDK、[Android]及其许可协议、[Chrome]、[Visual Studio] (用于[Windows]应用)、已连接的设备以及网络访问。如果一切正常,每一行前面都有一个对勾[√] ,否则是一个叉号[X] 或感叹号[!] ,并在下方列出该怎么做的说明。[flutter doctor -v] 会提供详细信息(版本、路径)。
“Visual Studio”这一行只适用于[Windows]应用(示例的[windows/] 文件夹):如果你只面向移动端和 Web,它可能一直处于报错状态。
在[Windows]中,使用原生代码包([shared_preferences]……)的项目需要启用系统的“开发者模式”:[flutter pub get] 会给出提示(“Building with plugins requires symlink support”)。你可以在“设置 / 系统 / 开发者选项”中启用它(命令[start ms-settings:developers])。
14.2. 安装 Android Studio 和模拟器
[Android Studio] 可从developer.android.com/studio下载。它不用于编写代码,而是用于安装 [Android] SDK 并创建模拟器:
- 首次启动时,向导会安装 [Android] SDK;
- “More Actions”菜单 / SDK Manager,SDK Tools 选项卡:勾选“Android SDK Command-line Tools”,这是[Flutter] 所需要的;
- 在控制台中运行:[flutter doctor --android-licenses],并接受许可协议;
- “More Actions / Virtual Device Manager”菜单:使用较新的系统映像创建一部虚拟手机(例如“Pixel”)。点击 ▶ 按钮启动它;[flutter devices] 随后会检测到它,名称为[emulator-5554]。你也可以不打开[Android Studio]而启动它:[flutter emulators] 会列出各个模拟器,而[flutter emulators --launch <name>] 会启动其中一个。
对于真机:在“设置 / 关于手机”中,连续点击“版本号”七次,就会出现“开发者选项”,你可以在其中启用“USB 调试”。连接到计算机后,手机会要求你授权该计算机;[flutter devices] 随后会检测到它。
14.3. 安装 Visual Studio Code
[Visual Studio Code] 可从 code.visualstudio.com 下载。在“扩展”面板(Ctrl-Shift-X)中,安装[Flutter]扩展(来自[Dart Code]),它还会安装[Dart]扩展。它们提供:
- 代码补全、输入时的代码验证(使用[analysis_options.yaml]中的规则)、跳转到组件(Widget)或类的定义,以及在整个项目范围内重命名;
- 保存时自动格式化代码([dart format]);
- 设备选择,位于窗口右下角(或使用“Flutter: Select Device”命令);
- 通过 F5 启动(调试:断点、变量);每次保存文件时,应用都会即时重新加载;
- 针对组件(Widget)的操作(在组件上按 Ctrl-.):“Wrap with Padding”“Wrap with Column”“Extract Widget”等——对重新组织组件树非常有用。
要用 F5 运行某个示例,请在按 F5 之前打开它的[main.dart] 文件(或创建名为[.vscode/launch.json]的文件)。通过“文件 / 打开文件夹”菜单打开项目(例如[examples_flutter]文件夹),并通过“终端 / 新建终端”菜单打开控制台。
14.4. Flutter 工具 DevTools
[Flutter DevTools] 随 SDK 一起提供。应用运行期间,[flutter run] 会显示它的地址(“The Flutter DevTools debugger and profiler... is available at: http://127.0.0.1:9101... ”);在[VS Code]中,“Flutter: Open DevTools”命令会在编辑器中打开它。其最有用的选项卡:
- “Flutter Inspector”:界面的组件树,以及每个组件的属性。“Select Widget Mode”让你在手机上点击一个元素,就能在树中找到它对应的组件;“Show Guidelines”会绘制边距和对齐线。这个工具可以回答这样的问题:“这个组件为什么不在正确的位置?”;
- “Performance”和“CPU Profiler”:渲染和绘制每一帧所花的时间,用于找出动画卡顿的原因;
- “Network”:应用的 HTTP 请求,包括其头和请求体;在这里你可以看到令牌 Cookie 被发送和返回;
- “Logging”:应用输出的内容([debugPrint])。
14.5. 安装 Node.js
[Node.js] 可从 nodejs.org 下载:选择 LTS(长期支持)版本。[Windows]安装程序还会安装[npm]。只有 JSON 服务器需要它。在控制台中验证安装:
14.6. 使用 Laragon 安装 MySQL
JSON 服务器需要[MySQL] (或[MariaDB])。[Laragon] (laragon.org)在[Windows]下安装其中一个,开箱即用,并带有[HeidiSQL]管理工具。安装之后:
- “Start All”按钮会在 3306 端口启动[MySQL]服务器;
- 用户[root] 没有密码:这些是服务器的[.env.example]文件中的默认值;
- 在[HeidiSQL] 中(“Database”按钮),通过“文件 / 运行 SQL 文件”菜单项运行[database/dbrdvmedecins2.sql]脚本。
在[Linux] 或[macOS]中,使用系统的包管理器安装[MySQL] 或[MariaDB] ,并使用命令行客户端运行该脚本:[mysql -u root -p < database/dbrdvmedecins2.sql]。
14.7. 安装 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])没有这个问题。