pigeon 3.0.3

Code generator tool to make communication between Flutter and the host platform type-safe and easier.

3.0.3

• Adds ability for generators to do AST validation. This can help generators without complete implementations to report gaps in coverage.

3.0.2

• Fixes non-nullable classes and enums as fields.
• Fixes nullable collections as return types.

3.0.1

• Enables NNBD for the Pigeon tool itself.
• [tests] Updates legacy Dart commands.

3.0.0

• BREAKING CHANGE: Removes the --dart_null_safety flag. Generated Dart now always uses nullability annotations, and thus requires Dart 2.12 or later.

2.0.4

• Fixes bug where Dart FlutterApis would assert that a nullable argument was nonnull.

2.0.3

• Makes the generated Java Builder class final.

2.0.2

• Fixes Java crash for nullable nested type.

• 2.0.1

• Adds support for TaskQueues for serial background execution.

2.0.0

• Implements nullable parameters.
• BREAKING CHANGE - Nonnull parameters to async methods on HostApis for ObjC now have the proper nullability hints.

1.0.19

• Implements nullable return types.

1.0.18

• [front-end] Fix error caused by parsing copyrightHeaders passed to options in @ConfigurePigeon.

1.0.17

• [dart_test] Adds missing linter ignores.
• [objc] Factors out helper function for reading from NSDictionary's.
• [objc] Renames static variables to match Google style.

1.0.16

• Updates behavior of run_tests.dart with no arguments.
• [debugging] Adds ast_out to help with debugging the compiler front-end.
• [front-end, dart] Adds support for non-null fields in data classes in the front-end parser and the Dart generator (unsupported languages ignore the designation currently).
• [front-end, dart, objc, java] Adds support for non-null fields in data classes.

1.0.15

• [java] Fix too little information when having an exception

1.0.14

• [tests] Port several generator tests to run in Dart over bash

1.0.13

• [style] Fixes new style rules for Dart analyzer.

1.0.12

• [java] Fixes enum support for null values.

1.0.11

• [ci] Starts transition to a Dart test runner, adds windows support.
• [front-end] Starts issuing an error if enums are used in type arguments.
• [front-end] Passes through all enums, referenced or not so they can be used as a work around for direct enum support.

1.0.10

• [front-end] Made sure that explicit use of Object actually creates the codec that can represent custom classes.

1.0.9

• [dart] Fixed cast exception that can happen with primitive data types with type arguments in FlutterApi's.

1.0.8

• [front-end] Started accepting explicit Object references in type arguments.
• [codecs] Fixed nuisance where duplicate entries could show up in custom codecs.

1.0.7

• [front-end] Fixed bug where nested classes' type arguments aren't included in the output (generated class and codec).

1.0.6

• Updated example README for set up steps.

1.0.5

• [java] Fixed bug when using Integer arguments to methods declared with 'int' arguments.

1.0.4

• [front-end] Fixed bug where codecs weren't generating support for types that only show up in type arguments.

1.0.3

• [objc] Updated assert message for incomplete implementations of protocols.

1.0.2

• [java] Made it so @async handlers in @HostApi() can report errors explicitly.

1.0.1

• [front-end] Fixed bug where classes only referenced as type arguments for generics weren't being generated.

1.0.0

• Started allowing primitive data types as arguments and return types.
• Generics support.
• Support for functions with more than one argument.
• [command-line] Added one_language flag for allowing Pigeon to only generate code for one platform.
• [command-line] Added the optional sdkPath parameter for specifying Dart SDK path.
• [dart] Fixed copyright headers for Dart test output.
• [front-end] Added more errors for incorrect usage of Pigeon (previously they were just ignored).
• [generators] Moved Pigeon to using a custom codec which allows collection types to contain custom classes.
• [java] Fixed NPE in Java generated code for nested types.
• [objc] BREAKING CHANGE: logic for generating Objective-C selectors has changed. void add(Input value) will now translate to -(void)addValue:(Input*)value, methods with no arguments will translate to ...WithError: or ...WithCompletion:.
• [objc] Added @ObjCSelector for specifying custom objc selectors.

0.3.0

• Updated the front-end parser to use dart analyzer instead of dart:mirrors. dart:mirrors doesn't support null-safe code so there were a class of features we couldn't implement without this migration.
• BREAKING CHANGE - the configurePigeon function has been migrated to a @ConfigurePigeon annotation. See ./pigeons/message.dart for an example. The annotation can be attached to anything in the file to take effect.
• BREAKING CHANGE - Now Pigeon files must be in one file per invocation of Pigeon. For example, the classes your APIs use must be in the same file as your APIs. If your Pigeon file imports another source file, it won't actually import it.

