Skip to content

docs(ios): document the other fastlane actions; note Bitcode is gone #101

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
krassx wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs(ios): document the other fastlane actions; note Bitcode is gone #101

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1fb951f
docs(ios): document the other fastlane actions; note Bitcode is gone
krassx Oct 16, 2026
150082e
docs(ios): clarify Bitcode history and size-analysis upload defaults
krassx Oct 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion docs/sdk/ios/symbolication.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ lane :mybuildlane do
end
```

Builds uploaded with Bitcode (Xcode 13 and earlier) were recompiled by Apple, so their dSYM files have to be downloaded from App Store Connect instead:
Xcode 14 deprecated Bitcode and stopped building it by default, and Xcode 15 removed it, so for current builds the dSYMs from your own archive are the right ones. Builds uploaded with Bitcode (Xcode 13 and earlier) were recompiled by Apple, so their dSYM files have to be downloaded from App Store Connect instead:

```
lane :refresh_dsyms do
Expand All @@ -446,3 +446,20 @@ lane :refresh_dsyms do
clean_build_artifacts # Delete the local dSYM files
end
```

### Other fastlane actions

Besides `upload_symbols_to_bugsee`, the plugin has two more actions. Update the plugin (`bundle update fastlane-plugin-bugsee`) to get them. Both are optional. The [Bugsee Android Gradle plugin](/sdk/android/gradle-plugin) handles mapping and build-info uploads, but artifact bytes need `buildInfo.sizeAnalysis.enabled = true`. The iOS SDK's Archive post-action handles dSYM and build-info uploads, but IPA bytes need `BUGSEE_SIZE_ANALYSIS_ENABLED=1`.

**`upload_artifact_to_bugsee`** packages a built `.app` and uploads it for [app size analysis](/cli/builds). Use it when your CI does not run the SDK's Archive post-action, or when the build machine has no token and a separate publish machine does.

```ruby
upload_artifact_to_bugsee(
app_token: ENV["BUGSEE_APP_TOKEN"],
xcarchive_path: ENV["XCARCHIVE_PATH"],
# or app_path: "build/Products/Release-iphoneos/MyApp.app",
# build_info_only: true, # record the size, don't upload the .ipa
)
```

**`upload_mapping_to_bugsee`** uploads an Android ProGuard / R8 `mapping.txt`. It is for Android builds and is mentioned here only because it ships in the same plugin. See the [plugin README](https://github.com/bugsee/fastlane-plugin-bugsee#android-mapping-proguard--r8-upload) for its parameters.
Loading