@@ -273,6 +273,9 @@ typedef bool (*TextureFrameCallback)(void* /* user data */,
273273 FlutterOpenGLTexture * /* texture out */ );
274274typedef void (* VsyncCallback )(void * /* user data */ , intptr_t /* baton */ );
275275
276+ /// The order, type, and size of these struct members must remain the same, and
277+ /// members should not be removed. This is to allow for forward and backward
278+ /// compatibility between the engine and the embedder.
276279typedef struct {
277280 /// The size of this struct. Must be sizeof(FlutterOpenGLRendererConfig).
278281 size_t struct_size ;
@@ -311,6 +314,9 @@ typedef struct {
311314 TextureFrameCallback gl_external_texture_frame_callback ;
312315} FlutterOpenGLRendererConfig ;
313316
317+ /// The order, type, and size of these struct members must remain the same, and
318+ /// members should not be removed. This is to allow for forward and backward
319+ /// compatibility between the engine and the embedder.
314320typedef struct {
315321 /// The size of this struct. Must be sizeof(FlutterSoftwareRendererConfig).
316322 size_t struct_size ;
@@ -329,6 +335,9 @@ typedef struct {
329335 };
330336} FlutterRendererConfig ;
331337
338+ /// The order, type, and size of these struct members must remain the same, and
339+ /// members should not be removed. This is to allow for forward and backward
340+ /// compatibility between the engine and the embedder.
332341typedef struct {
333342 /// The size of this struct. Must be sizeof(FlutterWindowMetricsEvent).
334343 size_t struct_size ;
@@ -339,25 +348,28 @@ typedef struct {
339348 /// Pixel density scale factor for the window. This will be identical to the
340349 /// value of the pixel ratio for the screen that this window appears on.
341350 double pixel_ratio ;
342- /// Physical vertical location of the top of the window.
343- size_t top ;
344351 /// Physical horizontal location of the left side of the window.
345352 size_t left ;
353+ /// Physical vertical location of the top of the window.
354+ size_t top ;
346355 /// The id for the window that corresponds to these metrics.
347356 size_t window_id ;
348357 /// The id of the screen that this window appears on.
349358 size_t screen_id ;
350359} FlutterWindowMetricsEvent ;
351360
361+ /// The order, type, and size of these struct members must remain the same, and
362+ /// members should not be removed. This is to allow for forward and backward
363+ /// compatibility between the engine and the embedder.
352364typedef struct {
353365 /// The size of this struct. Must be sizeof(FlutterScreenMetricsEvent).
354366 size_t struct_size ;
355367 /// The id for the screen that corresponds to these metrics.
356368 size_t screen_id ;
357- /// Physical vertical location of the top of the window.
358- size_t top ;
359369 /// Physical horizontal location of the left side of the window.
360370 size_t left ;
371+ /// Physical vertical location of the top of the window.
372+ size_t top ;
361373 /// Physical width of the screen.
362374 size_t width ;
363375 /// Physical height of the screen.
@@ -426,6 +438,9 @@ typedef enum {
426438 kFlutterPointerSignalKindScroll ,
427439} FlutterPointerSignalKind ;
428440
441+ /// The order, type, and size of these struct members must remain the same, and
442+ /// members should not be removed. This is to allow for forward and backward
443+ /// compatibility between the engine and the embedder.
429444typedef struct {
430445 /// The size of this struct. Must be sizeof(FlutterPointerEvent).
431446 size_t struct_size ;
@@ -460,6 +475,9 @@ struct _FlutterPlatformMessageResponseHandle;
460475typedef struct _FlutterPlatformMessageResponseHandle
461476 FlutterPlatformMessageResponseHandle ;
462477
478+ /// The order, type, and size of these struct members must remain the same, and
479+ /// members should not be removed. This is to allow for forward and backward
480+ /// compatibility between the engine and the embedder.
463481typedef struct {
464482 /// The size of this struct. Must be sizeof(FlutterPlatformMessage).
465483 size_t struct_size ;
@@ -524,6 +542,10 @@ extern const int32_t kFlutterSemanticsNodeIdBatchEnd;
524542/// (i.e., during PipelineOwner.flushSemantics), which happens after
525543/// compositing. Updates are then pushed to embedders via the registered
526544/// `FlutterUpdateSemanticsNodeCallback`.
545+ ///
546+ /// The order, type, and size of these struct members must remain the same, and
547+ /// members should not be removed. This is to allow for forward and backward
548+ /// compatibility between the engine and the embedder.
527549typedef struct {
528550 /// The size of this struct. Must be sizeof(FlutterSemanticsNode).
529551 size_t struct_size ;
@@ -603,6 +625,10 @@ extern const int32_t kFlutterSemanticsCustomActionIdBatchEnd;
603625/// Action overrides are custom actions that the application developer requests
604626/// to be used in place of the standard actions in the `FlutterSemanticsAction`
605627/// enum.
628+ ///
629+ /// The order, type, and size of these struct members must remain the same, and
630+ /// members should not be removed. This is to allow for forward and backward
631+ /// compatibility between the engine and the embedder.
606632typedef struct {
607633 /// The size of the struct. Must be sizeof(FlutterSemanticsCustomAction).
608634 size_t struct_size ;
@@ -641,6 +667,10 @@ typedef void (*FlutterTaskRunnerPostTaskCallback)(
641667/// on a specified thread. There should be a 1-1 relationship between a thread
642668/// and a task runner. It is undefined behavior to run a task on a thread that
643669/// is not associated with its task runner.
670+ ///
671+ /// The order, type, and size of these struct members must remain the same, and
672+ /// members should not be removed. This is to allow for forward and backward
673+ /// compatibility between the engine and the embedder.
644674typedef struct {
645675 /// The size of this struct. Must be sizeof(FlutterTaskRunnerDescription).
646676 size_t struct_size ;
@@ -666,6 +696,9 @@ typedef struct {
666696 size_t identifier ;
667697} FlutterTaskRunnerDescription ;
668698
699+ /// The order, type, and size of these struct members must remain the same, and
700+ /// members should not be removed. This is to allow for forward and backward
701+ /// compatibility between the engine and the embedder.
669702typedef struct {
670703 /// The size of this struct. Must be sizeof(FlutterCustomTaskRunners).
671704 size_t struct_size ;
@@ -737,6 +770,9 @@ typedef struct {
737770 };
738771} FlutterPlatformViewMutation ;
739772
773+ /// The order, type, and size of these struct members must remain the same, and
774+ /// members should not be removed. This is to allow for forward and backward
775+ /// compatibility between the engine and the embedder.
740776typedef struct {
741777 /// The size of this struct. Must be sizeof(FlutterPlatformView).
742778 size_t struct_size ;
@@ -770,6 +806,9 @@ typedef enum {
770806 kFlutterBackingStoreTypeSoftware ,
771807} FlutterBackingStoreType ;
772808
809+ /// The order, type, and size of these struct members must remain the same, and
810+ /// members should not be removed. This is to allow for forward and backward
811+ /// compatibility between the engine and the embedder.
773812typedef struct {
774813 /// The size of this struct. Must be sizeof(FlutterBackingStore).
775814 size_t struct_size ;
@@ -790,6 +829,9 @@ typedef struct {
790829 };
791830} FlutterBackingStore ;
792831
832+ /// The order, type, and size of these struct members must remain the same, and
833+ /// members should not be removed. This is to allow for forward and backward
834+ /// compatibility between the engine and the embedder.
793835typedef struct {
794836 /// The size of this struct. Must be sizeof(FlutterBackingStoreConfig).
795837 size_t struct_size ;
@@ -805,6 +847,9 @@ typedef enum {
805847 kFlutterLayerContentTypePlatformView ,
806848} FlutterLayerContentType ;
807849
850+ /// The order, type, and size of these struct members must remain the same, and
851+ /// members should not be removed. This is to allow for forward and backward
852+ /// compatibility between the engine and the embedder.
808853typedef struct {
809854 /// This size of this struct. Must be sizeof(FlutterLayer).
810855 size_t struct_size ;
@@ -839,6 +884,9 @@ typedef bool (*FlutterLayersPresentCallback)(const FlutterLayer** layers,
839884 size_t layers_count ,
840885 void * user_data );
841886
887+ /// The order, type, and size of these struct members must remain the same, and
888+ /// members should not be removed. This is to allow for forward and backward
889+ /// compatibility between the engine and the embedder.
842890typedef struct {
843891 /// This size of this struct. Must be sizeof(FlutterCompositor).
844892 size_t struct_size ;
@@ -863,6 +911,9 @@ typedef struct {
863911 FlutterLayersPresentCallback present_layers_callback ;
864912} FlutterCompositor ;
865913
914+ /// The order, type, and size of these struct members must remain the same, and
915+ /// members should not be removed. This is to allow for forward and backward
916+ /// compatibility between the engine and the embedder.
866917typedef struct {
867918 /// This size of this struct. Must be sizeof(FlutterLocale).
868919 size_t struct_size ;
@@ -901,6 +952,9 @@ typedef enum {
901952 kFlutterEngineDartObjectTypeBuffer ,
902953} FlutterEngineDartObjectType ;
903954
955+ /// The order, type, and size of these struct members must remain the same, and
956+ /// members should not be removed. This is to allow for forward and backward
957+ /// compatibility between the engine and the embedder.
904958typedef struct {
905959 /// The size of this struct. Must be sizeof(FlutterEngineDartBuffer).
906960 size_t struct_size ;
@@ -1036,6 +1090,9 @@ FlutterEngineResult FlutterEngineCreateAOTData(
10361090FLUTTER_EXPORT
10371091FlutterEngineResult FlutterEngineCollectAOTData (FlutterEngineAOTData data );
10381092
1093+ /// The order, type, and size of these struct members must remain the same, and
1094+ /// members should not be removed. This is to allow for forward and backward
1095+ /// compatibility between the engine and the embedder.
10391096typedef struct {
10401097 /// The size of this struct. Must be sizeof(FlutterProjectArgs).
10411098 size_t struct_size ;
0 commit comments