// Copyright 2013 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/file.dart'; import 'package:file/memory.dart'; import 'package:flutter_plugin_tools/src/build_examples_command.dart'; import 'package:flutter_plugin_tools/src/common/core.dart'; import 'package:flutter_plugin_tools/src/common/plugin_utils.dart'; import 'package:test/test.dart'; import 'mocks.dart'; import 'util.dart'; void main() { group('build-example', () { late FileSystem fileSystem; late MockPlatform mockPlatform; late Directory packagesDir; late CommandRunner runner; late RecordingProcessRunner processRunner; setUp(() { fileSystem = MemoryFileSystem(); mockPlatform = MockPlatform(); packagesDir = createPackagesDirectory(fileSystem: fileSystem); processRunner = RecordingProcessRunner(); final BuildExamplesCommand command = BuildExamplesCommand( packagesDir, processRunner: processRunner, platform: mockPlatform, ); runner = CommandRunner( 'build_examples_command', 'Test for build_example_command'); runner.addCommand(command); }); test('fails if no plaform flags are passed', () async { Error? commandError; final List output = await runCapturingPrint( runner, ['build-examples'], errorHandler: (Error e) { commandError = e; }); expect(commandError, isA()); expect( output, containsAllInOrder([ contains('At least one platform must be provided'), ])); }); test('fails if building fails', () async { createFakePlugin('plugin', packagesDir, platformSupport: { platformIOS: const PlatformDetails(PlatformSupport.inline), }); processRunner .mockProcessesForExecutable[getFlutterCommand(mockPlatform)] = [ FakeProcessInfo(MockProcess(exitCode: 1), ['build']) ]; Error? commandError; final List output = await runCapturingPrint( runner, ['build-examples', '--ios'], errorHandler: (Error e) { commandError = e; }); expect(commandError, isA()); expect( output, containsAllInOrder([ contains('The following packages had errors:'), contains(' plugin:\n' ' plugin/example (iOS)'), ])); }); test('fails if a plugin has no examples', () async { createFakePlugin('plugin', packagesDir, examples: [], platformSupport: { platformIOS: const PlatformDetails(PlatformSupport.inline) }); processRunner .mockProcessesForExecutable[getFlutterCommand(mockPlatform)] = [ FakeProcessInfo(MockProcess(exitCode: 1), ['pub', 'get']) ]; Error? commandError; final List output = await runCapturingPrint( runner, ['build-examples', '--ios'], errorHandler: (Error e) { commandError = e; }); expect(commandError, isA()); expect( output, containsAllInOrder([ contains('The following packages had errors:'), contains(' plugin:\n' ' No examples found'), ])); }); test('building for iOS when plugin is not set up for iOS results in no-op', () async { mockPlatform.isMacOS = true; createFakePlugin('plugin', packagesDir); final List output = await runCapturingPrint(runner, ['build-examples', '--ios']); expect( output, containsAllInOrder([ contains('Running for plugin'), contains('iOS is not supported by this plugin'), ]), ); // Output should be empty since running build-examples --macos with no macos // implementation is a no-op. expect(processRunner.recordedCalls, orderedEquals([])); }); test('building for iOS', () async { mockPlatform.isMacOS = true; final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformIOS: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final List output = await runCapturingPrint(runner, ['build-examples', '--ios', '--enable-experiment=exp1']); expect( output, containsAllInOrder([ '\nBUILDING plugin/example for iOS', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const [ 'build', 'ios', '--no-codesign', '--enable-experiment=exp1' ], pluginExampleDirectory.path), ])); }); test( 'building for Linux when plugin is not set up for Linux results in no-op', () async { mockPlatform.isLinux = true; createFakePlugin('plugin', packagesDir); final List output = await runCapturingPrint( runner, ['build-examples', '--linux']); expect( output, containsAllInOrder([ contains('Running for plugin'), contains('Linux is not supported by this plugin'), ]), ); // Output should be empty since running build-examples --linux with no // Linux implementation is a no-op. expect(processRunner.recordedCalls, orderedEquals([])); }); test('building for Linux', () async { mockPlatform.isLinux = true; final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformLinux: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final List output = await runCapturingPrint( runner, ['build-examples', '--linux']); expect( output, containsAllInOrder([ '\nBUILDING plugin/example for Linux', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall(getFlutterCommand(mockPlatform), const ['build', 'linux'], pluginExampleDirectory.path), ])); }); test('building for macOS with no implementation results in no-op', () async { mockPlatform.isMacOS = true; createFakePlugin('plugin', packagesDir); final List output = await runCapturingPrint( runner, ['build-examples', '--macos']); expect( output, containsAllInOrder([ contains('Running for plugin'), contains('macOS is not supported by this plugin'), ]), ); // Output should be empty since running build-examples --macos with no macos // implementation is a no-op. expect(processRunner.recordedCalls, orderedEquals([])); }); test('building for macOS', () async { mockPlatform.isMacOS = true; final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformMacOS: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final List output = await runCapturingPrint( runner, ['build-examples', '--macos']); expect( output, containsAllInOrder([ '\nBUILDING plugin/example for macOS', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall(getFlutterCommand(mockPlatform), const ['build', 'macos'], pluginExampleDirectory.path), ])); }); test('building for web with no implementation results in no-op', () async { createFakePlugin('plugin', packagesDir); final List output = await runCapturingPrint(runner, ['build-examples', '--web']); expect( output, containsAllInOrder([ contains('Running for plugin'), contains('web is not supported by this plugin'), ]), ); // Output should be empty since running build-examples --macos with no macos // implementation is a no-op. expect(processRunner.recordedCalls, orderedEquals([])); }); test('building for web', () async { final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformWeb: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final List output = await runCapturingPrint(runner, ['build-examples', '--web']); expect( output, containsAllInOrder([ '\nBUILDING plugin/example for web', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall(getFlutterCommand(mockPlatform), const ['build', 'web'], pluginExampleDirectory.path), ])); }); test( 'building for Windows when plugin is not set up for Windows results in no-op', () async { mockPlatform.isWindows = true; createFakePlugin('plugin', packagesDir); final List output = await runCapturingPrint( runner, ['build-examples', '--windows']); expect( output, containsAllInOrder([ contains('Running for plugin'), contains('Windows is not supported by this plugin'), ]), ); // Output should be empty since running build-examples --windows with no // Windows implementation is a no-op. expect(processRunner.recordedCalls, orderedEquals([])); }); test('building for Windows', () async { mockPlatform.isWindows = true; final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformWindows: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final List output = await runCapturingPrint( runner, ['build-examples', '--windows']); expect( output, containsAllInOrder([ '\nBUILDING plugin/example for Windows', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const ['build', 'windows'], pluginExampleDirectory.path), ])); }); test( 'building for Android when plugin is not set up for Android results in no-op', () async { createFakePlugin('plugin', packagesDir); final List output = await runCapturingPrint(runner, ['build-examples', '--apk']); expect( output, containsAllInOrder([ contains('Running for plugin'), contains('Android is not supported by this plugin'), ]), ); // Output should be empty since running build-examples --macos with no macos // implementation is a no-op. expect(processRunner.recordedCalls, orderedEquals([])); }); test('building for Android', () async { final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformAndroid: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final List output = await runCapturingPrint(runner, [ 'build-examples', '--apk', ]); expect( output, containsAllInOrder([ '\nBUILDING plugin/example for Android (apk)', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall(getFlutterCommand(mockPlatform), const ['build', 'apk'], pluginExampleDirectory.path), ])); }); test('enable-experiment flag for Android', () async { final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformAndroid: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); await runCapturingPrint(runner, ['build-examples', '--apk', '--enable-experiment=exp1']); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const ['build', 'apk', '--enable-experiment=exp1'], pluginExampleDirectory.path), ])); }); test('enable-experiment flag for ios', () async { final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformIOS: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); await runCapturingPrint(runner, ['build-examples', '--ios', '--enable-experiment=exp1']); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const [ 'build', 'ios', '--no-codesign', '--enable-experiment=exp1' ], pluginExampleDirectory.path), ])); }); test('logs skipped platforms', () async { createFakePlugin('plugin', packagesDir, platformSupport: { platformAndroid: const PlatformDetails(PlatformSupport.inline), }); final List output = await runCapturingPrint( runner, ['build-examples', '--apk', '--ios', '--macos']); expect( output, containsAllInOrder([ contains('Skipping unsupported platform(s): iOS, macOS'), ]), ); }); group('packages', () { test('builds when requested platform is supported by example', () async { final RepositoryPackage package = createFakePackage( 'package', packagesDir, isFlutter: true, extraFiles: [ 'example/ios/Runner.xcodeproj/project.pbxproj' ]); final List output = await runCapturingPrint( runner, ['build-examples', '--ios']); expect( output, containsAllInOrder([ contains('Running for package'), contains('BUILDING package/example for iOS'), ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const [ 'build', 'ios', '--no-codesign', ], getExampleDir(package).path), ])); }); test('skips non-Flutter examples', () async { createFakePackage('package', packagesDir); final List output = await runCapturingPrint( runner, ['build-examples', '--ios']); expect( output, containsAllInOrder([ contains('Running for package'), contains('No examples found supporting requested platform(s).'), ]), ); expect(processRunner.recordedCalls, orderedEquals([])); }); test('skips when there is no example', () async { createFakePackage('package', packagesDir, isFlutter: true, examples: []); final List output = await runCapturingPrint( runner, ['build-examples', '--ios']); expect( output, containsAllInOrder([ contains('Running for package'), contains('No examples found supporting requested platform(s).'), ]), ); expect(processRunner.recordedCalls, orderedEquals([])); }); test('skip when example does not support requested platform', () async { createFakePackage('package', packagesDir, isFlutter: true, extraFiles: ['example/linux/CMakeLists.txt']); final List output = await runCapturingPrint( runner, ['build-examples', '--ios']); expect( output, containsAllInOrder([ contains('Running for package'), contains('Skipping iOS for package/example; not supported.'), contains('No examples found supporting requested platform(s).'), ]), ); expect(processRunner.recordedCalls, orderedEquals([])); }); test('logs skipped platforms when only some are supported', () async { final RepositoryPackage package = createFakePackage( 'package', packagesDir, isFlutter: true, extraFiles: ['example/linux/CMakeLists.txt']); final List output = await runCapturingPrint( runner, ['build-examples', '--apk', '--linux']); expect( output, containsAllInOrder([ contains('Running for package'), contains('Building for: Android, Linux'), contains('Skipping Android for package/example; not supported.'), ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const ['build', 'linux'], getExampleDir(package).path), ])); }); }); test('The .pluginToolsConfig.yaml file', () async { mockPlatform.isLinux = true; final RepositoryPackage plugin = createFakePlugin('plugin', packagesDir, platformSupport: { platformLinux: const PlatformDetails(PlatformSupport.inline), platformMacOS: const PlatformDetails(PlatformSupport.inline), }); final Directory pluginExampleDirectory = getExampleDir(plugin); final File pluginExampleConfigFile = pluginExampleDirectory.childFile('.pluginToolsConfig.yaml'); pluginExampleConfigFile .writeAsStringSync('buildFlags:\n global:\n - "test argument"'); final List output = [ ...await runCapturingPrint( runner, ['build-examples', '--linux']), ...await runCapturingPrint( runner, ['build-examples', '--macos']), ]; expect( output, containsAllInOrder([ '\nBUILDING plugin/example for Linux', '\nBUILDING plugin/example for macOS', ]), ); expect( processRunner.recordedCalls, orderedEquals([ ProcessCall( getFlutterCommand(mockPlatform), const ['build', 'linux', 'test argument'], pluginExampleDirectory.path), ProcessCall( getFlutterCommand(mockPlatform), const ['build', 'macos', 'test argument'], pluginExampleDirectory.path), ])); }); }); }