google_cloud

google_cloud.dart

• BREAKING: No longer exports logging or HTTP serving features. These are now exported by the new packages:

  • package:google_cloud_logging
  • package:google_cloud_shelf

constants.dart

• BREAKING: Removed logging and serving related constants:

  • portEnvironmentVariable
  • defaultListenPort
  • cloudTraceContextHeader
  • logTraceKey
  • logSpanIdKey
  • logTraceSampledKey

  These constants are available in the new package:google_cloud_shelf.

general.dart

• BREAKING: No longer exports logging features. Use package:google_cloud_logging instead.
• DEPRECATED: Use google_cloud.dart instead.

http_serving.dart

• BREAKING: Library file has been removed entirely. All HTTP serving features are now in the new package:google_cloud_shelf package.

• Update dependency meta: ^1.17.0 to allow workspaces with stable Flutter.

constants.dart

• Added logSpanIdKey, logTraceKey, and logTraceSampledKey.

general.dart

• BREAKING structuredLogEntry removed traceId parameter. Use the new payload parameter with the logTraceKey constant as a key.

• Hardened structured log JSON serialization with automatic fallback mechanisms to safely handle native toJson() implementations and circular references without failing.

• Added CloudLogger (renamed from RequestLogger).

  • Added optional payload and stackTrace named parameters to CloudLogger functions.
  • CloudLogger is no longer abstract and has a default implementation that prints to stdout.

http_serving.dart

• BREAKING Renamed RequestLogger to CloudLogger and moved it to package:google_cloud/general.dart.
• Refactored HTTP logging logic to handle spanId and traceSampled.

• Fix a bug where projectIdFromGcloudConfig() used the incorrect gcloud shell command on Windows.

BREAKING CHANGES

• Split the library into two main entry points:
  • package:google_cloud/general.dart for general GCP features like project discovery, identity discovery, and core structured logging.
  • package:google_cloud/http_serving.dart for HTTP serving features like port discovery, shelf middleware, and signal handling.
  • package:google_cloud/google_cloud.dart remains as an umbrella library exporting both.
• Renamed projectIdFromEnvironment() to projectIdFromEnvironmentVariables().
• Renamed portEnvironmentKey to portEnvironmentVariable.
• Renamed listenPort() to listenPortFromEnvironment().
• computeProjectId(), projectIdFromMetadataServer(), and serviceAccountEmailFromMetadataServer() now leverage a unified process-wide metadata cache.
• Breaking Change: Local discovery strategies (environment variables, credentials files, and gcloud config) are no longer cached.
• Breaking Change: projectIdFromMetadataServer() and serviceAccountEmailFromMetadataServer() now throw MetadataServerException (which wraps SocketException, TimeoutException, or ClientException) when discovery fails.
• Constants are now exported via package:google_cloud/constants.dart and are no longer exported by package:google_cloud/google_cloud.dart.
• Require Dart 3.9.
• Require package:http ^1.1.0.

New Features

• Added getMetadataValue() (caching) and fetchMetadataValue() (non-caching) to package:google_cloud/general.dart.
• Added projectIdFromCredentialsFile() to automatically discover project ID from the credentials JSON file.
• Added projectIdFromGcloudConfig() to automatically discover project ID from gcloud CLI configuration.
• Added serviceAccountEmailFromMetadataServer() to discover the default service account email.
• Added gceMetadataHost and gceMetadataUrl to interact with the metadata server.
• projectIdFromMetadataServer() now respects the GCE_METADATA_HOST environment variable.
• Added refresh parameter to computeProjectId(), projectIdFromMetadataServer(), and serviceAccountEmailFromMetadataServer() to force re-discovery.
• Added client parameter to computeProjectId(), projectIdFromMetadataServer(), and serviceAccountEmailFromMetadataServer() to allow providing a custom http.Client.
• Added structuredLogEntry() for low-level structured log creation.

• First release replacing package:gcp.