resolve_windows_shortcut

Description:

resolve windows shortcut

This package lets you resolve target paths of Windows Shortcut (.lnk) files.
Getting Started #
Add resolve_windows_shortcut as a depenency to pubspec.yaml.
Basic Usage #
import 'package:resolve_windows_shortcut/resolve_windows_shortcut.dart';

final File shortcut = File('C:\\ShortcutPath.lnk');
final String resolvedShortcutPath = shortcut.resolveIfShortcut();
// OR
final String resolvedShortcutPath = resolveTartget(shortcut.readAsBytesSync());
copied to clipboard
Sample Directory Extension Code #
extension ResolvableDirectory on Directory {
/// Determines if the directory contains any entities that
/// point to directories or are directories themselves
Future<bool> hasSubDirectory() async {
await for (final entity in list(recursive: false)) {
if (entity is Directory) return true;
if (_getPathExtension(entity.path) == 'lnk') {
try {
await (entity as File).resolveIfShortcut(targetType: ShortcutResolverEntityType.directory);
// if no error, a target path was found
return true;
} catch (e) {
return false;
}
}
}
return false;
}

/// Lists the contents of the directory with any functioning links resolved
Stream<FileSystemEntity> listWithResolvedShortcuts(
{ShortcutResolverEntityType resolverEntityType = ShortcutResolverEntityType.any, bool recursive = false}) async* {
await for (final FileSystemEntity entity in list()) {
if (entity is File && _getPathExtension(entity.path) == 'lnk') {
Directory resolvedDir =
Directory((await Future<String?>(() => entity.resolveIfShortcut(targetType: resolverEntityType)) ?? ''));
if (resolvedDir.path.isEmpty || !resolvedDir.existsSync()) continue;
if (recursive) {
yield* resolvedDir.listWithResolvedShortcuts(resolverEntityType: resolverEntityType, recursive: recursive);
}
yield resolvedDir;
} else if (entity is Directory && recursive) {
yield* entity.listWithResolvedShortcuts(resolverEntityType: resolverEntityType, recursive: recursive);
} else {
yield entity;
}
}
}

/// Get the extension of the given file path if it exists
String _getPathExtension(String path) => path.split(RegExp(r'[/\\]')).last.split('.').last;
}
copied to clipboard
Additional information #
Tested on shortcuts made in Windows 10 21H2
Comments in this package refer to Windows Shortcuts as Shell Links.