// Copyright 2014 The Flutter Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // @dart = 2.8 import 'package:args/command_runner.dart'; import 'package:file/memory.dart'; import 'package:file_testing/file_testing.dart'; import 'package:flutter_tools/src/base/file_system.dart'; import 'package:flutter_tools/src/base/os.dart'; import 'package:flutter_tools/src/base/platform.dart'; import 'package:flutter_tools/src/base/utils.dart'; import 'package:flutter_tools/src/build_info.dart'; import 'package:flutter_tools/src/cache.dart'; import 'package:flutter_tools/src/cmake.dart'; import 'package:flutter_tools/src/commands/build.dart'; import 'package:flutter_tools/src/commands/build_linux.dart'; import 'package:flutter_tools/src/features.dart'; import 'package:flutter_tools/src/project.dart'; import 'package:flutter_tools/src/reporting/reporting.dart'; import 'package:process/process.dart'; import 'package:test/fake.dart'; import '../../src/common.dart'; import '../../src/context.dart'; import '../../src/fakes.dart'; import '../../src/testbed.dart'; const String _kTestFlutterRoot = '/flutter'; final Platform linuxPlatform = FakePlatform( operatingSystem: 'linux', environment: { 'FLUTTER_ROOT': _kTestFlutterRoot, 'HOME': '/', } ); final Platform notLinuxPlatform = FakePlatform( operatingSystem: 'macos', environment: { 'FLUTTER_ROOT': _kTestFlutterRoot, } ); void main() { setUpAll(() { Cache.disableLocking(); }); FileSystem fileSystem; ProcessManager processManager; TestUsage usage; setUp(() { fileSystem = MemoryFileSystem.test(); Cache.flutterRoot = _kTestFlutterRoot; usage = TestUsage(); }); // Creates the mock files necessary to look like a Flutter project. void setUpMockCoreProjectFiles() { fileSystem.file('pubspec.yaml').createSync(); fileSystem.file('.packages').createSync(); fileSystem.file(fileSystem.path.join('lib', 'main.dart')).createSync(recursive: true); } // Creates the mock files necessary to run a build. void setUpMockProjectFilesForBuild() { setUpMockCoreProjectFiles(); fileSystem.file(fileSystem.path.join('linux', 'CMakeLists.txt')).createSync(recursive: true); } // Returns the command matching the build_linux call to cmake. FakeCommand cmakeCommand(String buildMode, { String target = 'x64', void Function() onRun, }) { return FakeCommand( command: [ 'cmake', '-G', 'Ninja', '-DCMAKE_BUILD_TYPE=${toTitleCase(buildMode)}', '-DFLUTTER_TARGET_PLATFORM=linux-$target', '/linux', ], workingDirectory: 'build/linux/$target/$buildMode', onRun: onRun, ); } // Returns the command matching the build_linux call to ninja. FakeCommand ninjaCommand(String buildMode, { Map environment, String target = 'x64', void Function() onRun, String stdout = '', }) { return FakeCommand( command: [ 'ninja', '-C', 'build/linux/$target/$buildMode', 'install', ], environment: environment, onRun: onRun, stdout: stdout, ); } testUsingContext('Linux build fails when there is no linux project', () async { final BuildCommand command = BuildCommand(); setUpMockCoreProjectFiles(); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ), throwsToolExit(message: 'No Linux desktop project configured. See ' 'https://flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app ' 'to learn about adding Linux support to a project.')); }, overrides: { Platform: () => linuxPlatform, FileSystem: () => fileSystem, ProcessManager: () => FakeProcessManager.any(), FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Linux build fails on non-linux platform', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ), throwsToolExit()); }, overrides: { Platform: () => notLinuxPlatform, FileSystem: () => fileSystem, ProcessManager: () => FakeProcessManager.any(), FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Linux build invokes CMake and ninja, and writes temporary files', () async { final BuildCommand command = BuildCommand(); processManager = FakeProcessManager.list([ cmakeCommand('release'), ninjaCommand('release'), ]); setUpMockProjectFilesForBuild(); await createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ); expect(fileSystem.file('linux/flutter/ephemeral/generated_config.cmake'), exists); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Handles argument error from missing cmake', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('release', onRun: () { throw ArgumentError(); }), ]); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ), throwsToolExit(message: "cmake not found. Run 'flutter doctor' for more information.")); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Handles argument error from missing ninja', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('release'), ninjaCommand('release', onRun: () { throw ArgumentError(); }), ]); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ), throwsToolExit(message: "ninja not found. Run 'flutter doctor' for more information.")); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux build does not spew stdout to status logger', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('debug'), ninjaCommand('debug', stdout: 'STDOUT STUFF', ), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--debug', '--no-pub'] ); expect(testLogger.statusText, isNot(contains('STDOUT STUFF'))); expect(testLogger.traceText, contains('STDOUT STUFF')); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux build extracts errors from stdout', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); // This contains a mix of routine build output and various types of errors // (Dart error, compile error, link error), edited down for compactness. const String stdout = r''' ninja: Entering directory `build/linux/x64/release' [1/6] Generating /foo/linux/flutter/ephemeral/libflutter_linux_gtk.so, /foo/linux/flutter/ephemeral/flutter_linux/flutter_linux.h, _phony lib/main.dart:4:3: Error: Method not found: 'foo'. [2/6] Building CXX object CMakeFiles/foo.dir/main.cc.o /foo/linux/main.cc:6:2: error: expected ';' after class /foo/linux/main.cc:9:7: warning: unused variable 'unused_variable' [-Wunused-variable] /foo/linux/main.cc:10:3: error: unknown type name 'UnknownType' /foo/linux/main.cc:12:7: error: 'bar' is a private member of 'Foo' /foo/linux/my_application.h:4:10: fatal error: 'gtk/gtk.h' file not found [3/6] Building CXX object CMakeFiles/foo_bar.dir/flutter/generated_plugin_registrant.cc.o [4/6] Building CXX object CMakeFiles/foo_bar.dir/my_application.cc.o [5/6] Linking CXX executable intermediates_do_not_run/foo_bar main.cc:(.text+0x13): undefined reference to `Foo::bar()' clang: error: linker command failed with exit code 1 (use -v to see invocation) ninja: build stopped: subcommand failed. ERROR: No file or variants found for asset: images/a_dot_burr.jpeg '''; processManager = FakeProcessManager.list([ cmakeCommand('release'), ninjaCommand('release', stdout: stdout, ), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ); // Just the warnings and errors should be surfaced. expect(testLogger.errorText, r''' lib/main.dart:4:3: Error: Method not found: 'foo'. /foo/linux/main.cc:6:2: error: expected ';' after class /foo/linux/main.cc:9:7: warning: unused variable 'unused_variable' [-Wunused-variable] /foo/linux/main.cc:10:3: error: unknown type name 'UnknownType' /foo/linux/main.cc:12:7: error: 'bar' is a private member of 'Foo' /foo/linux/my_application.h:4:10: fatal error: 'gtk/gtk.h' file not found clang: error: linker command failed with exit code 1 (use -v to see invocation) ERROR: No file or variants found for asset: images/a_dot_burr.jpeg '''); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux verbose build sets VERBOSE_SCRIPT_LOGGING', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('debug'), ninjaCommand('debug', environment: const { 'VERBOSE_SCRIPT_LOGGING': 'true' }, stdout: 'STDOUT STUFF', ), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--debug', '-v', '--no-pub'] ); expect(testLogger.statusText, contains('STDOUT STUFF')); expect(testLogger.traceText, isNot(contains('STDOUT STUFF'))); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux on x64 build --debug passes debug mode to cmake and ninja', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('debug'), ninjaCommand('debug'), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--debug', '--no-pub'] ); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux on ARM64 build --debug passes debug mode to cmake and ninja', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('debug', target: 'arm64'), ninjaCommand('debug', target: 'arm64'), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--debug', '--no-pub'] ); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => CustomFakeOperatingSystemUtils(hostPlatform: HostPlatform.linux_arm64), }); testUsingContext('Linux on x64 build --profile passes profile mode to make', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('profile'), ninjaCommand('profile'), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--profile', '--no-pub'] ); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux on ARM64 build --profile passes profile mode to make', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('profile', target: 'arm64'), ninjaCommand('profile', target: 'arm64'), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--profile', '--no-pub'] ); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => CustomFakeOperatingSystemUtils(hostPlatform: HostPlatform.linux_arm64), }); testUsingContext('Not support Linux cross-build for x64 on arm64', () async { final BuildCommand command = BuildCommand(); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub', '--target-platform=linux-x64'] ), throwsToolExit()); }, overrides: { Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => CustomFakeOperatingSystemUtils(hostPlatform: HostPlatform.linux_arm64), }); testUsingContext('Linux build configures CMake exports', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('release'), ninjaCommand('release'), ]); fileSystem.file('lib/other.dart') .createSync(recursive: true); fileSystem.file('foo/bar.sksl.json') .createSync(recursive: true); await createTestCommandRunner(command).run( const [ 'build', 'linux', '--target=lib/other.dart', '--no-pub', '--track-widget-creation', '--split-debug-info=foo/', '--enable-experiment=non-nullable', '--obfuscate', '--dart-define=foo.bar=2', '--dart-define=fizz.far=3', '--tree-shake-icons', '--bundle-sksl-path=foo/bar.sksl.json', ] ); final File cmakeConfig = fileSystem.currentDirectory .childDirectory('linux') .childDirectory('flutter') .childDirectory('ephemeral') .childFile('generated_config.cmake'); expect(cmakeConfig, exists); final List configLines = cmakeConfig.readAsLinesSync(); expect(configLines, containsAll([ 'file(TO_CMAKE_PATH "$_kTestFlutterRoot" FLUTTER_ROOT)', 'file(TO_CMAKE_PATH "${fileSystem.currentDirectory.path}" PROJECT_DIR)', ' "DART_DEFINES=Zm9vLmJhcj0y,Zml6ei5mYXI9Mw=="', ' "DART_OBFUSCATION=true"', ' "EXTRA_FRONT_END_OPTIONS=--enable-experiment=non-nullable"', ' "EXTRA_GEN_SNAPSHOT_OPTIONS=--enable-experiment=non-nullable"', ' "SPLIT_DEBUG_INFO=foo/"', ' "TRACK_WIDGET_CREATION=true"', ' "TREE_SHAKE_ICONS=true"', ' "FLUTTER_ROOT=$_kTestFlutterRoot"', ' "PROJECT_DIR=${fileSystem.currentDirectory.path}"', ' "FLUTTER_TARGET=lib/other.dart"', ' "BUNDLE_SKSL_PATH=foo/bar.sksl.json"', ])); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('linux can extract binary name from CMake file', () async { fileSystem.file('linux/CMakeLists.txt') ..createSync(recursive: true) ..writeAsStringSync(r''' cmake_minimum_required(VERSION 3.10) project(runner LANGUAGES CXX) set(BINARY_NAME "fizz_bar") '''); fileSystem.file('pubspec.yaml').createSync(); fileSystem.file('.packages').createSync(); final FlutterProject flutterProject = FlutterProject.fromDirectoryTest(fileSystem.currentDirectory); expect(getCmakeExecutableName(flutterProject.linux), 'fizz_bar'); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => FakeProcessManager.any(), FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Refuses to build for Linux when feature is disabled', () { final CommandRunner runner = createTestCommandRunner(BuildCommand()); expect(() => runner.run(['build', 'linux', '--no-pub']), throwsToolExit()); }, overrides: { FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: false), }); testUsingContext('hidden when not enabled on Linux host', () { expect(BuildLinuxCommand(operatingSystemUtils: FakeOperatingSystemUtils()).hidden, true); }, overrides: { FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: false), Platform: () => notLinuxPlatform, }); testUsingContext('Not hidden when enabled and on Linux host', () { expect(BuildLinuxCommand(operatingSystemUtils: FakeOperatingSystemUtils()).hidden, false); }, overrides: { FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), Platform: () => linuxPlatform, }); testUsingContext('Performs code size analysis and sends analytics', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('release'), ninjaCommand('release', onRun: () { fileSystem.file('build/flutter_size_01/snapshot.linux-x64.json') ..createSync(recursive: true) ..writeAsStringSync(''' [ { "l": "dart:_internal", "c": "SubListIterable", "n": "[Optimized] skip", "s": 2400 } ]'''); fileSystem.file('build/flutter_size_01/trace.linux-x64.json') ..createSync(recursive: true) ..writeAsStringSync('{}'); }), ]); fileSystem.file('build/linux/x64/release/bundle/libapp.so') ..createSync(recursive: true) ..writeAsBytesSync(List.filled(10000, 0)); await createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub', '--analyze-size'] ); expect(testLogger.statusText, contains('A summary of your Linux bundle analysis can be found at')); expect(testLogger.statusText, contains('flutter pub global activate devtools; flutter pub global run devtools --appSizeBase=')); expect(usage.events, contains( const TestUsageEvent('code-size-analysis', 'linux'), )); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), Usage: () => usage, OperatingSystemUtils: () => FakeOperatingSystemUtils(), }); testUsingContext('Linux on ARM64 build --release passes, and check if the LinuxBuildDirectory for arm64 can be referenced correctly by using analytics', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ cmakeCommand('release', target: 'arm64'), ninjaCommand('release', target: 'arm64', onRun: () { fileSystem.file('build/flutter_size_01/snapshot.linux-arm64.json') ..createSync(recursive: true) ..writeAsStringSync(''' [ { "l": "dart:_internal", "c": "SubListIterable", "n": "[Optimized] skip", "s": 2400 } ]'''); fileSystem.file('build/flutter_size_01/trace.linux-arm64.json') ..createSync(recursive: true) ..writeAsStringSync('{}'); }), ]); fileSystem.file('build/linux/arm64/release/bundle/libapp.so') ..createSync(recursive: true) ..writeAsBytesSync(List.filled(10000, 0)); await createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub', '--analyze-size'] ); // check if libapp.so of "build/linux/arm64/release" directory can be referenced. expect(testLogger.statusText, contains('libapp.so (Dart AOT)')); expect(usage.events, contains( const TestUsageEvent('code-size-analysis', 'linux'), )); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), Usage: () => usage, OperatingSystemUtils: () => CustomFakeOperatingSystemUtils(hostPlatform: HostPlatform.linux_arm64), }); } class CustomFakeOperatingSystemUtils extends Fake implements OperatingSystemUtils { CustomFakeOperatingSystemUtils({ HostPlatform hostPlatform = HostPlatform.linux_x64 }) : _hostPlatform = hostPlatform; final HostPlatform _hostPlatform; @override String get name => 'Linux'; @override HostPlatform get hostPlatform => _hostPlatform; @override List whichAll(String execName) => []; }