diff --git a/.github/readme/synth.metadata/synth.metadata b/.github/readme/synth.metadata/synth.metadata index 41c92de9..0a723659 100644 --- a/.github/readme/synth.metadata/synth.metadata +++ b/.github/readme/synth.metadata/synth.metadata @@ -4,14 +4,14 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-errorreporting.git", - "sha": "b840e7d7c8b120bfb5da4246e1ec6afd0bbce943" + "sha": "7179eaafba427333f2eaef0bd79cb2e0d58e753f" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "39652e3948f455fd0b77535a0145eeec561a3706" + "sha": "3d32990b6f4b57be77455e3ca89e6e21cd0c06b3" } } ] diff --git a/.github/sync-repo-settings.yaml b/.github/sync-repo-settings.yaml index 6bddd18e..bf357318 100644 --- a/.github/sync-repo-settings.yaml +++ b/.github/sync-repo-settings.yaml @@ -34,7 +34,6 @@ branchProtectionRules: - "linkage-monitor" - "lint" - "clirr" - - "units (7)" - "units (8)" - "units (11)" - "Kokoro - Test: Integration" @@ -46,4 +45,4 @@ permissionRules: - team: yoshi-java-admins permission: admin - team: yoshi-java - permission: push \ No newline at end of file + permission: push diff --git a/CHANGELOG.md b/CHANGELOG.md index 3f566fa9..15781119 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +### [0.121.5](https://www.github.com/googleapis/java-errorreporting/compare/v0.121.4...v0.121.5) (2021-08-02) + + +### Dependencies + +* update dependency com.google.cloud:google-cloud-core to v1.96.0 ([#603](https://www.github.com/googleapis/java-errorreporting/issues/603)) ([cf5a107](https://www.github.com/googleapis/java-errorreporting/commit/cf5a107afbd7e4d808f7577548c146262c4b2e84)) + ### [0.121.4](https://www.github.com/googleapis/java-errorreporting/compare/v0.121.3...v0.121.4) (2021-07-05) diff --git a/README.md b/README.md index f61cf247..7672a250 100644 --- a/README.md +++ b/README.md @@ -11,16 +11,18 @@ Java idiomatic client for [Cloud Error Reporting][product-docs]. > Note: This client is a work-in-progress, and may occasionally > make backwards-incompatible changes. + ## Quickstart If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file + ```xml com.google.cloud libraries-bom - 20.7.0 + 20.9.0 pom import @@ -56,35 +58,43 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file If you are using Maven without BOM, add this to your dependencies: + ```xml com.google.cloud google-cloud-errorreporting - 0.121.3-beta + 0.121.4-beta ``` If you are using Gradle 5.x or later, add this to your dependencies + ```Groovy -implementation platform('com.google.cloud:libraries-bom:20.7.0') +implementation platform('com.google.cloud:libraries-bom:20.9.0') compile 'com.google.cloud:google-cloud-errorreporting' ``` If you are using Gradle without BOM, add this to your dependencies + ```Groovy -compile 'com.google.cloud:google-cloud-errorreporting:0.121.3-beta' +compile 'com.google.cloud:google-cloud-errorreporting:0.121.4-beta' ``` If you are using SBT, add this to your dependencies + ```Scala -libraryDependencies += "com.google.cloud" % "google-cloud-errorreporting" % "0.121.3-beta" +libraryDependencies += "com.google.cloud" % "google-cloud-errorreporting" % "0.121.4-beta" ``` ## Authentication See the [Authentication][authentication] section in the base directory's README. +## Authorization + +The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Cloud Error Reporting APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Cloud Error Reporting API calls. + ## Getting Started ### Prerequisites @@ -114,8 +124,7 @@ use this Cloud Error Reporting Client Library. ## Samples -Samples are in the [`samples/`](https://github.com/googleapis/java-errorreporting/tree/master/samples) directory. The samples' `README.md` -has instructions for running the samples. +Samples are in the [`samples/`](https://github.com/googleapis/java-errorreporting/tree/master/samples) directory. | Sample | Source Code | Try it | | --------------------------- | --------------------------------- | ------ | @@ -131,10 +140,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr Cloud Error Reporting uses gRPC for the transport layer. -## Java Versions +## Supported Java Versions Java 7 or above is required for using this client. +Google's Java client libraries, +[Google Cloud Client Libraries][cloudlibs] +and +[Google Cloud API Libraries][apilibs], +follow the +[Oracle Java SE support roadmap][oracle] +(see the Oracle Java SE Product Releases section). + +### For new development + +In general, new feature development occurs with support for the lowest Java +LTS version covered by Oracle's Premier Support (which typically lasts 5 years +from initial General Availability). If the minimum required JVM for a given +library is changed, it is accompanied by a [semver][semver] major release. + +Java 11 and (in September 2021) Java 17 are the best choices for new +development. + +### Keeping production systems current + +Google tests its client libraries with all current LTS versions covered by +Oracle's Extended Support (which typically lasts 8 years from initial +General Availability). + +#### Legacy support + +Google's client libraries support legacy versions of Java runtimes with long +term stable libraries that don't receive feature updates on a best efforts basis +as it may not be possible to backport all patches. + +Google provides updates on a best efforts basis to apps that continue to use +Java 7, though apps might need to upgrade to current versions of the library +that supports their JVM. + +#### Where to find specific information + +The latest versions and the supported Java versions are identified on +the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME` +and on [google-cloud-java][g-c-j]. + ## Versioning @@ -144,6 +193,7 @@ This library follows [Semantic Versioning](http://semver.org/). It is currently in major version zero (``0.y.z``), which means that anything may change at any time and the public API should not be considered stable. + ## Contributing @@ -155,6 +205,7 @@ Please note that this project is released with a Contributor Code of Conduct. By this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information. + ## License Apache 2.0 - See [LICENSE][license] for more information. @@ -187,6 +238,9 @@ Java is a registered trademark of Oracle and/or its affiliates. [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-errorreporting.svg [maven-version-link]: https://search.maven.org/search?q=g:com.google.cloud%20AND%20a:google-cloud-errorreporting&core=gav [authentication]: https://github.com/googleapis/google-cloud-java#authentication +[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes +[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles +[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy [developer-console]: https://console.developers.google.com/ [create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects [cloud-sdk]: https://cloud.google.com/sdk/ @@ -198,3 +252,9 @@ Java is a registered trademark of Oracle and/or its affiliates. [enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=clouderrorreporting.googleapis.com [libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png + +[semver]: https://semver.org/ +[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained +[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries +[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html +[g-c-j]: http://github.com/googleapis/google-cloud-java diff --git a/google-cloud-errorreporting-bom/pom.xml b/google-cloud-errorreporting-bom/pom.xml index e6b3043d..be43e010 100644 --- a/google-cloud-errorreporting-bom/pom.xml +++ b/google-cloud-errorreporting-bom/pom.xml @@ -3,12 +3,12 @@ 4.0.0 com.google.cloud google-cloud-errorreporting-bom - 0.121.4-beta + 0.121.5-beta pom com.google.cloud google-cloud-shared-config - 0.12.0 + 0.13.1 Google Cloud errorreporting BOM @@ -39,17 +39,6 @@ https://github.com/googleapis/java-errorreporting - - - sonatype-nexus-snapshots - https://oss.sonatype.org/content/repositories/snapshots - - - sonatype-nexus-staging - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - - The Apache Software License, Version 2.0 @@ -63,17 +52,17 @@ com.google.cloud google-cloud-errorreporting - 0.121.4-beta + 0.121.5-beta com.google.api.grpc grpc-google-cloud-error-reporting-v1beta1 - 0.87.4 + 0.87.5 com.google.api.grpc proto-google-cloud-error-reporting-v1beta1 - 0.87.4 + 0.87.5 diff --git a/google-cloud-errorreporting/pom.xml b/google-cloud-errorreporting/pom.xml index f9a8d2b9..c5ddc121 100644 --- a/google-cloud-errorreporting/pom.xml +++ b/google-cloud-errorreporting/pom.xml @@ -3,7 +3,7 @@ 4.0.0 com.google.cloud google-cloud-errorreporting - 0.121.4-beta + 0.121.5-beta jar Google Cloud Error Reporting https://github.com/googleapis/java-errorreporting @@ -11,7 +11,7 @@ com.google.cloud google-cloud-errorreporting-parent - 0.121.4-beta + 0.121.5-beta google-cloud-errorreporting diff --git a/grpc-google-cloud-error-reporting-v1beta1/pom.xml b/grpc-google-cloud-error-reporting-v1beta1/pom.xml index 0b09614e..2d2cd2e2 100644 --- a/grpc-google-cloud-error-reporting-v1beta1/pom.xml +++ b/grpc-google-cloud-error-reporting-v1beta1/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc grpc-google-cloud-error-reporting-v1beta1 - 0.87.4 + 0.87.5 grpc-google-cloud-error-reporting-v1beta1 GRPC library for grpc-google-cloud-error-reporting-v1beta1 com.google.cloud google-cloud-errorreporting-parent - 0.121.4-beta + 0.121.5-beta diff --git a/java.header b/java.header index 3a9b503a..d0970ba7 100644 --- a/java.header +++ b/java.header @@ -1,5 +1,5 @@ ^/\*$ -^ \* Copyright \d\d\d\d,? Google (Inc\.|LLC)( All [rR]ights [rR]eserved\.)?$ +^ \* Copyright \d\d\d\d,? Google (Inc\.|LLC)$ ^ \*$ ^ \* Licensed under the Apache License, Version 2\.0 \(the "License"\);$ ^ \* you may not use this file except in compliance with the License\.$ diff --git a/pom.xml b/pom.xml index 090a044b..372f4098 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.google.cloud google-cloud-errorreporting-parent pom - 0.121.4-beta + 0.121.5-beta Google Cloud Error Reporting Parent https://github.com/googleapis/java-errorreporting @@ -14,7 +14,7 @@ com.google.cloud google-cloud-shared-config - 0.12.0 + 0.13.1 @@ -41,16 +41,7 @@ https://github.com/googleapis/java-errorreporting/issues GitHub Issues - - - sonatype-nexus-snapshots - https://oss.sonatype.org/content/repositories/snapshots - - - sonatype-nexus-staging - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - + Apache-2.0 @@ -70,17 +61,17 @@ com.google.cloud google-cloud-errorreporting - 0.121.4-beta + 0.121.5-beta com.google.api.grpc proto-google-cloud-error-reporting-v1beta1 - 0.87.4 + 0.87.5 com.google.api.grpc grpc-google-cloud-error-reporting-v1beta1 - 0.87.4 + 0.87.5 diff --git a/proto-google-cloud-error-reporting-v1beta1/pom.xml b/proto-google-cloud-error-reporting-v1beta1/pom.xml index a9709a8e..ff52d5bd 100644 --- a/proto-google-cloud-error-reporting-v1beta1/pom.xml +++ b/proto-google-cloud-error-reporting-v1beta1/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc proto-google-cloud-error-reporting-v1beta1 - 0.87.4 + 0.87.5 proto-google-cloud-error-reporting-v1beta1 PROTO library for proto-google-cloud-error-reporting-v1beta1 com.google.cloud google-cloud-errorreporting-parent - 0.121.4-beta + 0.121.5-beta diff --git a/renovate.json b/renovate.json index 484eb3d7..87f0dbf3 100644 --- a/renovate.json +++ b/renovate.json @@ -69,5 +69,8 @@ } ], "semanticCommits": true, - "masterIssue": true + "dependencyDashboard": true, + "dependencyDashboardLabels": [ + "type: process" + ] } diff --git a/samples/install-without-bom/pom.xml b/samples/install-without-bom/pom.xml index 5e9663fc..6376b76e 100644 --- a/samples/install-without-bom/pom.xml +++ b/samples/install-without-bom/pom.xml @@ -29,14 +29,14 @@ com.google.cloud google-cloud-errorreporting - 0.121.3-beta + 0.121.4-beta com.google.cloud google-cloud-core - 1.95.4 + 1.96.0 junit diff --git a/samples/snapshot/pom.xml b/samples/snapshot/pom.xml index b6fc535f..75469086 100644 --- a/samples/snapshot/pom.xml +++ b/samples/snapshot/pom.xml @@ -28,14 +28,14 @@ com.google.cloud google-cloud-errorreporting - 0.121.4-beta + 0.121.5-beta com.google.cloud google-cloud-core - 1.95.4 + 1.96.0 junit diff --git a/samples/snippets/pom.xml b/samples/snippets/pom.xml index 209eaef9..c01b935d 100644 --- a/samples/snippets/pom.xml +++ b/samples/snippets/pom.xml @@ -30,7 +30,7 @@ com.google.cloud libraries-bom - 20.7.0 + 20.9.0 pom import diff --git a/synth.metadata b/synth.metadata index 4fd5123e..761a583b 100644 --- a/synth.metadata +++ b/synth.metadata @@ -4,7 +4,7 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-errorreporting.git", - "sha": "a951d1eed4dbd4540226723f0b2189407c2bf3d6" + "sha": "4d18b8377f7ddeeb1063ee7f65e0692ace4f502f" } }, { @@ -19,7 +19,7 @@ "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "87254ac89a9559864c0a245d6b150406439ce3d8" + "sha": "5d3c52f5db664eee9026db76b5bcb466f3a09ca9" } } ], diff --git a/versions.txt b/versions.txt index 48d3946e..8aca86a2 100644 --- a/versions.txt +++ b/versions.txt @@ -1,6 +1,6 @@ # Format: # module:released-version:current-version -grpc-google-cloud-errorreporting-v1beta1:0.87.4:0.87.4 -proto-google-cloud-errorreporting-v1beta1:0.87.4:0.87.4 -google-cloud-errorreporting:0.121.4-beta:0.121.4-beta \ No newline at end of file +grpc-google-cloud-errorreporting-v1beta1:0.87.5:0.87.5 +proto-google-cloud-errorreporting-v1beta1:0.87.5:0.87.5 +google-cloud-errorreporting:0.121.5-beta:0.121.5-beta \ No newline at end of file