dSYM plugin for Cocoa apps

This plugin allows uploading the dSYM files automatically even for the bitcode-enabled apps.

Setup

• Setup the Xcode CLT using the xcode-select --install.
• To install Fastlane on your Mac, follow the steps below.
  • Open the terminal on your Mac.
  • Navigate to the project folder.

You can install Fastlane using Ruby Gems. 

System Ruby and Ruby Gems (macOS/Linux/Windows) or Homebrew (macOS)

• Install the Fastlane using sudo gem install fastlane -NV.
• To confirm the Fastlane installation, use the fastlane -v command.
• Go to the project's directory and run sudo fastlane init to create a gemfile and Fastlane directory in the project.
• You can now create custom lanes in your Fastlane. For more information, please visit https://docs.fastlane.tools/getting-started/ios/setup/ .

Homebrew (macOS)

• Using homebrew will install the correct Ruby version needed for Fastlane. For more information, please visit https://formulae.brew.sh/formula/fastlane .

Getting started

• Run the below command to get started with the fastlane-plugin-Apptics.

• To download a specific gem, mention the version and run the below command.

Download dSYM using Fastlane

• To download the dSYM files from App Store Connect for bitcode-enabled apps, use the below command.

Parameters:

• app_identifier - The app bundle identifier for the dSYMs that you want to download.
• build_number - The app build_number for the dSYMs that you want to download.
• version - The app version for the dSYMs that you want to download.

Example

The following environment variables maybe used in place of parameters:

app_identifier: com.zoho.apptics

build_number: 2.3

version: 2.7

download_dsyms(app_identifier: "com.zoho.apptics",version: "2.7",build_number: "2.3 ")

Upload dSYM files to Apptics

Use the below to upload the dSYM files to Apptics.

Parameters:

• appversion - The app version for the dSYMs that you want to download.
• bundleid - The bundle id for the dSYMs that you want to upload.
• dsymfilepath - Path to the dSYM file or zip to upload.
• modevalue - development or release (0 or 1).
• platformvalue - The app platform for the dSYMs that you want to upload (iOS, macOS…).
• configfilepath - Path to the Config file (<PROJECT_PATH>/apptics-config.plist ).

Clean_build_artifacts:

• Use this action to delete files created as a result of running download_dsyms.

Lane Setup:

Add the below to the Fastlane/Fastfile.

Try running the lane in the CLT using fastlane custom_lane or fastlane lane_name.

Lane Setup Using CLT:

Add the below to the Fastlane/Fastfile.

Try running the lane in the CLT using the below.