A Dart build package to compile Protocol Buffer
files to Dart source code using build_runner (i.e.
the Dart build pipline) without needing to manually install the protoc
compiler or the Dart Protobuf plugin protoc_plugin.
The protoc_builder package downloads the necessary Protobuf dependencies for your platform to a
temporary local directory, thereby streamlining the development process.
Installation
Add the necessary dependencies to your pubspec.yaml file:
dev_dependencies:
build_runner: <latest>
protoc_builder: <latest>
Configuration
You must add your .proto files to a build.yaml file next to the pubspec.yaml:
targets:
$default:
sources:
- $package$
- lib/$lib$
- proto/** # Your .proto directory
This will use the default configuration for the protoc_builder.
You may also configure custom options:
targets:
$default:
sources:
- $package$
- lib/$lib$
- proto/**
builders:
protoc_builder:
options:
# The version of the Protobuf compiler to use.
protobuf_version: "3.19.1" # Make sure to use quotation marks.
# The version of the Dart protoc_plugin package to use.
protoc_plugin_version: "20.0.0" # Make sure to use quotation marks.
# Include paths given to the Protobuf compiler during compilation.
proto_paths:
- "proto/"
# The root directory for generated Dart output files.
out_dir: "lib/src/generated"
Running
Once everything is set up, you may simply run the build_runner package:
pub run build_runner build
The build_runner sometimes caches results longer than it should, so in some cases, it may be necessary to delete the .dart_tool/build directory.
