Flutter 快速入门0-环境配置

# 精简步骤

- 下载 Android Studio 并安装。

- 打开 AS 安装 Flutter 插件和 Dart 插件。

- 初始化 Flutter 项目，选择将要构建的对象平台（很重要），选择了对应的平台，则初始化完的项目才能针对对应的平台中构建项目和启动调试，比如未勾选 Web 则后续无法在 Web 中启动。

- 找到 ` AVD Manager` 并新建设备 `AVD（Android Virtual Device）`，比如 Android 平台的 Pixel 设备，选定分辨率和 `Android API Level`，比如 `R（Android 11）`。

- 在启动栏的设备选择中，点击刷新（很重要），否则缓存会导致新建的设备不出现。

- 快捷键 `Ctrl + Alt + S` 在设置中找到 `Android SDK`，确认以下两点：

  - 需要启动的 AVD 对应版本的的 `Android API Level` SDK 是否已经安装。

  - 是否完整安装了 `Android Emulator` SDK。

# 依赖检查

- 打开 Terminal 并执行 `flutter doctor` 检查。

- 可能会出现授权错误： `Android license status unknown`，按照 Flutter 官方文档使用 `flutter doctor --android-licenses` 命令授权可能会报错，那么还是 `Ctrl + Alt + S` 在设置中找到 `Android SDK > SDK Tools > Android SDK Command-lines Tools(lasted)` 并完整安装即可。

- 再运行 `flutter doctor` 应该可以看到此条检查已通过。

- 针对 `Visual Studio` 的安装检查不用管，除非初始新建 Flutter 项目时选择了构建对象平台是 Windows 才需要安装此工具。

# 注意事项

- 第一次构建到 Android 平台速度会十分缓慢，需要耐心等待。

- 构建到 Web 平台相对 Android 会更快一些。

- 尝试使用同一个 AVD 配置重复启动模拟器的话，会默认以气泡的形式抛出以下异常。

```

INFO | Android emulator version 31.3.10.0 (build_id 8807927) (CL:N/A)

emulator:

    INFO: Found systemPath C:\Users\summit\AppData\Local\Android\Sdk\system-images\android-30\google_apis\x86\

emulator:

    INFO: Found systemPath C:\Users\summit\AppData\Local\Android\Sdk\system-images\android-30\google_apis\x86\

    WARNING | unexpected system image feature string, emulator might not function correctly, please try updating the emulator.

    ERROR | Running multiple emulators with the same AVD

    ERROR | is an experimental feature.

    ERROR | Please use -read-only flag to enable this feature.

    INFO | Duplicate loglines will be removed, if you wish to see each indiviudal line launch with the -log-nofilter flag.

    INFO | IPv4 server found: 112.4.0.55

    INFO | IPv6 DNS server found: 2409:8020:2000::88

    INFO | IPv6 DNS server found: 2409:8020:2000::8

    INFO | IPv6 DNS server found: 2409:8080::1

    INFO | IPv6 DNS server found: 2409:8080::2

```

# 插件、SDK、模拟器的 API 兼容

【检查插件和SDK兼容性】

- 进入 `File > Settings > Plugin` 中可以看到已经安装的插件和对应的版本。

- `Kotlin` 插件的版本比较容易出兼容问题。可以看到插件中的版本是 `1.7.10` 或其他。

- 可以在 `C:\Users\summit\.gradle\caches\org.jetbrains.kotlin\kotlin-gradle-plugin` 下看到 gradle 看到 Kotlin 各个版本的 jar 包，留下插件里对应版本的，其他都删掉。

- 构建提示 `Unhandled Exception: MissingPluginException` 错误时，很大可能是插件的版本和 Android API SDK 的版本不兼容，没法在对应的平台上加载和运行。

- 意味着 `build.gradle` 文件中 `android.compileSdkVersion` 项的版本，比如和运行目标版本的 Android API 版本一致，且至少是 33，否则 `path_provider` 插件根本没法运行。

- 且插件之间存在互相依赖的版本关系，比如 `permisiion_handler v8.3.0` 依赖 `path_provider` 版本 `> 2.0.0`。

【修改 compileSdkVersion 版本】

- 用户首先需要安装指定版本的 SDK，比如 Android API 33 SDK。

- 然后在 `<app dir>/android/build.gradle` 或 `<app dir>/android/main/build.gradle` 中找到 `android.compildSdkVersion` 配置项。

- 配置项 `compileSdkVersion` 默认是取的当前 flutter 插件里默认配置的版本，直接改为目标版本即可。

```

android {

    compileSdkVersion flutter.compileSdkVersion // 直接改为目标版本，比如 33

    ...

}

```

【确认模拟器 API 版本】

- 尽量将模拟器的 API 版本调整为大于等于 Flutter Plugin 和 compileSdkVersion 指定的 API 版本。

- 这样使用特定版本 Android SDK 编译出的 App 才能在对应模拟器中运行。比如模拟器的 API 版本选定为 33。

## 布局线框图

- Flutter 插件内置的 `Toggle Debug Paint` 可以切换 Flutter 组件的线框图，方便布局调试。