[环境基线] - OS: Windows 10 22H2 (10.0.19045.6466) - Flutter: 3.41.3 (stable), framework 48c32af034, engine 327ed81450 - Dart: 3.11.1 [Android] - Android SDK: 36.1.0 - Platform: android-36.1 - Build-tools: 36.1.0 - Java: OpenJDK 21.0.9 - Emulator: 36.4.9.0 [Web] - Chrome: 147.0.7727.56 - Edge: 146.0.3856.109 [可用运行目标] - Android Emulator / Windows Desktop / Chrome / Edge [注意] - 未安装 Visual Studio仅影响 Windows 桌面构建android端下面sdk组件必须安装否则android的gradle一直报错SDK Tools 各项工具详细说明纯表格、无状态一、所有工具总览表表格工具名称核心作用必备程度主要包含工具Android SDK Build-Tools编译、打包、签名、优化 APK/AAB必须aapt2、d8/r8、apksigner、zipalign、aidlAndroid SDK Platform-Tools电脑与设备通信、调试、安装应用必须adb、fastboot、sqlite3、systraceAndroid SDK Command-line ToolsSDK/AVD 命令行管理、分析工具必须sdkmanager、avdmanager、apkanalyzer、lintAndroid Emulator在电脑上运行 Android 虚拟设备建议安装模拟器引擎、界面、传感器模拟Emulator hypervisor driver模拟器硬件虚拟化加速驱动建议安装Intel/AMD 虚拟化驱动替代 HAXMNDK (Side by side)C/C 原生代码编译、生成 .so 库可选编译器、链接器、C/C 标准库、头文件CMakeNDK 构建配置工具管理 C/C 编译可选cmake、ninja、读取 CMakeLists.txt二、SDK Tools 与 SDK Platforms 区别表表格对比项SDK ToolsSDK Platforms本质开发、编译、调试、打包的工具集对应 Android 版本的系统开发环境内容Build-Tools、Platform-Tools、Emulator、NDK、CMake 等android.jar API、系统镜像、源码、资源版本工具独立版本不绑定 Android 版本按 API Level / Android 版本区分API 34、35…作用把代码变成 APK、连接设备、调试运行提供系统 API、编译依赖、模拟器系统镜像是否通用一套工具支持所有 Android 版本每个版本独立需要哪个装哪个依赖所有项目必须安装按项目 compileSdk 安装对应版本ios端表格命令作用核心用途为什么 Flutter iOS 必须查这个xcodebuild -version查看Xcode 实际构建版本1. 确定编译 iOS 工程的真实 Xcode 版本2. Flutter 编译 iOS 依赖此版本比直接看 Xcode 界面更准3. 排查「编译失败、SDK 不匹配」问题xcode-select -p查看当前系统使用的 Xcode 路径1. 一台电脑可能装多个 Xcode必须确认当前生效的是哪一个2. 解决「Xcode 路径错误、命令行工具不生效」的根因swift --version查看Swift 编译器版本1. Flutter iOS 插件 / 原生代码大量使用 Swift2. Swift 版本不匹配会直接导致编译报错、插件无法运行ruby -v查看Ruby 版本1. CocoaPodsiOS 依赖管理工具基于 Ruby 运行2. Ruby 版本过低 / 过高都会导致 pod 无法安装pod --version查看CocoaPods 版本1. Flutter iOS 项目必须用 CocoaPods 管理原生依赖2. 版本不兼容是「pod install 失败、iOS 运行报错」最常见原因gem -v查看RubyGems 版本1. Ruby 包管理工具用来安装 / 更新 CocoaPods2. 排查「无法安装 pod、gem 权限报错」问题bundler -v查看Bundler 版本可选1. 统一团队 Ruby 依赖版本避免「我这能跑你那不行」2. 企业级 / 标准化项目必查保证环境完全一致工具 / 命令作用是否 Xcode 自带说明xcodebuild -versionXcode 构建工具用来编译 iOS 项目✅自带Xcode 核心组件安装 Xcode 就有xcode-select -p管理 Xcode 命令行工具路径✅自带macOS 系统自带Xcode 安装后自动配置swift --versionSwift 编译器iOS 开发语言✅自带Xcode 自带Flutter iOS 编译依赖它ruby -vRuby 环境CocoaPods 依赖✅macOS 自带系统预装不用你装pod --versionCocoaPods管理 iOS 第三方依赖❌需要手动装一次唯一需要你手动安装的工具一条命令搞定gem -vRuby 包管理器安装 CocoaPods 用✅macOS 自带系统预装bundler -vRuby 依赖管理工具可选❌ 可选非必须一般项目不用装不装都行sudo gem install cocoapods