missing_annotation_on_struct_field

Fields of type '{0}' in a subclass of '{1}' must have an annotation indicating the native type.

The analyzer produces this diagnostic when a field in a subclass of Struct or Union whose type requires an annotation doesn't have one. The Dart types int, double, and Array are used to represent multiple C types, and the annotation specifies which of the compatible C types the field represents.

For more information about FFI, see C interop using dart:ffi.

The following code produces this diagnostic because the field x doesn't have an annotation indicating the underlying width of the integer value:

import 'dart:ffi';

final class C extends Struct {
  external int x;
}

Add an appropriate annotation to the field:

import 'dart:ffi';

final class C extends Struct {
  @Int64()
  external int x;
}

Unless stated otherwise, the documentation on this site reflects Dart 3.8.0. Page last updated on 2025-05-08. View source or report an issue.