Skip to content

[skill-drift] update(sentry-cocoa-sdk): deprecate widget APIs, document new feedback presentation methods #169

Description

@github-actions

Warning

Auto-generated from external SDK content. Review all links and code suggestions before acting on them.

cc @getsentry/ai-sdks

Summary

The User Feedback section documents deprecated APIs that will be removed in SDK v10. Recent PRs introduced new recommended presentation methods that are not documented.

Deprecated APIs (still documented in skill)

Widget APIs (PR #8022, deprecated June 9):

  • autoInject, configureWidget, showWidget(), hideWidget(), labelText, showIcon, location, layoutUIOffset, windowLevel, widgetAccessibilityLabel
  • Entire SentryUserFeedbackWidgetConfiguration section

Custom button (PR #8052, deprecated June 15):

  • customButton property

New APIs (missing from skill)

Programmatic presentation (PR #7873, added June 9):

  • SentrySDK.feedback.show(screenshot:) - show form from best available presenter
  • SentryUserFeedbackFormController() - direct view controller instantiation

SwiftUI support (PR #7873):

  • .sentryFeedback(isPresented:screenshot:) - SwiftUI view modifier
  • SentrySDK.FeedbackFormView / SentryUserFeedbackFormView - SwiftUI wrapper view

App Start tracing (PR #8003, merged June 9):

  • Standalone app start child spans now use distinct operations: app.start.pre_runtime_init, app.start.runtime_init, app.start.uikit_init, app.start.application_init, app.start.extended_app_start (informational, no user action required)

Migration questions

  1. Should we document both old (deprecated) and new APIs during the transition period, or replace entirely?
  2. How to restructure the Quick Start examples to prefer the new APIs?
  3. The widget approach was auto-inject by default; the new approach requires users to add their own UI trigger - should we provide button examples?
  4. Should the app start span operation change be documented in the tracing reference, or is it internal-only?

Affected files

  • skills/sentry-cocoa-sdk/references/user-feedback.md - major rewrite needed
  • skills/sentry-cocoa-sdk/SKILL.md - Quick Start examples still show deprecated widget config (lines 295-296 in main skill)
  • skills/sentry-cocoa-sdk/references/tracing.md - possibly add app start span operation note

Reviewed PRs

  • #8022 - Deprecate User Feedback Widget
  • #8052 - Deprecate User Feedback custom button
  • #7873 - Add managed user feedback form presentation APIs
  • #8003 - Use distinct span operations for app start phases
  • #8018 - Add per-form feedback configuration
  • #8050 - Fix: show feedback form from shake/screenshot without widget
  • #8040 - Mark feedback form unavailable in app extensions
  • #8027 - Expose feedback form APIs in SentryObjC

Metadata

Metadata

Assignees

No one assigned

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions