https://github.com/andrewkroh/gradle-protobuf-plugin
Gradle plugin for Google Protocol Buffers
https://github.com/andrewkroh/gradle-protobuf-plugin
Last synced: about 1 year ago
JSON representation
Gradle plugin for Google Protocol Buffers
- Host: GitHub
- URL: https://github.com/andrewkroh/gradle-protobuf-plugin
- Owner: andrewkroh
- License: apache-2.0
- Created: 2013-06-15T04:56:32.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2015-11-09T05:42:23.000Z (over 10 years ago)
- Last Synced: 2025-03-19T02:11:25.185Z (about 1 year ago)
- Language: Groovy
- Size: 377 KB
- Stars: 36
- Watchers: 3
- Forks: 14
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE-2.0.txt
Awesome Lists containing this project
- awesome-android-ui - https://github.com/andrewkroh/gradle-protobuf-plugin
README
Gradle Protobuf Plugin
=====================
- Author: Andrew Kroh
- Download: See [maven central](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.andrewkroh.gradle%22)
- License: Apache License, Version 2.0
- Requirements: Java 1.5+
- Google Protocol Buffer Compiler (protoc): Any version
What is it?
-----------
This is a plugin for Gradle that enables compiling Google Protocol Buffer .proto files into data access classes. It generates Java, CPP, and Python source files from the .proto files in src/main/proto.
This plugin adds a dependency on the Java plugin so that it can compile the generated Java source files.
This plugin generates a sources jar that contains all of the Java sources (including those generated from the .proto files) in this project.
The Protocol Buffer compiler must be on the path for the plugin to work. If the protocol buffer is in a different location then specify the full path to the compiler in your build.gradle file using protobuf.compiler = '/full/path/protoc'.
Usage
-----
```groovy
apply plugin: 'protobuf'
```
The plugin JAR needs to be defined in the classpath of your build script. It is available from maven central.
```groovy
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.andrewkroh.gradle:gradle-protobuf-plugin:0.5.0'
}
}
```
The plugin automatically adds a dependency on the google protobuf jars so all you need to do is specify what repository(s) to use.
```groovy
repositories {
mavenCentral()
}
```
Project Layout
--------------
Simply put your .proto files in `src/main/proto`.
Tasks
-----
The protobuf plugin defines the following task:
* `compileProto` - Generates source files by compiling .proto files.
Extensions
----------
The protobuf plugin adds a `protobuf` extension to the project which allows you to override the default configuration of the plugin.
* `version` - Protocol Buffers version that your project requires. By specifying this value the plugin will verify that it is using specified version of the compiler.
* `src` - Source directory for your .proto files. The value is relative to the project root.
* `compiler` - Name (or full path) of the Google Protocol Buffer compiler that the plugin will execute.
* `outputCpp` - Output directory for generated CPP source files. The value is relative to the project build directory.
* `outputJava` - Output directory for generated java source files. The value is relative to the project build directory.
* `outputPython` - Output directory for generated python source files. The value is relative to the project build directory.
* `outputToProjectDir` - Output generated files relative to project root directory instead of relative to build directory. Defaults to false.
* `autoDependency` - Activate or deactivate automatic dependency creation. If true, a compile time dependency on `com.google.protobuf:protobuf-java` is added automatically based on the Protocol Buffers version number. Defaults to true.
Example
-------
See the example directory in this repository.