winmd 0.4.3
winmd: ^0.4.3 copied to clipboard
A Dart library for working with Windows Metadata (winmd) formats.
This package provides a Dart abstraction over Windows metadata files, making it possible to load them and build Dart FFI interop libraries from the results.
Architecture #
Usage (Windows Runtime) #
A simple example: loading the IAsyncInfo interface and emitting the Dart equivalent file.
import 'package:winmd/winmd.dart';
void main() {
// A Windows Runtime interface
const type = 'Windows.Foundation.IAsyncInfo';
// Load the metadata for this interface
final typeDef = MetadataStore.getMetadataForType(type)!;
// Project it into something Dart can work with
final projection = ClassProjector(typeDef).projection;
// Create a Dart projection
final dartClass = TypePrinter.printType(projection);
// Print it to the screen. Normally you'd save it to a file and format it.
print(dartClass);
}
Usage (Win32) #
Load all the methods from the GDI namespace and print out some metadata.
import 'dart:io';
import 'package:winmd/winmd.dart';
void main() {
// Load WinMD metadata for Win32, as produced by the following utility:
// https://github.com/microsoft/win32metadata
final scope = MetadataStore.getScopeForFile(File('Windows.Win32.winmd'));
// Find the GDI API namesapce
final gdiApi =
scope.typeDefs.firstWhere((type) => type.typeName.endsWith('Gdi.Apis'));
// Sort the functions alphabetically
final sortedMethods = gdiApi.methods
..sort((a, b) => a.methodName.compareTo(b.methodName));
// Find a specific function
const funcName = 'AddFontResourceW';
final method = sortedMethods.firstWhere((m) => m.methodName == funcName);
// Print out some information about it
print('This method is token #${method.token}');
final params = method.parameters
.map((param) => '${param.typeIdentifier.nativeType} ${param.name!}')
.join(', ');
print('The parameters are:\n$params');
}
Features and bugs #
Please file feature requests and bugs at the issue tracker.