// Copyright 2016 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 'dart:async'; import 'dart:convert' show BASE64, UTF8; import 'package:path/path.dart' as path; import 'base/context.dart'; import 'base/file_system.dart'; import 'base/io.dart'; import 'build_info.dart'; import 'dart/package_map.dart'; import 'asset.dart'; import 'globals.dart'; import 'vmservice.dart'; typedef void DevFSProgressReporter(int progress, int max); class DevFSConfig { /// Should DevFS assume that symlink targets are stable? bool cacheSymlinks = false; /// Should DevFS assume that there are no symlinks to directories? bool noDirectorySymlinks = false; } DevFSConfig get devFSConfig => context[DevFSConfig]; // A file that has been added to a DevFS. class DevFSEntry { DevFSEntry(this.devicePath, this.file) : bundleEntry = null; DevFSEntry.bundle(this.devicePath, AssetBundleEntry bundleEntry) : bundleEntry = bundleEntry, file = bundleEntry.file; final String devicePath; final AssetBundleEntry bundleEntry; String get assetPath => bundleEntry.archivePath; final FileSystemEntity file; FileSystemEntity _linkTarget; FileStat _fileStat; // When we scanned for files, did this still exist? bool _exists = false; DateTime get lastModified => _fileStat?.modified; bool get _isSourceEntry => file == null; bool get _isAssetEntry => bundleEntry != null; bool get stillExists { if (_isSourceEntry) return true; _stat(); return _fileStat.type != FileSystemEntityType.NOT_FOUND; } bool get isModified { if (_isSourceEntry) return true; if (_fileStat == null) { _stat(); return true; } FileStat _oldFileStat = _fileStat; _stat(); return _fileStat.modified.isAfter(_oldFileStat.modified); } int get size { if (_isSourceEntry) { return bundleEntry.contentsLength; } else { if (_fileStat == null) { _stat(); } return _fileStat.size; } } void _stat() { if (_isSourceEntry) return; if (_linkTarget != null) { // Stat the cached symlink target. _fileStat = _linkTarget.statSync(); return; } _fileStat = file.statSync(); if (_fileStat.type == FileSystemEntityType.LINK) { // Resolve, stat, and maybe cache the symlink target. String resolved = file.resolveSymbolicLinksSync(); FileSystemEntity linkTarget = fs.file(resolved); // Stat the link target. _fileStat = linkTarget.statSync(); if (devFSConfig.cacheSymlinks) { _linkTarget = linkTarget; } } } File _getFile() { if (_linkTarget != null) { return _linkTarget; } if (file is Link) { // The link target. return fs.file(file.resolveSymbolicLinksSync()); } return file; } Future<List<int>> contentsAsBytes() async { if (_isSourceEntry) return bundleEntry.contentsAsBytes(); final File file = _getFile(); return file.readAsBytes(); } Stream<List<int>> contentsAsStream() { if (_isSourceEntry) { return new Stream<List<int>>.fromIterable( <List<int>>[bundleEntry.contentsAsBytes()]); } final File file = _getFile(); return file.openRead(); } Stream<List<int>> contentsAsCompressedStream() { return contentsAsStream().transform(GZIP.encoder); } } /// Abstract DevFS operations interface. abstract class DevFSOperations { Future<Uri> create(String fsName); Future<dynamic> destroy(String fsName); Future<dynamic> writeFile(String fsName, DevFSEntry entry); Future<dynamic> deleteFile(String fsName, DevFSEntry entry); Future<dynamic> writeSource(String fsName, String devicePath, String contents); } /// An implementation of [DevFSOperations] that speaks to the /// vm service. class ServiceProtocolDevFSOperations implements DevFSOperations { final VMService vmService; ServiceProtocolDevFSOperations(this.vmService); @override Future<Uri> create(String fsName) async { Map<String, dynamic> response = await vmService.vm.createDevFS(fsName); return Uri.parse(response['uri']); } @override Future<dynamic> destroy(String fsName) async { await vmService.vm.invokeRpcRaw('_deleteDevFS', <String, dynamic> { 'fsName': fsName }); } @override Future<dynamic> writeFile(String fsName, DevFSEntry entry) async { List<int> bytes; try { bytes = await entry.contentsAsBytes(); } catch (e) { return e; } String fileContents = BASE64.encode(bytes); try { return await vmService.vm.invokeRpcRaw('_writeDevFSFile', <String, dynamic> { 'fsName': fsName, 'path': entry.devicePath, 'fileContents': fileContents }); } catch (e) { printTrace('DevFS: Failed to write ${entry.devicePath}: $e'); } } @override Future<dynamic> deleteFile(String fsName, DevFSEntry entry) async { // TODO(johnmccutchan): Add file deletion to the devFS protocol. } @override Future<dynamic> writeSource(String fsName, String devicePath, String contents) async { String fileContents = BASE64.encode(UTF8.encode(contents)); return await vmService.vm.invokeRpcRaw('_writeDevFSFile', <String, dynamic> { 'fsName': fsName, 'path': devicePath, 'fileContents': fileContents }); } } class _DevFSHttpWriter { _DevFSHttpWriter(this.fsName, VMService serviceProtocol) : httpAddress = serviceProtocol.httpAddress; final String fsName; final Uri httpAddress; static const int kMaxInFlight = 6; int _inFlight = 0; List<DevFSEntry> _outstanding; Completer<Null> _completer; HttpClient _client; int _done; int _max; Future<Null> write(Set<DevFSEntry> entries, {DevFSProgressReporter progressReporter}) async { _client = new HttpClient(); _client.maxConnectionsPerHost = kMaxInFlight; _completer = new Completer<Null>(); _outstanding = entries.toList(); _done = 0; _max = _outstanding.length; _scheduleWrites(progressReporter); await _completer.future; _client.close(); } void _scheduleWrites(DevFSProgressReporter progressReporter) { while (_inFlight < kMaxInFlight) { if (_outstanding.length == 0) { // Finished. break; } DevFSEntry entry = _outstanding.removeLast(); _scheduleWrite(entry, progressReporter); _inFlight++; } } Future<Null> _scheduleWrite(DevFSEntry entry, DevFSProgressReporter progressReporter) async { try { HttpClientRequest request = await _client.putUrl(httpAddress); request.headers.removeAll(HttpHeaders.ACCEPT_ENCODING); request.headers.add('dev_fs_name', fsName); request.headers.add('dev_fs_path_b64', BASE64.encode(UTF8.encode(entry.devicePath))); Stream<List<int>> contents = entry.contentsAsCompressedStream(); await request.addStream(contents); HttpClientResponse response = await request.close(); await response.drain(); } catch (e) { printError('Error writing "${entry.devicePath}" to DevFS: $e'); } if (progressReporter != null) { _done++; progressReporter(_done, _max); } _inFlight--; if ((_outstanding.length == 0) && (_inFlight == 0)) { _completer.complete(null); } else { _scheduleWrites(progressReporter); } } } class DevFS { /// Create a [DevFS] named [fsName] for the local files in [directory]. DevFS(VMService serviceProtocol, String fsName, this.rootDirectory, { String packagesFilePath }) : _operations = new ServiceProtocolDevFSOperations(serviceProtocol), _httpWriter = new _DevFSHttpWriter(fsName, serviceProtocol), fsName = fsName { _packagesFilePath = packagesFilePath ?? path.join(rootDirectory.path, kPackagesFileName); } DevFS.operations(this._operations, this.fsName, this.rootDirectory, { String packagesFilePath, }) : _httpWriter = null { _packagesFilePath = packagesFilePath ?? path.join(rootDirectory.path, kPackagesFileName); } final DevFSOperations _operations; final _DevFSHttpWriter _httpWriter; final String fsName; final Directory rootDirectory; String _packagesFilePath; final Map<String, DevFSEntry> _entries = <String, DevFSEntry>{}; final Set<DevFSEntry> _dirtyEntries = new Set<DevFSEntry>(); final Set<DevFSEntry> _deletedEntries = new Set<DevFSEntry>(); final Set<DevFSEntry> dirtyAssetEntries = new Set<DevFSEntry>(); final List<Future<Map<String, dynamic>>> _pendingOperations = new List<Future<Map<String, dynamic>>>(); int _bytes = 0; int get bytes => _bytes; Uri _baseUri; Uri get baseUri => _baseUri; Future<Uri> create() async { _baseUri = await _operations.create(fsName); printTrace('DevFS: Created new filesystem on the device ($_baseUri)'); return _baseUri; } Future<dynamic> destroy() { printTrace('DevFS: Deleted filesystem on the device ($_baseUri)'); return _operations.destroy(fsName); } void _reset() { // Reset the dirty byte count. _bytes = 0; // Mark all entries as possibly deleted. _entries.forEach((String path, DevFSEntry entry) { entry._exists = false; }); // Clear the dirt entries list. _dirtyEntries.clear(); // Clear the deleted entries list. _deletedEntries.clear(); // Clear the dirty asset entries. dirtyAssetEntries.clear(); } Future<dynamic> update({ DevFSProgressReporter progressReporter, AssetBundle bundle, bool bundleDirty: false, Set<String> fileFilter}) async { _reset(); printTrace('DevFS: Starting sync from $rootDirectory'); logger.printTrace('Scanning project files'); Directory directory = rootDirectory; await _scanDirectory(directory, recursive: true, fileFilter: fileFilter); printTrace('Scanning package files'); StringBuffer sb; if (fs.isFileSync(_packagesFilePath)) { PackageMap packageMap = new PackageMap(_packagesFilePath); for (String packageName in packageMap.map.keys) { Uri uri = packageMap.map[packageName]; // This project's own package. final bool isProjectPackage = uri.toString() == 'lib/'; final String directoryName = isProjectPackage ? 'lib' : 'packages/$packageName'; // If this is the project's package, we need to pass both // package:<package_name> and lib/ as paths to be checked against // the filter because we must support both package: imports and relative // path imports within the project's own code. final String packagesDirectoryName = isProjectPackage ? 'packages/$packageName' : null; Directory directory = fs.directory(uri); bool packageExists = await _scanDirectory(directory, directoryName: directoryName, recursive: true, packagesDirectoryName: packagesDirectoryName, fileFilter: fileFilter); if (packageExists) { sb ??= new StringBuffer(); sb.writeln('$packageName:$directoryName'); } } } if (bundle != null) { printTrace('Scanning asset files'); // Synchronize asset bundle. for (AssetBundleEntry entry in bundle.entries) { // We write the assets into the AssetBundle working dir so that they // are in the same location in DevFS and the iOS simulator. final String devicePath = path.join(getAssetBuildDirectory(), entry.archivePath); _scanBundleEntry(devicePath, entry, bundleDirty); } } // Handle deletions. printTrace('Scanning for deleted files'); final List<String> toRemove = new List<String>(); _entries.forEach((String path, DevFSEntry entry) { if (!entry._exists) { _deletedEntries.add(entry); toRemove.add(path); } }); for (int i = 0; i < toRemove.length; i++) { _entries.remove(toRemove[i]); } if (_deletedEntries.length > 0) { printTrace('Removing deleted files'); for (DevFSEntry entry in _deletedEntries) { Future<Map<String, dynamic>> operation = _operations.deleteFile(fsName, entry); if (operation != null) _pendingOperations.add(operation); } await Future.wait(_pendingOperations); _pendingOperations.clear(); _deletedEntries.clear(); } if (_dirtyEntries.length > 0) { printTrace('Updating files'); if (_httpWriter != null) { try { await _httpWriter.write(_dirtyEntries, progressReporter: progressReporter); } catch (e) { printError("Could not update files on device: $e"); } } else { // Make service protocol requests for each. for (DevFSEntry entry in _dirtyEntries) { Future<Map<String, dynamic>> operation = _operations.writeFile(fsName, entry); if (operation != null) _pendingOperations.add(operation); } if (progressReporter != null) { final int max = _pendingOperations.length; int complete = 0; _pendingOperations.forEach((Future<dynamic> f) => f.then((dynamic v) { complete += 1; progressReporter(complete, max); })); } await Future.wait(_pendingOperations, eagerError: true); _pendingOperations.clear(); } _dirtyEntries.clear(); } if (sb != null) await _operations.writeSource(fsName, '.packages', sb.toString()); printTrace('DevFS: Sync finished'); } void _scanFile(String devicePath, FileSystemEntity file) { DevFSEntry entry = _entries[devicePath]; if (entry == null) { // New file. entry = new DevFSEntry(devicePath, file); _entries[devicePath] = entry; } entry._exists = true; bool needsWrite = entry.isModified; if (needsWrite) { if (_dirtyEntries.add(entry)) _bytes += entry.size; } } void _scanBundleEntry(String devicePath, AssetBundleEntry assetBundleEntry, bool bundleDirty) { DevFSEntry entry = _entries[devicePath]; if (entry == null) { // New file. entry = new DevFSEntry.bundle(devicePath, assetBundleEntry); _entries[devicePath] = entry; } entry._exists = true; if (!bundleDirty && assetBundleEntry.isStringEntry) { // String bundle entries are synthetic files that only change if the // bundle itself changes. Skip them if the bundle is not dirty. return; } bool needsWrite = entry.isModified; if (needsWrite) { if (_dirtyEntries.add(entry)) { _bytes += entry.size; if (entry._isAssetEntry) dirtyAssetEntries.add(entry); } } } bool _shouldIgnore(String devicePath) { List<String> ignoredPrefixes = <String>['android/', getBuildDirectory(), 'ios/', '.pub/']; for (String ignoredPrefix in ignoredPrefixes) { if (devicePath.startsWith(ignoredPrefix)) return true; } return false; } Future<bool> _scanDirectory(Directory directory, {String directoryName, bool recursive: false, bool ignoreDotFiles: true, String packagesDirectoryName, Set<String> fileFilter}) async { String prefix = directoryName; if (prefix == null) { prefix = path.relative(directory.path, from: rootDirectory.path); if (prefix == '.') prefix = ''; } try { Stream<FileSystemEntity> files = directory.list(recursive: recursive, followLinks: false); await for (FileSystemEntity file in files) { if (!devFSConfig.noDirectorySymlinks && (file is Link)) { // Check if this is a symlink to a directory and skip it. final String linkPath = file.resolveSymbolicLinksSync(); final FileSystemEntityType linkType = fs.statSync(linkPath).type; if (linkType == FileSystemEntityType.DIRECTORY) { continue; } } if (file is Directory) { // Skip non-files. continue; } assert((file is Link) || (file is File)); if (ignoreDotFiles && path.basename(file.path).startsWith('.')) { // Skip dot files. continue; } final String relativePath = path.relative(file.path, from: directory.path); final String devicePath = path.join(prefix, relativePath); bool filtered = false; if ((fileFilter != null) && !fileFilter.contains(devicePath)) { if (packagesDirectoryName != null) { // Double check the filter for packages/packagename/ final String packagesDevicePath = path.join(packagesDirectoryName, relativePath); if (!fileFilter.contains(packagesDevicePath)) { // File was not in the filter set. filtered = true; } } else { // File was not in the filter set. filtered = true; } } if (filtered) { // Skip files that are not included in the filter. continue; } if (ignoreDotFiles && devicePath.startsWith('.')) { // Skip directories that start with a dot. continue; } if (!_shouldIgnore(devicePath)) _scanFile(devicePath, file); } } catch (e) { // Ignore directory and error. return false; } return true; } }