佛系程序员_ 本地运行Flutter项目基本步骤

学习笔记

发布日期: 2026-01-04 14:37:24

喜欢量: 5 个

阅读次数: 134

安装Flutter SDK

本地运行Flutter项目，按照以下步骤操作：

项目：
app目录下有android, ios, web, linux,macos

### 一、准备环境
1. 直接访问官网：https://docs.flutter.dev/get-started/quick 的文档安装
2. **手动下载安装Flutter SDK**
   - 从 [Flutter官网](https://docs.flutter.dev/get-started/install) 下载对应系统（Windows/macOS/Linux）的SDK，配置环境变量（确保`flutter`命令能在终端执行）。
3. **安装开发工具**
   - 推荐用 **VS Code**（安装`Flutter`、`Dart`插件），
   - 或 **Android Studio**（安装Flutter插件）。（因电脑中已经有VS code，故未采取这一种）
4. **检查环境**
   打开终端，执行：
   ```bash
   flutter doctor
   ```
   按照提示修复缺失的依赖（比如Android SDK、iOS模拟器等）。
	 
5.安装完成后,在 VS Code IDE中，会出现一段提示：
```
The VS Code IDE extensions for Dart and Flutter uses Google Analytics to report usage and diagnostic data along with package dependencies, and crash reporting to send basic crash reports. This data is used to help improve the Dart platform, Flutter framework, and related tools. Telemetry is not sent on the very first run. To disable reporting of telemetry, run this terminal command: dart --disable-analytics If you opt out of telemetry, an opt-out event will be sent, and then no further information will be sent. This data is collected in accordance with the Google Privacy Policy (https://policies.google.com/privacy).
```

### 二、运行项目
1. **打开项目**
   - 用VS Code/Android Studio打开你截图里的`app`文件夹（项目根目录）。
2. **获取依赖**
   终端进入项目根目录，执行：
   ```bash
   flutter pub get
   ```
   （自动下载`pubspec.yaml`里声明的依赖）
3. **启动模拟器/连接真机**
   - 若开发Android：打开Android模拟器，或用USB连接安卓手机并开启“开发者模式+USB调试”。
   - 若开发iOS：打开Xcode模拟器（仅macOS支持），或连接iPhone并信任设备。
4. **运行项目**
   - VS Code：按`F5`，或点击右上角“运行”按钮。
   - 终端：执行
     ```bash
     flutter run
     ```
		 这句命令会运行该目录下所有的，所以需进入到你要运行的那一个目录下。或写：
		 flutter run  -d android
   等待编译完成后，模拟器/真机就会启动App。

### 三、继续开发
- 修改`lib/main.dart`（或其他`lib`下的Dart文件）后，按`r`（终端中）或保存文件，Flutter会自动热重载更新界面。
- 若需要添加新依赖，在`pubspec.yaml`的`dependencies`下添加，再执行`flutter pub get`。

在进行到第一.3步时，
```
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.38.5, on Microsoft Windows [版本 10.0.19044.1889], locale zh-CN)
[√] Windows Version (10 专业版 64 位, 21H2, 2009)
[X] Android toolchain - develop for Android devices
    X Unable to locate Android SDK.
      Install Android Studio from: https://developer.android.com/studio/index.html
      On first launch it will assist you in installing the Android SDK components.
      (or visit https://flutter.dev/to/windows-android-setup for detailed instructions).
      If the Android SDK has been installed to a custom location, please use
      `flutter config --android-sdk` to update to that location.

[√] Chrome - develop for the web
[X] Visual Studio - develop Windows apps
    X Visual Studio not installed; this is necessary to develop Windows apps.
      Download at https://visualstudio.microsoft.com/downloads/.
      Please install the "Desktop development with C++" workload, including all of its default components
[√] Connected device (3 available)
[√] Network resources
这种情况需要多少空间，我的C盘还有8G，E盘还有60G
```

```
你当前需要安装的组件（Android SDK + Visual Studio）所需空间如下：

### 1. 各组件所需空间
- **Android SDK（含基础工具）**：
  安装Android Studio + 常用SDK版本（比如Android 33/34），约占 **15-20G**（包含模拟器镜像的话可能更大）。
- **Visual Studio（Desktop开发）**：
  安装“Desktop development with C++”工作负载，约占 **8-12G**。

### 2. 你的磁盘情况
- **C盘剩余8G**：空间不足（无法装Android SDK或Visual Studio）。
- **E盘剩余60G**：足够装所有组件（建议把Android SDK、Visual Studio都装在E盘）。

### 操作建议
1. **安装Android Studio到E盘**：
   安装时选择“自定义安装”，将安装路径设为`E:\AndroidStudio`，并把Android SDK也放在E盘（比如`E:\AndroidSDK`）。
2. **安装Visual Studio到E盘**：
   下载Visual Studio后，安装时选择“安装位置”为`E:\VisualStudio`，并勾选“Desktop development with C++”工作负载。
3. **配置Flutter**：
   终端执行`flutter config --android-sdk E:\AndroidSDK`，关联Android SDK路径。

要不要我帮你整理一份**Android Studio+Visual Studio的E盘安装步骤**？
```
```
虽如此，在C盘仍然会占用一些空间是吧，大约多少
```
是的，即使将Android Studio和Visual Studio安装到E盘，**仍然会在C盘占用一定空间**，主要是系统缓存、配置文件、依赖组件等，具体占用情况如下：

### 一、Android Studio 相关C盘占用（约2-4G）
1.  **用户配置文件**：
    - 路径：`C:\Users\你的用户名\.android`（SDK缓存、模拟器配置等），约500M-1G。
    - 路径：`C:\Users\你的用户名\.gradle`（Gradle构建缓存），约1-2G（首次构建后会逐渐增大）。
2.  **系统依赖组件**：
    - 安装时会自动安装Java运行时（JRE），约200-300M。
    - 部分驱动和工具会写入系统目录，约100-200M。

### 二、Visual Studio 相关C盘占用（约3-6G）
1.  **系统必备组件**：
    - Visual Studio会安装.NET Framework、VC++运行库等系统组件，约1-2G。
    - Windows SDK（部分核心文件默认装在C盘），约2-3G。
2.  **用户配置和缓存**：
    - 路径：`C:\Users\你的用户名\AppData\Local\Microsoft\VisualStudio`（配置和缓存），约500M-1G。

### 三、总占用估算
两者合计会在C盘占用 **5-10G** 空间，而你的C盘剩余8G，可能会出现空间不足的情况（尤其是首次安装和构建项目后，缓存会进一步增大）。

### 解决建议
1.  **清理C盘冗余文件**：
    - 用Windows自带的“磁盘清理”工具清理系统垃圾、临时文件。
    - 转移桌面、文档等文件夹到E盘，释放C盘空间。
2.  **修改缓存路径**：
    - 修改Gradle缓存路径：在系统环境变量中添加`GRADLE_USER_HOME`，值设为`E:\.gradle`。
    - 修改Android Studio的SDK缓存路径：打开Android Studio，在`File > Settings > Appearance & Behavior > System Settings > Android SDK`中，更改“SDK Tools”的缓存目录。

要不要我帮你整理一份**C盘空间不足的具体解决方案**，包括缓存路径修改和冗余文件清理步骤？
```

我想，再清理也难腾出空间，于是采用这个方法：

```
单独下载 Android SDK
方式 1：通过 Android Command Line Tools 下载（官方提供，无 Android Studio 冗余文件）；
方式 2：从可靠镜像源下载打包好的 Android SDK（推荐放在 E 盘，比如 E:\AndroidSDK，避免 C 盘占用）。

https://developer.android.com/studio#command-tools
搜索：Command line tools only
```
下载时，先没有注意，没找到Command line tools only， 首页出现下载的是  android-studio-2025.2.2.8-windows.exe，
后来，搜索发现，Command line tools only 在页面下方。

```
你下载到的 `android-studio-2025.2.2.8-windows.exe` 确实是**Android Studio的安装程序**，并非单独的Android SDK安装包——这是很容易混淆的点，下面为你理清关键区别和正确的单独获取Android SDK的方案：

### 一、先明确核心区别
| 类型 | 说明 | 大小 |
| :--- | :--- | :--- |
| Android Studio | 集成开发环境（IDE），自带Android SDK管理工具，包含界面化操作、模拟器等冗余组件 | 安装包几百M，完整安装后15-20G |
| 单独Android SDK | 仅包含Android开发所需的核心文件（平台工具、构建工具、SDK版本等），无IDE界面 | 按需下载组件，仅占3-8G（无模拟器） |

你之前下载的文件是Android Studio（IDE），不是我们需要的“单独Android SDK”，所以需要更换获取方式。

### 二、正确获取「单独Android SDK」的官方方法
核心是通过 **Android Command Line Tools**（官方提供的纯命令行工具，无Android Studio）来下载和管理Android SDK，步骤如下：
1.  **下载Android Command Line Tools**
    - 打开官方下载地址：https://developer.android.com/studio#command-tools
    - 下拉找到「Command line tools only」，选择对应Windows版本（.zip格式，仅几十M）下载。
2.  **解压并初始化目录结构**
    - 新建E盘目录（避免C盘占用）：`E:\AndroidSDK`
    - 将下载的zip包解压，把解压后的 `cmdline-tools` 文件夹移动到 `E:\AndroidSDK\` 下
    - 手动创建子目录：`E:\AndroidSDK\cmdline-tools\latest`
    - 将 `E:\AndroidSDK\cmdline-tools` 下的 `bin`、`lib` 等文件/文件夹，全部移动到 `latest` 目录中（最终路径：`E:\AndroidSDK\cmdline-tools\latest\bin`）
3.  **配置环境变量**
    - 新增系统环境变量 `ANDROID_HOME`，值设为：`E:\AndroidSDK`
    - 新增系统环境变量 `PATH` 条目（3个）：
      1.  `E:\AndroidSDK\cmdline-tools\latest\bin`
      2.  `E:\AndroidSDK\platform-tools`
      3.  `E:\AndroidSDK\build-tools\34.0.0`（后续安装后自动生成，先配置路径格式）
4.  **通过命令行安装Android SDK核心组件**
    - 打开管理员终端，执行以下命令（按需安装必备组件，无冗余）：
      ```bash
      # 初始化并接受SDK许可协议
      sdkmanager --licenses
			（到这一步，出现 没有JAVA_HOME变量，所以后面还是采用安装Android Studio获得核心组件）
      # 安装核心组件（platform-tools、Android 34平台、构建工具）
      sdkmanager "platforms;android-34" "build-tools;34.0.0" "platform-tools"
      ```
    - 执行完成后，`E:\AndroidSDK` 下会自动生成 `platform-tools`、`build-tools` 等目录，即完整的Android SDK。
5.  **关联Flutter与单独Android SDK**
    - 终端执行命令，指定SDK路径：
      ```bash
      flutter config --android-sdk E:\AndroidSDK
      ```
    - 再次执行 `flutter doctor`，即可识别到Android SDK，解决之前的报错。

### 三、补充说明
1.  这种方式完全无需安装Android Studio，仅占用E盘3-8G空间（根据SDK版本多少而定），完美适配你C盘空间不足的情况；
2.  后续如需新增Android SDK版本，只需在终端执行 `sdkmanager "platforms;android-33"` 即可，全程命令行操作，无冗余组件；
3.  搭配VS Code的Flutter/Dart插件，即可正常开发、编译、运行Android端Flutter项目，功能与Android Studio一致，且更轻量化。
4.  这个方式，需要自己补全 3 个核心组件 比如：platform-tools、platforms、build-tools、cmdline-tools。还是推荐四的方法，自定义安装。

### 四、若你已下载Android Studio安装包（可选方案）
如果你不想手动配置命令行工具，也可以用这个 `android-studio-xxx.exe` 安装包，**仅安装Android SDK，不使用Android Studio IDE**：
1.  运行安装包，选择「自定义安装」，安装路径设为 `E:\AndroidStudio`；
2.  取消勾选「Android Studio IDE」（仅保留「Android SDK」「Android SDK Platform Tools」等核心组件）；
3.  安装完成后，找到E盘的Android SDK路径（通常是 `E:\AndroidStudio\sdk`），按上述方法关联Flutter即可；
4.  后续无需打开Android Studio，仅用VS Code开发即可，这样既省去手动配置SDK的麻烦，又不会占用过多磁盘空间。
```

我是把Android Studio 下载后运行，把目录放在 E:\AndroidSDK，这样安装后，就自动重新会生成 platform-tools、platforms、build-tools 目录中的内容。

```
#最后一步：终端执行命令，指定SDK路径
>flutter config --android-sdk E:\AndroidSDK
>flutter doctor
#即可识别到Android SDK
Android toolchain ...
#adb devices
* daemon not running; starting now at tcp:5037
* daemon started successfully
List of devices attached
2ea2b825        unauthorized
(这是手动连接上，还未授权的提示，点击手机上的授权)
#运行android
```
继续 ：
```
flutter devices
flutter run -d 2ea2b825

Downloading android-arm-profile/windows-x64 tools...               947ms
Downloading android-arm-release/windows-x64 tools...               667ms
Downloading android-arm64-profile/windows-x64 tools...             784ms
Downloading android-arm64-release/windows-x64 tools...             721ms
Downloading android-x64-profile/windows-x64 tools...               775ms
Downloading android-x64-release/windows-x64 tools...               707ms
Resolving dependencies... 
Downloading packages... (1.1s)
  async 2.12.0 (2.13.0 available)
  characters 1.4.0 (1.4.1 available)
  flutter_lints 5.0.0 (6.0.0 available)
  lints 5.1.1 (6.0.0 available)
  matcher 0.12.17 (0.12.18 available)
  material_color_utilities 0.11.1 (0.13.0 available)
  test_api 0.7.7 (0.7.8 available)
  vm_service 14.3.1 (15.0.2 available)
Got dependencies!
8 packages have newer versions incompatible with dependency constraints.
Try `flutter pub outdated` for more information.
Launching lib\main.dart on M2012K11AG in debug mode...
Running Gradle task 'assembleDebug'...            
```

yyii

http://www.amtb.info/show/Mjc4

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !