packages/flutter_tools/lib/src/build_info.dart - mirrors/flutter - Git at Google

 // Copyright 2015 The Chromium 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 'base/context.dart';
 import 'base/file_system.dart';
 import 'base/platform.dart';
 import 'base/utils.dart';
 import 'globals.dart';

 /// Information about a build to be performed or used.
 class BuildInfo {
   const BuildInfo(
     this.mode,
     this.flavor, {
     this.trackWidgetCreation = false,
     this.compilationTraceFilePath,
     this.createBaseline = false,
     this.createPatch = false,
     this.patchNumber,
     this.patchDir,
     this.baselineDir,
     this.extraFrontEndOptions,
     this.extraGenSnapshotOptions,
     this.buildSharedLibrary,
     this.targetPlatform,
     this.fileSystemRoots,
     this.fileSystemScheme,
     this.buildNumber,
     this.buildName,
   });

   final BuildMode mode;

   /// Represents a custom Android product flavor or an Xcode scheme, null for
   /// using the default.
   ///
   /// If not null, the Gradle build task will be `assembleFlavorMode` (e.g.
   /// `assemblePaidRelease`), and the Xcode build configuration will be
   /// Mode-Flavor (e.g. Release-Paid).
   final String flavor;

   final List<String> fileSystemRoots;
   final String fileSystemScheme;

   /// Whether the build should track widget creation locations.
   final bool trackWidgetCreation;

   /// Dart compilation trace file to use for JIT VM snapshot.
   final String compilationTraceFilePath;

   /// Save baseline package.
   final bool createBaseline;

   /// Build differential snapshot.
   final bool createPatch;

   /// Internal version number of dynamic patch (not displayed to users).
   /// Each patch may have a unique number to differentiate from previous
   /// patches for the same versionCode on Android or CFBundleVersion on iOS.
   final int patchNumber;

   /// The directory where to store generated dynamic patches.
   final String patchDir;

   /// The directory where to store generated baseline packages.
   /// Built packages, such as APK files on Android, are saved and can be used
   /// to generate dynamic patches in later builds.
   final String baselineDir;

   /// Extra command-line options for front-end.
   final String extraFrontEndOptions;

   /// Extra command-line options for gen_snapshot.
   final String extraGenSnapshotOptions;

   /// Whether to prefer AOT compiling to a *so file.
   final bool buildSharedLibrary;

   /// Target platform for the build (e.g. android_arm versus android_arm64).
   final TargetPlatform targetPlatform;

   /// Internal version number (not displayed to users).
   /// Each build must have a unique number to differentiate it from previous builds.
   /// It is used to determine whether one build is more recent than another, with higher numbers indicating more recent build.
   /// On Android it is used as versionCode.
   /// On Xcode builds it is used as CFBundleVersion.
   final String buildNumber;

   /// A "x.y.z" string used as the version number shown to users.
   /// For each new version of your app, you will provide a version number to differentiate it from previous versions.
   /// On Android it is used as versionName.
   /// On Xcode builds it is used as CFBundleShortVersionString,
   final String buildName;

   static const BuildInfo debug = BuildInfo(BuildMode.debug, null);
   static const BuildInfo profile = BuildInfo(BuildMode.profile, null);
   static const BuildInfo release = BuildInfo(BuildMode.release, null);
   static const BuildInfo dynamicProfile = BuildInfo(BuildMode.dynamicProfile, null);
   static const BuildInfo dynamicRelease = BuildInfo(BuildMode.dynamicRelease, null);

   /// Returns whether a debug build is requested.
   ///
   /// Exactly one of [isDebug], [isProfile], or [isRelease] is true.
   bool get isDebug => mode == BuildMode.debug;

   /// Returns whether a profile build is requested.
   ///
   /// Exactly one of [isDebug], [isProfile], or [isRelease] is true.
   bool get isProfile => mode == BuildMode.profile || mode == BuildMode.dynamicProfile;

   /// Returns whether a release build is requested.
   ///
   /// Exactly one of [isDebug], [isProfile], or [isRelease] is true.
   bool get isRelease => mode == BuildMode.release || mode == BuildMode.dynamicRelease;

   /// Returns whether a dynamic build is requested.
   bool get isDynamic => mode == BuildMode.dynamicProfile || mode == BuildMode.dynamicRelease;

   bool get usesAot => isAotBuildMode(mode);
   bool get supportsEmulator => isEmulatorBuildMode(mode);
   bool get supportsSimulator => isEmulatorBuildMode(mode);
   String get modeName => getModeName(mode);
   String get friendlyModeName => getFriendlyModeName(mode);

   BuildInfo withTargetPlatform(TargetPlatform targetPlatform) =>
       BuildInfo(mode, flavor,
           trackWidgetCreation: trackWidgetCreation,
           compilationTraceFilePath: compilationTraceFilePath,
           createPatch: createPatch,
           extraFrontEndOptions: extraFrontEndOptions,
           extraGenSnapshotOptions: extraGenSnapshotOptions,
           buildSharedLibrary: buildSharedLibrary,
           targetPlatform: targetPlatform);
 }

 /// The type of build.
 enum BuildMode {
   debug,
   profile,
   release,
   dynamicProfile,
   dynamicRelease
 }

 String validatedBuildNumberForPlatform(TargetPlatform targetPlatform, String buildNumber) {
   if (buildNumber == null) {
     return null;
   }
   if (targetPlatform == TargetPlatform.ios ||
       targetPlatform == TargetPlatform.darwin_x64) {
     // See CFBundleVersion at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
     final RegExp disallowed = RegExp(r'[^\d\.]');
     String tmpBuildNumber = buildNumber.replaceAll(disallowed, '');
     final List<String> segments = tmpBuildNumber
         .split('.')
         .where((String segment) => segment.isNotEmpty)
         .toList();
     if (segments.isEmpty) {
       segments.add('0');
     }
     tmpBuildNumber = segments.join('.');
     if (tmpBuildNumber != buildNumber) {
       printTrace('Invalid build-number: $buildNumber for iOS/macOS, overridden by $tmpBuildNumber.\n'
           'See CFBundleVersion at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html');
     }
     return tmpBuildNumber;
   }
   if (targetPlatform == TargetPlatform.android_arm ||
       targetPlatform == TargetPlatform.android_arm64 ||
       targetPlatform == TargetPlatform.android_x64 ||
       targetPlatform == TargetPlatform.android_x86) {
     // See versionCode at https://developer.android.com/studio/publish/versioning
     final RegExp disallowed = RegExp(r'[^\d]');
     String tmpBuildNumberStr = buildNumber.replaceAll(disallowed, '');
     int tmpBuildNumberInt = int.tryParse(tmpBuildNumberStr) ?? 0;
     if (tmpBuildNumberInt < 1) {
       tmpBuildNumberInt = 1;
     }
     tmpBuildNumberStr = tmpBuildNumberInt.toString();
     if (tmpBuildNumberStr != buildNumber) {
       printTrace('Invalid build-number: $buildNumber for Android, overridden by $tmpBuildNumberStr.\n'
           'See versionCode at https://developer.android.com/studio/publish/versioning');
     }
     return tmpBuildNumberStr;
   }
   return buildNumber;
 }

 String validatedBuildNameForPlatform(TargetPlatform targetPlatform, String buildName) {
   if (buildName == null) {
     return null;
   }
   if (targetPlatform == TargetPlatform.ios ||
       targetPlatform == TargetPlatform.darwin_x64) {
     // See CFBundleShortVersionString at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
     final RegExp disallowed = RegExp(r'[^\d\.]');
     String tmpBuildName = buildName.replaceAll(disallowed, '');
     final List<String> segments = tmpBuildName
         .split('.')
         .where((String segment) => segment.isNotEmpty)
         .toList();
     while (segments.length < 3) {
       segments.add('0');
     }
     tmpBuildName = segments.join('.');
     if (tmpBuildName != buildName) {
       printTrace('Invalid build-name: $buildName for iOS/macOS, overridden by $tmpBuildName.\n'
           'See CFBundleShortVersionString at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html');
     }
     return tmpBuildName;
   }
   if (targetPlatform == TargetPlatform.android_arm ||
       targetPlatform == TargetPlatform.android_arm64 ||
       targetPlatform == TargetPlatform.android_x64 ||
       targetPlatform == TargetPlatform.android_x86) {
     // See versionName at https://developer.android.com/studio/publish/versioning
     return buildName;
   }
   return buildName;
 }

 String getModeName(BuildMode mode) => getEnumName(mode);

 String getFriendlyModeName(BuildMode mode) {
   return snakeCase(getModeName(mode)).replaceAll('_', ' ');
 }

 // Returns true if the selected build mode uses ahead-of-time compilation.
 bool isAotBuildMode(BuildMode mode) {
   return mode == BuildMode.profile || mode == BuildMode.release;
 }

 // Returns true if the given build mode can be used on emulators / simulators.
 bool isEmulatorBuildMode(BuildMode mode) {
   return mode == BuildMode.debug ||
     mode == BuildMode.dynamicRelease ||
     mode == BuildMode.dynamicProfile;
 }

 enum HostPlatform {
   darwin_x64,
   linux_x64,
   windows_x64,
 }

 String getNameForHostPlatform(HostPlatform platform) {
   switch (platform) {
     case HostPlatform.darwin_x64:
       return 'darwin-x64';
     case HostPlatform.linux_x64:
       return 'linux-x64';
     case HostPlatform.windows_x64:
       return 'windows-x64';
   }
   assert(false);
   return null;
 }

 enum TargetPlatform {
   android_arm,
   android_arm64,
   android_x64,
   android_x86,
   ios,
   darwin_x64,
   linux_x64,
   windows_x64,
   fuchsia,
   tester,
   web,
 }

 /// iOS target device architecture.
 //
 // TODO(cbracken): split TargetPlatform.ios into ios_armv7, ios_arm64.
 enum IOSArch {
   armv7,
   arm64,
 }

 /// The default set of iOS device architectures to build for.
 const List<IOSArch> defaultIOSArchs = <IOSArch>[
   IOSArch.arm64,
 ];

 String getNameForIOSArch(IOSArch arch) {
   switch (arch) {
     case IOSArch.armv7:
       return 'armv7';
     case IOSArch.arm64:
       return 'arm64';
   }
   assert(false);
   return null;
 }

 IOSArch getIOSArchForName(String arch) {
   switch (arch) {
     case 'armv7':
       return IOSArch.armv7;
     case 'arm64':
       return IOSArch.arm64;
   }
   assert(false);
   return null;
 }

 String getNameForTargetPlatform(TargetPlatform platform) {
   switch (platform) {
     case TargetPlatform.android_arm:
       return 'android-arm';
     case TargetPlatform.android_arm64:
       return 'android-arm64';
     case TargetPlatform.android_x64:
       return 'android-x64';
     case TargetPlatform.android_x86:
       return 'android-x86';
     case TargetPlatform.ios:
       return 'ios';
     case TargetPlatform.darwin_x64:
       return 'darwin-x64';
     case TargetPlatform.linux_x64:
       return 'linux-x64';
     case TargetPlatform.windows_x64:
       return 'windows-x64';
     case TargetPlatform.fuchsia:
       return 'fuchsia';
     case TargetPlatform.tester:
       return 'flutter-tester';
     case TargetPlatform.web:
       return 'web';
   }
   assert(false);
   return null;
 }

 TargetPlatform getTargetPlatformForName(String platform) {
   switch (platform) {
     case 'android-arm':
       return TargetPlatform.android_arm;
     case 'android-arm64':
       return TargetPlatform.android_arm64;
     case 'android-x64':
       return TargetPlatform.android_x64;
     case 'android-x86':
       return TargetPlatform.android_x86;
     case 'ios':
       return TargetPlatform.ios;
     case 'darwin-x64':
       return TargetPlatform.darwin_x64;
     case 'linux-x64':
       return TargetPlatform.linux_x64;
     case 'web':
       return TargetPlatform.web;
   }
   assert(platform != null);
   return null;
 }

 HostPlatform getCurrentHostPlatform() {
   if (platform.isMacOS)
     return HostPlatform.darwin_x64;
   if (platform.isLinux)
     return HostPlatform.linux_x64;
   if (platform.isWindows)
     return HostPlatform.windows_x64;

   printError('Unsupported host platform, defaulting to Linux');

   return HostPlatform.linux_x64;
 }

 /// Returns the top-level build output directory.
 String getBuildDirectory() {
   // TODO(johnmccutchan): Stop calling this function as part of setting
   // up command line argument processing.
   if (context == null || config == null)
     return 'build';

   final String buildDir = config.getValue('build-dir') ?? 'build';
   if (fs.path.isAbsolute(buildDir)) {
     throw Exception(
         'build-dir config setting in ${config.configPath} must be relative');
   }
   return buildDir;
 }

 /// Returns the Android build output directory.
 String getAndroidBuildDirectory() {
   // TODO(cbracken): move to android subdir.
   return getBuildDirectory();
 }

 /// Returns the AOT build output directory.
 String getAotBuildDirectory() {
   return fs.path.join(getBuildDirectory(), 'aot');
 }

 /// Returns the asset build output directory.
 String getAssetBuildDirectory() {
   return fs.path.join(getBuildDirectory(), 'flutter_assets');
 }

 /// Returns the iOS build output directory.
 String getIosBuildDirectory() {
   return fs.path.join(getBuildDirectory(), 'ios');
 }

 /// Returns the web build output directory.
 String getWebBuildDirectory() {
   return fs.path.join(getBuildDirectory(), 'web');
 }

 /// Returns directory used by incremental compiler (IKG - incremental kernel
 /// generator) to store cached intermediate state.
 String getIncrementalCompilerByteStoreDirectory() {
   return fs.path.join(getBuildDirectory(), 'ikg_byte_store');
 }
	// Copyright 2015 The Chromium 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 'base/context.dart';
	import 'base/file_system.dart';
	import 'base/platform.dart';
	import 'base/utils.dart';
	import 'globals.dart';

	/// Information about a build to be performed or used.
	class BuildInfo {
	const BuildInfo(
	this.mode,
	this.flavor, {
	this.trackWidgetCreation = false,
	this.compilationTraceFilePath,
	this.createBaseline = false,
	this.createPatch = false,
	this.patchNumber,
	this.patchDir,
	this.baselineDir,
	this.extraFrontEndOptions,
	this.extraGenSnapshotOptions,
	this.buildSharedLibrary,
	this.targetPlatform,
	this.fileSystemRoots,
	this.fileSystemScheme,
	this.buildNumber,
	this.buildName,
	});

	final BuildMode mode;

	/// Represents a custom Android product flavor or an Xcode scheme, null for
	/// using the default.
	///
	/// If not null, the Gradle build task will be `assembleFlavorMode` (e.g.
	/// `assemblePaidRelease`), and the Xcode build configuration will be
	/// Mode-Flavor (e.g. Release-Paid).
	final String flavor;

	final List<String> fileSystemRoots;
	final String fileSystemScheme;

	/// Whether the build should track widget creation locations.
	final bool trackWidgetCreation;

	/// Dart compilation trace file to use for JIT VM snapshot.
	final String compilationTraceFilePath;

	/// Save baseline package.
	final bool createBaseline;

	/// Build differential snapshot.
	final bool createPatch;

	/// Internal version number of dynamic patch (not displayed to users).
	/// Each patch may have a unique number to differentiate from previous
	/// patches for the same versionCode on Android or CFBundleVersion on iOS.
	final int patchNumber;

	/// The directory where to store generated dynamic patches.
	final String patchDir;

	/// The directory where to store generated baseline packages.
	/// Built packages, such as APK files on Android, are saved and can be used
	/// to generate dynamic patches in later builds.
	final String baselineDir;

	/// Extra command-line options for front-end.
	final String extraFrontEndOptions;

	/// Extra command-line options for gen_snapshot.
	final String extraGenSnapshotOptions;

	/// Whether to prefer AOT compiling to a *so file.
	final bool buildSharedLibrary;

	/// Target platform for the build (e.g. android_arm versus android_arm64).
	final TargetPlatform targetPlatform;

	/// Internal version number (not displayed to users).
	/// Each build must have a unique number to differentiate it from previous builds.
	/// It is used to determine whether one build is more recent than another, with higher numbers indicating more recent build.
	/// On Android it is used as versionCode.
	/// On Xcode builds it is used as CFBundleVersion.
	final String buildNumber;

	/// A "x.y.z" string used as the version number shown to users.
	/// For each new version of your app, you will provide a version number to differentiate it from previous versions.
	/// On Android it is used as versionName.
	/// On Xcode builds it is used as CFBundleShortVersionString,
	final String buildName;

	static const BuildInfo debug = BuildInfo(BuildMode.debug, null);
	static const BuildInfo profile = BuildInfo(BuildMode.profile, null);
	static const BuildInfo release = BuildInfo(BuildMode.release, null);
	static const BuildInfo dynamicProfile = BuildInfo(BuildMode.dynamicProfile, null);
	static const BuildInfo dynamicRelease = BuildInfo(BuildMode.dynamicRelease, null);

	/// Returns whether a debug build is requested.
	///
	/// Exactly one of [isDebug], [isProfile], or [isRelease] is true.
	bool get isDebug => mode == BuildMode.debug;

	/// Returns whether a profile build is requested.
	///
	/// Exactly one of [isDebug], [isProfile], or [isRelease] is true.
	bool get isProfile => mode == BuildMode.profile \|\| mode == BuildMode.dynamicProfile;

	/// Returns whether a release build is requested.
	///
	/// Exactly one of [isDebug], [isProfile], or [isRelease] is true.
	bool get isRelease => mode == BuildMode.release \|\| mode == BuildMode.dynamicRelease;

	/// Returns whether a dynamic build is requested.
	bool get isDynamic => mode == BuildMode.dynamicProfile \|\| mode == BuildMode.dynamicRelease;

	bool get usesAot => isAotBuildMode(mode);
	bool get supportsEmulator => isEmulatorBuildMode(mode);
	bool get supportsSimulator => isEmulatorBuildMode(mode);
	String get modeName => getModeName(mode);
	String get friendlyModeName => getFriendlyModeName(mode);

	BuildInfo withTargetPlatform(TargetPlatform targetPlatform) =>
	BuildInfo(mode, flavor,
	trackWidgetCreation: trackWidgetCreation,
	compilationTraceFilePath: compilationTraceFilePath,
	createPatch: createPatch,
	extraFrontEndOptions: extraFrontEndOptions,
	extraGenSnapshotOptions: extraGenSnapshotOptions,
	buildSharedLibrary: buildSharedLibrary,
	targetPlatform: targetPlatform);
	}

	/// The type of build.
	enum BuildMode {
	debug,
	profile,
	release,
	dynamicProfile,
	dynamicRelease
	}

	String validatedBuildNumberForPlatform(TargetPlatform targetPlatform, String buildNumber) {
	if (buildNumber == null) {
	return null;
	}
	if (targetPlatform == TargetPlatform.ios \|\|
	targetPlatform == TargetPlatform.darwin_x64) {
	// See CFBundleVersion at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
	final RegExp disallowed = RegExp(r'[^\d\.]');
	String tmpBuildNumber = buildNumber.replaceAll(disallowed, '');
	final List<String> segments = tmpBuildNumber
	.split('.')
	.where((String segment) => segment.isNotEmpty)
	.toList();
	if (segments.isEmpty) {
	segments.add('0');
	}
	tmpBuildNumber = segments.join('.');
	if (tmpBuildNumber != buildNumber) {
	printTrace('Invalid build-number: $buildNumber for iOS/macOS, overridden by $tmpBuildNumber.\n'
	'See CFBundleVersion at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html');
	}
	return tmpBuildNumber;
	}
	if (targetPlatform == TargetPlatform.android_arm \|\|
	targetPlatform == TargetPlatform.android_arm64 \|\|
	targetPlatform == TargetPlatform.android_x64 \|\|
	targetPlatform == TargetPlatform.android_x86) {
	// See versionCode at https://developer.android.com/studio/publish/versioning
	final RegExp disallowed = RegExp(r'[^\d]');
	String tmpBuildNumberStr = buildNumber.replaceAll(disallowed, '');
	int tmpBuildNumberInt = int.tryParse(tmpBuildNumberStr) ?? 0;
	if (tmpBuildNumberInt < 1) {
	tmpBuildNumberInt = 1;
	}
	tmpBuildNumberStr = tmpBuildNumberInt.toString();
	if (tmpBuildNumberStr != buildNumber) {
	printTrace('Invalid build-number: $buildNumber for Android, overridden by $tmpBuildNumberStr.\n'
	'See versionCode at https://developer.android.com/studio/publish/versioning');
	}
	return tmpBuildNumberStr;
	}
	return buildNumber;
	}

	String validatedBuildNameForPlatform(TargetPlatform targetPlatform, String buildName) {
	if (buildName == null) {
	return null;
	}
	if (targetPlatform == TargetPlatform.ios \|\|
	targetPlatform == TargetPlatform.darwin_x64) {
	// See CFBundleShortVersionString at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
	final RegExp disallowed = RegExp(r'[^\d\.]');
	String tmpBuildName = buildName.replaceAll(disallowed, '');
	final List<String> segments = tmpBuildName
	.split('.')
	.where((String segment) => segment.isNotEmpty)
	.toList();
	while (segments.length < 3) {
	segments.add('0');
	}
	tmpBuildName = segments.join('.');
	if (tmpBuildName != buildName) {
	printTrace('Invalid build-name: $buildName for iOS/macOS, overridden by $tmpBuildName.\n'
	'See CFBundleShortVersionString at https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html');
	}
	return tmpBuildName;
	}
	if (targetPlatform == TargetPlatform.android_arm \|\|
	targetPlatform == TargetPlatform.android_arm64 \|\|
	targetPlatform == TargetPlatform.android_x64 \|\|
	targetPlatform == TargetPlatform.android_x86) {
	// See versionName at https://developer.android.com/studio/publish/versioning
	return buildName;
	}
	return buildName;
	}

	String getModeName(BuildMode mode) => getEnumName(mode);

	String getFriendlyModeName(BuildMode mode) {
	return snakeCase(getModeName(mode)).replaceAll('_', ' ');
	}

	// Returns true if the selected build mode uses ahead-of-time compilation.
	bool isAotBuildMode(BuildMode mode) {
	return mode == BuildMode.profile \|\| mode == BuildMode.release;
	}

	// Returns true if the given build mode can be used on emulators / simulators.
	bool isEmulatorBuildMode(BuildMode mode) {
	return mode == BuildMode.debug \|\|
	mode == BuildMode.dynamicRelease \|\|
	mode == BuildMode.dynamicProfile;
	}

	enum HostPlatform {
	darwin_x64,
	linux_x64,
	windows_x64,
	}

	String getNameForHostPlatform(HostPlatform platform) {
	switch (platform) {
	case HostPlatform.darwin_x64:
	return 'darwin-x64';
	case HostPlatform.linux_x64:
	return 'linux-x64';
	case HostPlatform.windows_x64:
	return 'windows-x64';
	}
	assert(false);
	return null;
	}

	enum TargetPlatform {
	android_arm,
	android_arm64,
	android_x64,
	android_x86,
	ios,
	darwin_x64,
	linux_x64,
	windows_x64,
	fuchsia,
	tester,
	web,
	}

	/// iOS target device architecture.
	//
	// TODO(cbracken): split TargetPlatform.ios into ios_armv7, ios_arm64.
	enum IOSArch {
	armv7,
	arm64,
	}

	/// The default set of iOS device architectures to build for.
	const List<IOSArch> defaultIOSArchs = <IOSArch>[
	IOSArch.arm64,
	];

	String getNameForIOSArch(IOSArch arch) {
	switch (arch) {
	case IOSArch.armv7:
	return 'armv7';
	case IOSArch.arm64:
	return 'arm64';
	}
	assert(false);
	return null;
	}

	IOSArch getIOSArchForName(String arch) {
	switch (arch) {
	case 'armv7':
	return IOSArch.armv7;
	case 'arm64':
	return IOSArch.arm64;
	}
	assert(false);
	return null;
	}

	String getNameForTargetPlatform(TargetPlatform platform) {
	switch (platform) {
	case TargetPlatform.android_arm:
	return 'android-arm';
	case TargetPlatform.android_arm64:
	return 'android-arm64';
	case TargetPlatform.android_x64:
	return 'android-x64';
	case TargetPlatform.android_x86:
	return 'android-x86';
	case TargetPlatform.ios:
	return 'ios';
	case TargetPlatform.darwin_x64:
	return 'darwin-x64';
	case TargetPlatform.linux_x64:
	return 'linux-x64';
	case TargetPlatform.windows_x64:
	return 'windows-x64';
	case TargetPlatform.fuchsia:
	return 'fuchsia';
	case TargetPlatform.tester:
	return 'flutter-tester';
	case TargetPlatform.web:
	return 'web';
	}
	assert(false);
	return null;
	}

	TargetPlatform getTargetPlatformForName(String platform) {
	switch (platform) {
	case 'android-arm':
	return TargetPlatform.android_arm;
	case 'android-arm64':
	return TargetPlatform.android_arm64;
	case 'android-x64':
	return TargetPlatform.android_x64;
	case 'android-x86':
	return TargetPlatform.android_x86;
	case 'ios':
	return TargetPlatform.ios;
	case 'darwin-x64':
	return TargetPlatform.darwin_x64;
	case 'linux-x64':
	return TargetPlatform.linux_x64;
	case 'web':
	return TargetPlatform.web;
	}
	assert(platform != null);
	return null;
	}

	HostPlatform getCurrentHostPlatform() {
	if (platform.isMacOS)
	return HostPlatform.darwin_x64;
	if (platform.isLinux)
	return HostPlatform.linux_x64;
	if (platform.isWindows)
	return HostPlatform.windows_x64;

	printError('Unsupported host platform, defaulting to Linux');

	return HostPlatform.linux_x64;
	}

	/// Returns the top-level build output directory.
	String getBuildDirectory() {
	// TODO(johnmccutchan): Stop calling this function as part of setting
	// up command line argument processing.
	if (context == null \|\| config == null)
	return 'build';

	final String buildDir = config.getValue('build-dir') ?? 'build';
	if (fs.path.isAbsolute(buildDir)) {
	throw Exception(
	'build-dir config setting in ${config.configPath} must be relative');
	}
	return buildDir;
	}

	/// Returns the Android build output directory.
	String getAndroidBuildDirectory() {
	// TODO(cbracken): move to android subdir.
	return getBuildDirectory();
	}

	/// Returns the AOT build output directory.
	String getAotBuildDirectory() {
	return fs.path.join(getBuildDirectory(), 'aot');
	}

	/// Returns the asset build output directory.
	String getAssetBuildDirectory() {
	return fs.path.join(getBuildDirectory(), 'flutter_assets');
	}

	/// Returns the iOS build output directory.
	String getIosBuildDirectory() {
	return fs.path.join(getBuildDirectory(), 'ios');
	}

	/// Returns the web build output directory.
	String getWebBuildDirectory() {
	return fs.path.join(getBuildDirectory(), 'web');
	}

	/// Returns directory used by incremental compiler (IKG - incremental kernel
	/// generator) to store cached intermediate state.
	String getIncrementalCompilerByteStoreDirectory() {
	return fs.path.join(getBuildDirectory(), 'ikg_byte_store');
	}