fastlane-plugin-luciq_dsym_upload

About This Plugin

The luciq_dsym_upload plugin for fastlane provides a streamlined way to upload dSYM symbolication files directly to Luciq. This is essential for debugging and analyzing crash reports.

This action integrates seamlessly into your CI/CD workflow. You can use it with gym to upload dSYMs generated during the build process, or with download_dsyms if you have Bitcode enabled and need to fetch the dSYMs from Apple's App Store Connect first.

Getting Started

To get started, add the luciq_dsym_upload plugin to your project by running this command in your terminal:

fastlane add_plugin luciq_dsym_upload

Usage

Integrate the luciq_dsym_upload action into your Fastfile. Below are some common usage examples.

Basic Upload

The simplest use case is to provide your Luciq token. The plugin will automatically find and upload the dSYM file generated by a preceding gym or download_dsyms action.

# In your Fastfile

lane :release do
  gym
  luciq_dsym_upload(api_token: "<Your Luciq token>")
end

Uploading Specific dSYM Files

If you need to upload specific dSYM files from custom paths, use the dsym_array_paths parameter.

luciq_dsym_upload(
  api_token: "<Your Luciq token>",
  dsym_array_paths: ["./App1.dSYM.zip", "./App2.dSYM.zip"]
)

Targeting the EU Cluster

If your organization uses Luciq's EU data cluster, set the eu parameter to true.

luciq_dsym_upload(
  api_token: "<Your Luciq token>",
  eu: true
)

Using a Custom Endpoint

For custom or on-premise setups, you can specify a different API endpoint using the end_point parameter.

luciq_dsym_upload(
  api_token: "<Your Luciq token>",
  end_point: "https://api.luciq.ai/api/sdk/v3/symbols_files"
)

Parameters

Key	Description	Required	Default Value
`api_token`	Your API token for Luciq.	Yes	-
`dsym_array_paths`	An array of paths to specific `.dSYM.zip` files you want to upload.	No	Automatically detected
`eu`	Set to `true` if you are using the EU cluster in the Luciq SDK.	No	`false`
`end_point`	The custom API endpoint for dSYM uploads.	No	Luciq's default endpoint

Issues and Feedback

If you encounter any issues or have feedback for this plugin, please submit an issue to this repository.

For general troubleshooting with fastlane plugins, please review the official Plugins Troubleshooting Guide.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.