
如何搭建 Flutter Framework 源码开发环境并用 examples 验证安装成功【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter这篇文章面向要参与 Flutter Framework 源码开发的人任务是把 flutter/flutter 仓库克隆到本地、把仓库自带的flutter命令行工具配置到 PATH、拉齐所有 Dart 依赖最后用仓库自带的 examples 跑一次flutter run确认整套环境可用。适用平台为 Linux、macOS 或 Windows。步骤依据仓库内的 Framework 开发环境搭建文档 和 运行 examples 文档。环境前置要求开始克隆之前确认本机具备以下条件操作系统为 Linux、macOS 或 Windows已安装git用于源码版本控制一个 IDE例如带 Flutter 插件的 Android Studio 或 VS CodeAndroid platform tools按平台安装Macbrew install --cask android-platform-toolsLinuxsudo apt-get install android-tools-adbPython部分工具会用到。安装完 Android platform tools 后验证adb已在 PATH 中即which adb能打印出合理的输出。如果验证不到说明 tools 没装好或没进 PATH先解决这个问题再继续。文档还提到一个可选情况如果你同时在做 Flutter engine 开发可以直接复用 engine 仓库里.../engine/src/third_party/android_tools/sdk/platform-tools下的那份 platform tools对应说明见 engine 开发环境文档。克隆仓库并配置 upstream/origin 两个 remoteFramework 源码开发采用双 remote 约定upstream指向官方 flutter/flutter 仓库origin指向你自己的 fork。克隆官方仓库SSH 或 HTTPS 均可推荐 SSH前提是 GitHub 账号已配置好可用的 SSH keygit clone gitgithub.com:flutter/flutter.git # 或 git clone https://github.com/flutter/flutter.git进入克隆出的仓库目录把默认的origin改名为upstreamcd flutter git remote rename origin upstream把 flutter/flutter 仓库 fork 到你自己的 GitHub 账号下在 GitHub 仓库页面上操作。把你的 fork 添加为本地克隆的originremote。下面命令中的your-github-username是占位符首次出现这里说明一下请把它替换成你自己的 GitHub 账号名源文档中用████████表示这个位置# SSH推荐 git remote add origin gitgithub.com:your-github-username/flutter.git # 或 HTTPS git remote add origin https://github.com/your-github-username/flutter.git验证两个 remote 配置正确git remote -v输出里应能看到upstream指向 flutter/flutter 官方仓库、origin指向你的 fork。把仓库的 bin 目录加入 PATHFramework 仓库自带flutter命令行工具必须让 shell 找到的是这份而不是你机器上可能已装的另一份 Flutter SDK。在仓库根目录执行以 UNIX 为例export PATH$PATH:$HOME/path to flutter repository/bin其中path to flutter repository是占位符替换为你克隆的 flutter 仓库相对于$HOME的路径比如克隆在~/dev/flutter就写$HOME/dev/flutter/bin。这一步有一个明确的边界条件如果你机器上已经装过 Flutter需要把那份旧的从 PATH 里移除或者每次运行flutter时都用完整路径指向本仓库。文档给出的判断方法是——如果后面运行 examples 时出现版本求解version solving错误说明你当前运行的不是本仓库 checkout 出来的那个 Flutter 版本而是 PATH 里先命中的另一份。flutter 工具文档 也要求 PATH 上的flutter和dart解析到本仓库bin目录下的脚本。拉取依赖flutter update-packagesPATH 配置好后在仓库根目录执行flutter update-packages该命令会递归拉取 Flutter 仓库依赖的所有 Dart 包。如果版本求解失败文档给出的处理顺序是先执行git fetch upstream更新到较新的 Flutter 版本再重新执行flutter update-packages。可选分支如果你用 IntelliJ 系列 IDE 开发可以再执行一条命令为仓库生成 IntelliJ 配置文件这样能直接把 flutter 主目录作为工程打开、在 IDE 内运行 examplesflutter ide-config --overwrite使用其他 IDE 可以跳过这一步它不影响flutter run验证。用 examples 验证安装前置步骤都完成后用仓库自带的 example 项目做一次真实运行这是文档指定的see if your setup works验证方式。主路径examples/hello_world前提有一个运行中的模拟器或一台通过 USB 连接、已开启调试的设备。cd examples/hello_world flutter runexamples/hello_world/lib/main.dart存在属于有默认入口的标准 example直接flutter run即可。程序按你连接的模拟器/设备启动并展示 hello world 界面就说明环境链路工具、依赖、设备连接是通的。可选分支指定入口文件运行 example某些 example 目录没有lib/main.dart需要-t参数指定要运行的 Dart 文件。文档给出的例子是examples/layers目录下的widgets/spinning_square.dart在该目录下、连接了 Android 设备时执行cd examples/layers flutter run -t widgets/spinning_square.dart这一分支只是演示-t的用法不是主路径的必要步骤。验证结果与常见失败判断把文档中给出的判断方法集中列一下which adb没有合理输出Android platform tools 安装或 PATH 问题回到前置要求一节处理git remote -v中缺少upstream或origin指向不对remote 配置没做全按上一节第 2、4、5 步补运行 examples 时出现版本求解错误你执行的flutter不是本仓库bin里的那份检查 PATH 中是否有其他 Flutter SDK 抢先命中flutter update-packages版本求解失败先git fetch upstream更新源码再重试。文档没有给出flutter run的固定成功日志因此不要以特定输出内容作为判定标准以应用能否在模拟器/设备上正常启动为准。下一步环境验证通过后Framework 开发环境文档 列出的后续阅读方向The flutter tool了解flutter命令行工具的工作原理Style guide for Flutter repoFlutter 仓库代码风格Tree hygiene如何提交补丁Signing commits配置提交签名。【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考