Protocol Buffers Setup | HeroDevs Docs

Setup Instructions

Configure Registry

Create or update your registry configuration:

Maven (~/.m2/settings.xml)

Gradle (~/.gradle/gradle.properties)

<settings>
  <servers>
    <server>
      <id>herodevs-nes-registry</id>
      <username>any_text_here_not_used</username>
      <password>YOUR_NES_ACCESS_TOKEN</password>
    </server>
  </servers>
</settings>

See the guides for Sonatype Nexus or JFrog Artifactory for setup to the HeroDevs NES registry.

Update Build Configuration

Add the NES repository and dependencies to your build configuration:

Look up the latest artifact version in the "Protocol Buffers Release Notes".

Maven (pom.xml)

Gradle

<!-- Import the NES protobuf BOM so every protobuf artifact resolves to the NES version -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.protobuf</groupId>
      <artifactId>protobuf-bom</artifactId>
      <version>3.21.12-protobuf-3.21.14</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.protobuf</groupId>
    <artifactId>protobuf-java</artifactId>
  </dependency>
</dependencies>

<!-- Add NES repository -->
<repositories>
  <repository>
    <id>herodevs-nes-registry</id>
    <url>https://registry.nes.herodevs.com/maven</url>
  </repository>
</repositories>

The same NES version is published for protobuf-java-util, protobuf-javalite, protobuf-kotlin, and protobuf-kotlin-lite — swap in the artifact IDs your project depends on. All of them are managed by the imported protobuf-bom.

Build

In order to remove potential obstacles before building your project, make sure the following domains are whitelisted by your firewall/networking team:

registry.nes.herodevs.com
assets.nes.herodevs.com

This will ensure that your network/firewall allows connection to our registry.

Run your build tool:

Maven

Gradle

mvn clean package

Verification

To verify your installation, check that:

Dependencies are downloaded successfully
No version conflicts are reported in your build
Your application starts without errors

Manual Downloads

The direct download URLs for NES for Protocol Buffers packages follow this format:

Portion	Value
base_url	https://registry.nes.herodevs.com/maven/com/google/protobuf/
package_name	protobuf-java
version	3.21.12-protobuf-3.21.14
filename	package_name + version + extension

Example Link

https://registry.nes.herodevs.com/maven/com/google/protobuf/protobuf-java/3.21.12-protobuf-3.21.14/protobuf-java-3.21.12-protobuf-3.21.14.pom