0.2.4

• bugfix in front-end parser for recursively referenced datatypes.

0.2.3

• bugfix in iOS async handlers of functions with no arguments.

0.2.2

• Added support for enums.

0.2.1

• Java: Fixed issue where multiple async HostApis can generate multiple Result interfaces.
• Dart: Made it so you can specify the BinaryMessenger of the generated APIs.

0.2.0

• BREAKING CHANGE - Pigeon files must be null-safe now. That means the fields inside of the classes must be declared nullable ( non-null fields aren't yet supported). Migration example:

// Version 0.1.x
class Foo {
  int bar;
  String baz;
}

// Version 0.2.x
class Foo {
  int? bar;
  String? baz;
}

• BREAKING CHANGE - The default output from Pigeon is now null-safe. If you want non-null-safe code you must provide the --no-dart_null_safety flag.
• The Pigeon source code is now null-safe.
• Fixed niladic non-value returning async functions in the Java generator.
• Made runCommandLine return an the status code.

0.1.24

• Moved logic from bin/ to lib/ to help customers wrap up the behavior.
• Added some more linter ignores for Dart.

0.1.23

• More Java linter and linter fixes.

0.1.22

• Java code generator enhancements:
  • Added linter tests to CI.
  • Fixed some linter issues in the Java code.

0.1.21

• Fixed decode method on generated Flutter classes that use null-safety and have null values.

0.1.20

• Implemented @async HostApi's for iOS.
• Fixed async FlutterApi methods with void return.

0.1.19

• Fixed a bug introduced in 0.1.17 where methods without arguments were no longer being called.

0.1.18

• Null safe requires Dart 2.12.

0.1.17

• Split out test code generation for Dart into a separate file via the --dart_test_out flag.

0.1.16

• Fixed running in certain environments where NNBD is enabled by default.

0.1.15

• Added support for running in versions of Dart that support NNBD.

0.1.14

• [Windows] Fixed executing from drives other than C:.

0.1.13

• Fixed execution on Windows with certain setups where Dart didn't allow backslashes in import statements.

0.1.12

• Fixed assert failure with creating a PlatformException as a result of an exception in Java handlers.

0.1.11

• Added flag to generate null safety annotated Dart code --dart_null_safety.
• Made it so Dart API setup methods can take null.

0.1.10+1

• Updated the examples page.

0.1.10

• Fixed bug that prevented running pigeon on Windows (introduced in 0.1.8).

0.1.9

• Fixed bug where executing pigeon without arguments would crash (introduced in 0.1.8).

0.1.8

• Started spawning pigeon_lib in an isolate instead of a subprocess. The subprocess could have lead to errors if the dart version on $PATH didn't match the one that comes with flutter.

0.1.7

• Fixed Dart compilation for later versions that support null safety, opting out of it for now.
• Fixed nested types in the Java runtime.

0.1.6

• Fixed unused variable linter warning in Dart code under certain conditions.

0.1.5

• Made array datatypes correctly get imported and exported avoiding the need to add extra imports to generated code.

0.1.4

• Fixed nullability for NSError's in generated objc code.
• Fixed nullability of nested objects in the Dart generator.
• Added test to make sure the pigeon version is correct in generated code headers.

0.1.3

• Added error message if supported datatypes are used as arguments or return types directly, without an enclosing class.
• Added support for List and Map datatypes in Java and Objective-C targets.

0.1.2+1

• Updated the Readme.md.

0.1.2

• Removed static analysis warnings from generated Java code.

0.1.1

• Fixed issue where nested types didn't work if they weren't present in the Api.

0.1.0

• Added pigeon.dart.
• Fixed some Obj-C linter problems.
• Added the ability to generate a mock handler in Dart.

0.1.0-experimental.11

• Fixed setting an api to null in Java.

0.1.0-experimental.10

• Added support for void argument functions.
• Added nullability annotations to generated objc code.

0.1.0-experimental.9

• Added e2e tests for iOS.

0.1.0-experimental.8

• Renamed setupPigeon to configurePigeon.

0.1.0-experimental.7

• Suppressed or got rid of warnings in generated Dart code.

0.1.0-experimental.6

• Added support for void return types.

0.1.0-experimental.5

• Fixed runtime exception in Android with values of ints less than 2^32.
• Incremented codegen version warning.

0.1.0-experimental.4

• Fixed primitive types for Android Java.

0.1.0-experimental.3

• Added support for for Android Java.

0.1.0-experimental.2

• Added Host->Flutter calls for Objective-C

0.1.0-experimental.1

• Fixed warning in the README.md

0.1.0-experimental.0

• Initial release.