Skip to content

Conversation

@noahsmartin
Copy link
Contributor

DESCRIBE YOUR PR

Adding docs for the new update SDK released in iOS v9

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

EXTRA RESOURCES

@vercel
Copy link

vercel bot commented Dec 3, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
sentry-docs Ready Ready Preview Comment Dec 4, 2025 1:38pm
1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
develop-docs Ignored Ignored Preview Dec 4, 2025 1:38pm

Copy link
Member

@philipphofmann philipphofmann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, with two suggestions.

Copy link
Member

@philipphofmann philipphofmann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, one more suggestion.

Comment on lines +47 to +54
Button("Check For Update") {
let params = CheckForUpdateParams(
accessToken: "MY_TOKEN",
organization: "___ORG_SLUG___",
project: "___PROJECT_SLUG___")
Updater.checkForUpdate(params: params) { result in
handleUpdateResult(result: result)
}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Way better thanks

Comment on lines 24 to 25
<Include name="build-distribution/create-integration-token" />
8. Save the new token, you will need it when using the SDK from Swift.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

m: That's looks very fragile and easy to break when somebody changes the include. I think you should be able to use 1. 1. 1. for all bullet points and markdown will just add the correct numbers for you.

so basically do this in the include

1. Navigate to **Settings > Custom Integrations** in your Sentry organization
1. Click **Create New Integration**
  ![Create New Integration =800x](./images/create-new-integration.png)

1. Select **Internal Integration** and click **Next**
  ![Internal Integration =600x](./images/internal-integration.png)

1. Give your integration a name (e.g., "Build Distribution")
  ![Name token =800x](./images/name-token.png)
1. Under **Permissions**, select **Read** next to the **Distribution** scope.
  ![Set Permissions =800x](./images/set-permissions.png)
1. Click **Save Changes**
1. Scroll down to the Tokens section and click **New Token**
   ![Create New Token =800x](./images/create-auth-token.png)

and then

Suggested change
<Include name="build-distribution/create-integration-token" />
8. Save the new token, you will need it when using the SDK from Swift.
<Include name="build-distribution/create-integration-token" />
1. Save the new token, you will need it when using the SDK from Swift.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Never knew that before, neat!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So that didn't work, any idea if there is another way @philipphofmann ?

Screenshot 2025-12-03 at 7 17 42 PM

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nope, sorry, then maybe it doesn't work.

Copy link
Member

@philprime philprime left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@codecov
Copy link

codecov bot commented Dec 3, 2025

Bundle Report

Changes will increase total bundle size by 60.27kB (0.17%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-server-cjs 24.38MB 60.28kB (0.25%) ⬆️
sentry-docs-client-array-push 10.22MB -6 bytes (-0.0%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
static/chunks/pages/_app-*.js -3 bytes 893.1kB -0.0%
static/chunks/9366-*.js -3 bytes 436.99kB -0.0%
static/ScVBLo1FGwmyYH_zZ3nGQ/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/ScVBLo1FGwmyYH_zZ3nGQ/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/yZeIN0FW_KeJdFWaz647S/_buildManifest.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/yZeIN0FW_KeJdFWaz647S/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️
view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -3 bytes 5.46MB -0.0%
6529.js -3 bytes 4.88MB -0.0%
../instrumentation.js -3 bytes 4.78MB -0.0%
../app/[[...path]]/page.js.nft.json 20.1kB 961.07kB 2.14%
../app/platform-redirect/page.js.nft.json 20.1kB 960.98kB 2.14%
../app/sitemap.xml/route.js.nft.json 20.1kB 958.51kB 2.14%

Copy link
Contributor

@runningcode runningcode left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great!

}
```

This expect to find the environment variable `SENTRY_DISTRIBUTION_AUTH_TOKEN`, copy the token you generated in the preceding step to this variable in your CI environment.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This expect to find the environment variable `SENTRY_DISTRIBUTION_AUTH_TOKEN`, copy the token you generated in the preceding step to this variable in your CI environment.
This expects to find the environment variable `SENTRY_DISTRIBUTION_AUTH_TOKEN`, copy the token you generated in the preceding step to this variable in your CI environment.

![Set Permissions =800x](./images/set-permissions.png)
1. Click **Save Changes**
1. Scroll down to the Tokens section and click **New Token**
![Create New Token =800x](./images/create-auth-token.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: indentation


## Usage

Use the SDK by calling `Updater.checkForUpdate(params: )`. In addition to the access token, provide your Sentry org and project slug in the CheckForUpdateParams. For example:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not very familiar with xcode but is there a way to provide a script to xcode that would create a file in the app that would automatically pass these things in?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants