v0.17.0-beta.1

Faro Flutter SDK v0.17.0-beta.1

Changed

• Renamed the SDK-generated install identifier model and provider to
  InstallationId / InstallationIdProvider. The persisted device_id
  storage key and legacy flat session.attributes['device_id'] payload key are
  unchanged for migration compatibility.
• Swapped the underlying OpenTelemetry implementation from the Workiva
  opentelemetry Dart package to dartastic_opentelemetry for tracing.
  (#242)

Deprecated

• DeviceId is deprecated; use InstallationId instead. The deprecated alias
  is kept for backward compatibility.

Added

• Emit structured mobile metadata in Flutter SDK payloads:
  meta.device, meta.os, meta.app.installationId, and
  exception.fatal, while keeping legacy flat session attributes during
  migration.
  The duplicated flat device_* session attributes are kept for compatibility
  and can be removed after collector and plugin query parity is confirmed.

Changed

• CI: Attest SLSA build provenance for the published pub.dev archive.
  Inlined the dart-lang/setup-dart reusable publish workflow so we can
  download the canonical archive pub.dev serves and attest those bytes via
  actions/attest-build-provenance. Consumers can verify with
  gh attestation verify <tarball> --repo grafana/faro-flutter-sdk.

Fixed

• Preserve stack trace lines that do not match the expected Dart VM format
  instead of silently dropping the whole stack trace. Lines that cannot be
  parsed into structured frames (e.g. sanitized, obfuscated, or free-form
  lines) are now kept as raw text in the frame's function field.
  (#102)
• iOS native crash reports no longer lose all stack frames: a broken
  work-in-progress sanitization step in CrashReportingIntegration
  unconditionally replaced non-empty stack traces with an empty array
  before export. The dead sanitization has been removed so frames flow
  through to the exported crash payload. Load/parse failures of pending
  crash reports are now logged with a clearer message before the report
  is purged. (#220)

See CHANGELOG.md for complete details.

---

Full Changelog: v0.16.0...v0.17.0-beta.1