docs: development with local gapic-generator-java #1132
Conversation
| @@ -97,17 +97,17 @@ | |||
|
|
|||
| ## Running the Plugin | |||
|
|
|||
| 1. Clone [googleapis](https://github.com/googleapis/googleapis) and | |||
| 1. Clone [googleapis](https://github.com/googleapis/googleapis) and | |||
There was a problem hiding this comment.
My IntelliJ tells that it was unnecessary space.
| ) | ||
| ``` | ||
|
|
||
| 5. Build the new target. |
There was a problem hiding this comment.
Steps looks good; wondering if you wanted to add a step on how to build any client library (e.g. technically you don't need to build the showcase service, can build any service). Something like:
You can generate any client library based on the protos within googleapis. You just need the name of the service within the java_gapic_assembly_gradle_pkg rules within the services BUILD.bazel file. For instance, if you wanted to test your local generator on the speech service, you can run:
bazel build google-cloud-speech-v1-java
There was a problem hiding this comment.
Good. I added 83d2607 with bazel build //google/cloud/speech/v2:google-cloud-speech-v2-java
| @@ -162,8 +162,36 @@ | |||
| ) | |||
| ``` | |||
|
|
|||
| 4. Build the new target. | |||
| 4. Point to local gapic-generator-java | |||
There was a problem hiding this comment.
Thanks Tomo! It's good to have a section that points to local repo, just be aware that this section will change very soon once we merge #918. We will point googleapis to a local jar instead of a path to local repo.
There was a problem hiding this comment.
That sounds good. Not a blocker for this pull request.
|
Kudos, SonarCloud Quality Gate passed!
|
* docs: development with local gapic-generator-java * adding instruction for arbitrary target
Adding a step to use gapic-generator-java in local computer.
Credit: @chanseokoh 's "How does gapic-generator-java (“Java Microgenerator”) fit into the Cloud library generation workflow?" documentation.