\u5173\u4e8e\u7f16\u8bd1\uff1a<\/p>\n\n\n\n
--unopt<\/code> builds. These builds will have additional logging and checks enabled, and generally use build and link flags that lead to faster compilation and better debugging symbols. If you are trying to do performance testing with a local build, do not use the --unopt<\/code> flag.<\/li>\n\n\n\n- Link Time Optimization: Optimized builds also perform Link Time Optimization of all binaries. This makes the linker take a lot of time and memory to produce binaries. If you need optimized binaries but don’t want to perform LTO, add the
--no-lto<\/code> flag.<\/li>\n\n\n\n- Android and iOS expect both a
host<\/code> and android<\/code> (or ios<\/code>) build. It is critical to recompile the host build after upgrading the Dart SDK (e.g. via a gclient sync<\/code> after merging up to head), since artifacts from the host build need to be version matched to artifacts in the Android\/iOS build.<\/li>\n\n\n\n- Web, Desktop, and Fuchsia builds have only one build target (i.e.
host<\/code> or fuchsia<\/code>).<\/li>\n\n\n\n- Make sure to exclude the
out<\/code> directory from any backup scripts, as many large binary artifacts are generated. This is also generally true for all of the directories outside of the engine\/src\/flutter<\/code> directory.<\/li>\n<\/ul>\n\n\n\nUsing a custom Dart SDK<\/a><\/h2>\n\n\n\nWhen targeting the host and desktop, on CI we use a pre-built Dart SDK vended by the Dart team. To build and use the SDK from the Dart sources downloaded by\u00a0gclient sync<\/code>, after editing those source files, pass the flag\u00a0--no-prebuilt-dart-sdk<\/code>\u00a0to\u00a0\/\/flutter\/tools\/gn<\/code>.<\/p>\n\n\n\nCompiling for Windows<\/a><\/h2>\n\n\n\nYou can only build selected binaries on Windows (mainly gen_snapshot<\/code> and the desktop embedding).<\/p>\n\n\n\nOn Windows, ensure that the engine checkout is not deeply nested. This avoid the issue of the build scripts working with excessively long paths.<\/p>\n\n\n\n
\n- Make sure you have Visual Studio installed (non-Googlers only). Debugging Tools for Windows 10<\/a> must be installed.<\/li>\n\n\n\n
git pull upstream main<\/code> in src\/flutter<\/code> to update the Flutter Engine repo.<\/li>\n\n\n\n- Ensure long path support is enabled on your machine. Launch PowerShell as an administrator and run:<\/li>\n<\/ol>\n\n\n\n
Set-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -Force\n<\/code><\/pre>\n\n\n\n\n- If you are not a Google employee, you must set the following environment variables to point the depot tools at Visual Studio:<\/li>\n<\/ol>\n\n\n\n
DEPOT_TOOLS_WIN_TOOLCHAIN=0\nGYP_MSVS_OVERRIDE_PATH=\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\" # (or your location for Visual Studio)\nWINDOWSSDKDIR=\"C:\\Program Files (x86)\\Windows Kits\\10\" # (or your location for Windows Kits)<\/code><\/pre>\n\n\n\nAlso, be sure that Python27 is before any other python in your Path.<\/p>\n\n\n\n
\ngclient sync<\/code> to update your dependencies.<\/li>\n\n\n\n- switch to
src\/<\/code> directory.<\/li>\n\n\n\npython .\\flutter\\tools\\gn --unoptimized<\/code>\u00a0to prepare your build files.\n\n- If you are only building
gen_snapshot<\/code>: python .\\flutter\\tools\\gn [--unoptimized] --runtime-mode=[debug|profile|release] [--android]<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\nninja -C .\\out\\<dir created by previous step><\/code>\u00a0to build.\n\n- If you used a non-debug configuration, use
ninja -C .\\out\\<dir created by previous step> gen_snapshot<\/code>. Release and profile are not yet supported for the desktop shell.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\npython .\\flutter\\tools\\gn --unoptimized --no-prebuilt-dart-sdk<\/span><\/code>\n<\/code><\/pre>\n\n\n\nCompiling for the Web<\/a><\/h2>\n\n\n\nFor building the engine for the Web we use the felt<\/a> tool.<\/p>\n\n\n\nTo test Flutter with a local build of the Web engine, add --local-web-sdk=wasm_release<\/code> to your flutter<\/code> command, e.g.:<\/p>\n\n\n\nflutter run --local-web-sdk=wasm_release -d chrome\nflutter test --local-web-sdk=wasm_release test\/path\/to\/your_test.dart\n<\/code><\/pre>\n\n\n\nCompiling for the Web on Windows<\/a><\/h2>\n\n\n\nCompiling the web engine might take a few extra steps on Windows. Use cmd.exe and “run as administrator”.<\/p>\n\n\n\n
\n- Make sure you have Visual Studio installed. Set the following environment variables. For Visual Studio use the path of the version you installed.\n
\nGYP_MSVS_OVERRIDE_PATH = \"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\"<\/code><\/li>\n\n\n\nGYP_MSVS_VERSION = 2017<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n- Make sure, depot_tools, ninja and python are installed and added to the path. Also set the following environment variable for depot tools:\n
\nDEPOT_TOOLS_WIN_TOOLCHAIN = 0<\/code><\/li>\n\n\n\n- Tip: if you get a python error try to use Python 2 instead of 3<\/li>\n<\/ul>\n<\/li>\n\n\n\n
git pull upstream main<\/code> in src\/flutter<\/code> to update the Flutter Engine repo.<\/li>\n\n\n\ngclient sync<\/code>\u00a0to update your dependencies.\n\n- Tip: If you get a git authentication errors on this step try Git Bash instead<\/li>\n<\/ul>\n<\/li>\n\n\n\n
python .\\flutter\\tools\\gn --unoptimized --full-dart-sdk<\/code> to prepare your build files.<\/li>\n\n\n\nninja -C .\\out\\<dir created by previous step><\/code> to build.<\/li>\n<\/ol>\n\n\n\nTo test Flutter with a local build of the Web engine, add --local-web-sdk=wasm_release<\/code> to your flutter<\/code> command, e.g.:<\/p>\n\n\n\nflutter run --local-web-sdk=wasm_release -d chrome\nflutter test --local-web-sdk=wasm_release test\/path\/to\/your_test.dart\n<\/code><\/pre>\n\n\n\nFor testing the engine again use felt<\/a> tool this time with felt_windows.bat.<\/p>\n\n\n\nfelt_windows.bat test<\/code><\/pre>\n\n\n\nTroubleshooting Compile Errors<\/a><\/h2>\n\n\n\nVersion Solving Failed<\/a><\/h3>\n\n\n\nFrom time to time, as the Dart versions increase, you might see dependency errors such as:<\/p>\n\n\n\n
The current Dart SDK version is 2.7.0-dev.0.0.flutter-1ef444139c.\n\nBecause ui depends on <a pub package> 1.0.0 which requires SDK version >=2.7.0 <3.0.0, version solving failed.\n<\/code><\/pre>\n\n\n\nRunning gclient sync<\/code> does not update the tags, there are two solutions:<\/p>\n\n\n\n\n- under
engine\/src\/third_party\/dart<\/code> run git fetch --tags origin<\/code><\/li>\n\n\n\n- or run gclient sync with with tags parameter:
gclient sync --with_tags<\/code><\/li>\n<\/ol>\n\n\n\n