// 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. 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/platform.dart'; import 'package:flutter_tools/src/base/utils.dart'; import 'package:flutter_tools/src/cache.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/linux/cmake.dart'; import 'package:flutter_tools/src/project.dart'; import 'package:process/process.dart'; import '../../src/common.dart'; import '../../src/context.dart'; import '../../src/testbed.dart'; const String _kTestFlutterRoot = '/flutter'; final Platform linuxPlatform = FakePlatform( operatingSystem: 'linux', environment: { 'FLUTTER_ROOT': _kTestFlutterRoot } ); final Platform notLinuxPlatform = FakePlatform( operatingSystem: 'macos', environment: { 'FLUTTER_ROOT': _kTestFlutterRoot, } ); void main() { setUpAll(() { Cache.disableLocking(); }); FileSystem fileSystem; ProcessManager processManager; setUp(() { fileSystem = MemoryFileSystem.test(); Cache.flutterRoot = _kTestFlutterRoot; }); // 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({int templateVersion}) { setUpMockCoreProjectFiles(); fileSystem.file(fileSystem.path.join('linux', 'CMakeLists.txt')).createSync(recursive: true); final String versionFileSubpath = fileSystem.path.join('flutter', '.template_version'); const int expectedTemplateVersion = 10; // Arbitrary value for tests. final File sourceTemplateVersionfile = fileSystem.file(fileSystem.path.join( fileSystem.path.absolute(Cache.flutterRoot), 'packages', 'flutter_tools', 'templates', 'app', 'linux.tmpl', versionFileSubpath, )); sourceTemplateVersionfile.createSync(recursive: true); sourceTemplateVersionfile.writeAsStringSync(expectedTemplateVersion.toString()); final File projectTemplateVersionFile = fileSystem.file( fileSystem.path.join('linux', versionFileSubpath)); templateVersion ??= expectedTemplateVersion; projectTemplateVersionFile.createSync(recursive: true); projectTemplateVersionFile.writeAsStringSync(templateVersion.toString()); } // Returns the command list matching the build_linux call to cmake. List cmakeCommand(String buildMode) { return [ 'cmake', '-S', '/linux', '-B', 'build/linux/$buildMode', '-G', 'Ninja', '-DCMAKE_BUILD_TYPE=${toTitleCase(buildMode)}', ]; } // Returns the command list matching the build_linux call to ninja. List ninjaCommand(String buildMode) { return [ 'ninja', '-C', 'build/linux/$buildMode', 'install', ]; } 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')); }, 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 fails with instructions when template is too old', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(templateVersion: 1); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ), throwsToolExit(message: 'flutter create .')); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Linux build fails with instructions when template is too new', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(templateVersion: 999); expect(createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ), throwsToolExit(message: 'Upgrade Flutter')); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Linux build invokes CMake and ninja, and writes temporary files', () async { final BuildCommand command = BuildCommand(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('release')), FakeCommand(command: 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), }); testUsingContext('Handles argument error from missing cmake', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: 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), }); testUsingContext('Handles argument error from missing ninja', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('release')), FakeCommand(command: 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), }); testUsingContext('Linux build does not spew stdout to status logger', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('debug')), FakeCommand( command: 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), }); testUsingContext('Linux verbose build sets VERBOSE_SCRIPT_LOGGING', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('debug')), FakeCommand( command: 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), }); testUsingContext('Linux build --debug passes debug mode to cmake and ninja', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('debug')), FakeCommand(command: ninjaCommand('debug')), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--debug', '--no-pub'] ); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Linux build --profile passes profile mode to make', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('profile')), FakeCommand(command: ninjaCommand('profile')), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--profile', '--no-pub'] ); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('Linux build configures Makefile exports', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('release')), FakeCommand(command: ninjaCommand('release')), ]); fileSystem.file('lib/other.dart') .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', ] ); 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([ 'set(FLUTTER_ROOT "$_kTestFlutterRoot")', 'set(PROJECT_DIR "${fileSystem.currentDirectory.path}")', ' "DART_DEFINES=\\"foo.bar=2,fizz.far=3\\""', ' "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=\\"\${FLUTTER_ROOT}\\""', ' "PROJECT_DIR=\\"\${PROJECT_DIR}\\""', ' "FLUTTER_TARGET=\\"lib/other.dart\\""', ])); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); 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.current(); 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('Release build prints an under-construction warning', () async { final BuildCommand command = BuildCommand(); setUpMockProjectFilesForBuild(); processManager = FakeProcessManager.list([ FakeCommand(command: cmakeCommand('release')), FakeCommand(command: ninjaCommand('release')), ]); await createTestCommandRunner(command).run( const ['build', 'linux', '--no-pub'] ); expect(testLogger.statusText, contains('🚧')); }, overrides: { FileSystem: () => fileSystem, ProcessManager: () => processManager, Platform: () => linuxPlatform, FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), }); testUsingContext('hidden when not enabled on Linux host', () { expect(BuildLinuxCommand().hidden, true); }, overrides: { FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: false), Platform: () => notLinuxPlatform, }); testUsingContext('Not hidden when enabled and on Linux host', () { expect(BuildLinuxCommand().hidden, false); }, overrides: { FeatureFlags: () => TestFeatureFlags(isLinuxEnabled: true), Platform: () => linuxPlatform, }); }