https://github.com/bugsnag/bugsnag-dsym-upload
Scripts and Fastlane tasks for uploading dSYM files to BugSnag
https://github.com/bugsnag/bugsnag-dsym-upload
bugsnag dsym error-reporting fastlane homebrew platforms
Last synced: about 1 month ago
JSON representation
Scripts and Fastlane tasks for uploading dSYM files to BugSnag
- Host: GitHub
- URL: https://github.com/bugsnag/bugsnag-dsym-upload
- Owner: bugsnag
- License: mit
- Created: 2016-08-25T16:42:05.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-02-13T09:18:48.000Z (3 months ago)
- Last Synced: 2025-04-04T00:57:03.928Z (about 2 months ago)
- Topics: bugsnag, dsym, error-reporting, fastlane, homebrew, platforms
- Language: Ruby
- Homepage: https://docs.bugsnag.com/build-integrations/fastlane/
- Size: 4.03 MB
- Stars: 37
- Watchers: 29
- Forks: 13
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Support: .github/support.md
Awesome Lists containing this project
README
# bugsnag-dsym-upload
Commands for uploading files to Bugsnag via the Bugsnag Upload APIs
## Current Features
* Uploads dSYM files in bulk
* Converts bitcode-enabled symbol files stripped of symbol names into full files
## Installation
### Basic
Copy `bin/bugsnag-dsym-upload` into your `PATH`, or run `make install` to
install to the default directory, `/usr/lib/bin`.
View usage [here](man/bugsnag-dsym-upload.pod) or using `man
bugsnag-dsym-upload`
### [Homebrew](https://brew.sh)
Install via the Homebrew formula:
```
brew install bugsnag/tap/bugsnag-dsym-upload
```
This will also add the Bugsnag Homebrew tap for future updates.
### [Fastlane](https://fastlane.tools)
Add `bugsnag` as a plugin in your configuration:
```
fastlane add_plugin bugsnag
```
Then add the `upload_symbols_to_bugsnag` action to your lane:
```ruby
lane :refresh_dsyms do
download_dsyms(version: "1.4.2.1") # Download dSYM files from App Store Connect
upload_symbols_to_bugsnag # Upload them to Bugsnag
clean_build_artifacts # Delete the local dSYM files
end
```
Common options:
* `api_key`: The API key associated with the project. Informs Bugsnag which project
the dSYMs should be applied to.
* `dsym_path`: A path or array of paths for directories containing \*.dSYM files
or a single \*.zip file to upload. If unspecified, the default behavior is to
upload the zip files retrieved by a prior invocation of
[`download_dsyms`](https://docs.fastlane.tools/actions/#download_dsyms), or
any .dSYM files within the current directory.
* `upload_url`: The URL of the server receiving symbol files. Update this value
if you are using a private instance of Bugsnag
* `config_file`: The path to the project's Info.plist. Set this value if your configuration file
is not automatically detected.
View usage additional usage information and options by running:
```shell
fastlane action upload_symbols_to_bugsnag
```
For more information, take a look at the Bugsnag docs on
[using the Fastfile plugin](https://docs.bugsnag.com/build-integrations/fastlane/).
Check out the [example `Fastfile`](tools/fastlane-plugin/fastlane/Fastfile) to
see how to use this plugin. Try it by cloning the repo, running `fastlane
install_plugins` and `bundle exec fastlane test`.
If you have trouble using plugins, check out the [Plugins
Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/)
guide.
## License
This module is free software released under the MIT License. See [LICENSE.txt](LICENSE.txt) for details.