tree: 92763f6891b4169ac782824486317335c7772646 [path history] [tgz]
  1. README.md
  2. apps-paymentmethodtoken.pom.xml
  3. apps-rewardedads.pom.xml
  4. apps-webpush.pom.xml
  5. execute-deploy.sh
  6. publish-snapshot.sh
  7. publish-to-maven-central.sh
  8. settings.xml
  9. test-snapshot.sh
  10. tink-android.pom.xml
  11. tink-awskms.pom.xml
  12. tink-gcpkms.pom.xml
  13. tink.pom.xml
maven/README.md

Tink Java on Maven

Tink Java has 4 Maven artifacts, all are in the com.google.crypto.tink group.

  • tink: this is the core of Tink built for server side apps. It only depends on org.json:json and com.google.protobuf:protobuf-java.
  • tink-android: this is similar to tink but is built for Android apps. It only depends on com.google.protobuf:protobuf-lite.
  • tink-awskms: this is a plugin for the tink artifact that integrates Tink with AWS KMS.
  • tink-gcpkms: this is a plugin for the tink artifact that integrates Tink with GCP KMS.

Publishing snapshots

./maven/publish-snapshot.sh

This command publishes latest snapshots to Maven, and their Javadocs to https://google.github.com/tink.

Snapshots are also automatically published for every new commit to the master branch of https://github.com/google/tink.

Testing snapshots

./maven/test-snapshot.sh

New snapshots are also automatically tested for every new commit to the master branch of https://github.com/google/tink.

Adding a dependency

This should be considered only when there is no other option, 'cause adding dependency makes Tink bloated and less secure. If a dependency got tampered with, Tink would also be affected.

This process consists of 3 steps:

  1. To add a dependency for an artifact, you add it to the artifact's pom.xml. For example, the com.google.crypto.tink:tink artifact uses tink.pom.xml. You should always depend on the latest version of the dependency on Maven Central.

  2. Next, you want to publish a new snapshot of the artifact with the new dependency.

  3. Then you want to test the new snapshot.

You want to repeat these steps until there is no error.

If you encounter Dependency convergence error, it means that the artifact has already, usually indirectly, depended on another version of the new dependency. You want to exclude that version.

See the history of the POM files for examples.