blob: c10e220cb0985c0400119a3cca037ce4fefe09ed [file] [log] [blame]
// 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 'dart:async';
import 'dart:io' as io;
import 'package:http/http.dart';
import 'package:path/path.dart' as path;
import 'browser_lock.dart';
import 'common.dart';
import 'environment.dart';
/// Returns the installation of Edge.
/// Currently uses the Edge version installed on the operating system.
/// As explained on the Microsoft help page: `Microsoft Edge comes
/// exclusively with Windows 10 and cannot be downloaded or installed separately.`
/// See:
// TODO(yjbanov): Investigate running tests for the tech preview downloads
// from the beta channel.
Future<BrowserInstallation> getEdgeInstallation(
String requestedVersion, {
StringSink? infoLog,
}) async {
// For now these tests are aimed to run only on Windows machines local or on LUCI/CI.
// In the future we can investigate to run them on Android or on MacOS.
if (!io.Platform.isWindows) {
throw UnimplementedError(
'Tests for Edge on ${io.Platform.operatingSystem} is'
' not supported.');
infoLog ??= io.stdout;
if (requestedVersion == 'system') {
// Since Edge is included in Windows, always assume there will be one on the
// system.
infoLog.writeln('Using the system version that is already installed.');
final EdgeLauncher edgeLauncher = EdgeLauncher();
if (edgeLauncher.isInstalled) {
infoLog.writeln('Launcher installation was skipped, already installed.');
} else {
infoLog.writeln('Installing MicrosoftEdgeLauncher');
await edgeLauncher.install();
'Installations complete. To launch it run ${edgeLauncher.executable}');
return BrowserInstallation(
version: 'system',
executable: io.Directory(path.join(
} else {
infoLog.writeln('Unsupported version $requestedVersion.');
throw UnimplementedError();
/// `MicrosoftEdgeLauncher` is an executable for launching Edge.
/// It is useful for starting Edge from comand line or from a
/// batch script.
/// See:
class EdgeLauncher {
/// Path to the directory that contains `MicrosoftEdgeLauncher.exe`.
io.Directory get launcherInstallationDir => io.Directory(
path.join(environment.webUiDartToolDir.path, 'microsoftedgelauncher',
io.File get executable => io.File(
path.join(launcherInstallationDir.path, 'MicrosoftEdgeLauncher.exe'));
bool get isInstalled => executable.existsSync();
/// Version number launcher executable `MicrosoftEdgeLauncher`.
String get version => browserLock.edgeLock.launcherVersion;
/// Url for downloading `MicrosoftEdgeLauncher`.
/// Only useful in Windows, hence not added to [PlatformBinding].
String get windowsEdgeLauncherDownloadUrl =>
/// Install the launcher if it does not exist in this system.
Future<void> install() async {
// Checks if the `MicrosoftEdgeLauncher` executable exists.
if (isInstalled) {
// Create directory for download.
if (!launcherInstallationDir.existsSync()) {
launcherInstallationDir.createSync(recursive: true);
final Client client = Client();
try {
// Download executable from Github.
final StreamedResponse download = await client.send(Request(
} finally {