跳转至

01-开发环境安装

Vexfy 项目 Flutter 开发环境安装指南，适用于 Windows / macOS / Linux

一、环境要求

组件 版本要求 说明
Flutter SDK ≥ 3.0 推荐最新稳定版
Dart 内嵌于 Flutter 无需单独安装
Android SDK Android 5.0+ (API 21) 仅安卓开发需要
Xcode ≥ 14.0 仅 iOS/macOS 开发需要
Git 任意版本 代码管理

二、安装 Flutter SDK

2.1 macOS / Linux

# 1. 下载 Flutter SDK（选择合适的目录）
cd ~/Apps
curl -O https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.24.0-stable.tar.xz

# 2. 解压
tar xf flutter_linux_3.24.0-stable.tar.xz

# 3. 添加到 PATH（~/.zshrc 或 ~/.bashrc）
export PATH="$PATH:$HOME/Apps/flutter/bin"

# 4. 验证安装
flutter --version

2.2 Windows

# 1. 从官网下载：https://docs.flutter.dev/get-started/install/windows
# 2. 解压到 C:\Apps\flutter
# 3. 添加到系统 PATH：C:\Apps\flutter\bin
# 4. 在 PowerShell 执行
flutter --version

三、安装 Android SDK

3.1 方法一：使用 Android Studio（推荐）

# 下载 Android Studio：https://developer.android.com/studio
# 安装后会自动配置 SDK

3.2 方法二：命令行工具（macOS / Linux）

export ANDROID_HOME=~/Apps/android-sdk

# 下载 cmdline-tools
mkdir -p $ANDROID_HOME/cmdline-tools
cd $ANDROID_HOME/cmdline-tools
curl -O https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
unzip commandlinetools-linux-11076708_latest.zip
mv cmdline-tools latest

# 安装 SDK 组件
yes | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --licenses
$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager "platforms;android-34" "build-tools;34.0.0"

3.3 配置 Flutter 使用 Android SDK

# 设置 Android SDK 路径
flutter config --android-sdk ~/Apps/android-sdk

# 同意许可
flutter doctor --android-licenses

四、验证环境

# 运行 flutter doctor 检查环境状态
flutter doctor

# 预期输出（全部 ✓）：
# ✓ Flutter SDK
# ✓ Android toolchain
# ✓ Xcode（仅 macOS）
# ✓ Chrome（仅 Web 开发）
# ✓ VS Code（如果有安装）

五、创建学习 Demo 项目

Flutter 提供命令快速初始化项目：

# 创建 Demo 项目
flutter create vexfy_demo

# 进入目录
cd vexfy_demo

# 运行（验证环境）
flutter run

项目结构（最简单）：

vexfy_demo/
├── lib/
│   └── main.dart         ← 入口文件，就这一个
├── pubspec.yaml          ← 依赖配置
├── android/              ← Android 平台代码
├── ios/                  ← iOS 平台代码
└── test/

修改 lib/main.dart 开始学习：

import 'package:flutter/material.dart';

void main() {
    runApp(MaterialApp(home: Text('Hello Vexfy!')));
}

六、克隆 Vexfy 项目

# 进入工作目录
cd ~/workspace/vex

# 克隆项目
git clone https://github.com/fomalhaut-m/vexfy.git

# 进入 app 目录（Flutter 代码）
cd vexfy/app

# 安装依赖
flutter pub get

# 运行（验证环境）
flutter run

七、IDE 推荐

IDE 平台 说明
Android Studio Win/Mac/Linux Flutter 官方推荐，最完整
VS Code Win/Mac/Linux 轻量，需要装 Flutter 插件
Xcode 仅 Mac iOS/macOS 开发必装

VS Code Flutter 插件推荐： - Flutter（Dart 语法高亮 + 调试） - Flutter Intl（国际化支持）

下一步