About apptics
Fastlane plugin for Apptics to handle store relates operations
dSYM upload plugin
This plugin allows uploading the dSYM files automatically even for the bitcode-enabled apps.
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 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
brew install fastlane
Getting Started
This project is a fastlane plugin. To get started with fastlane-plugin-apptics
, add it to your project by running:
sudo fastlane add_plugin apptics
Download dSYM using Fastlane
- To download the dSYM files from App Store Connect for bitcode-enabled apps, use the below command.
download_dsyms(app_identifier:"" ,version:"", build_number:"")
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.
upload_dsym_to_apptics(appversion:"",bundleid:"", dsymfilepath: "",modevalue:"", platformvalue:"" ,configfilepath:"",buildversion:"")
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,watchOS,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.
clean_build_artifacts
Lane Setup
Add the below to the Fastlane/Fastfile.
default_platform(:ios)
platform :ios do
desc "Download and upload dSYM files to apptics"
lane :custom_lane do |options|
download_dsyms(app_identifier: "com.zoho.apptics",version: "2.7.1",build_number: "2.3")
upload_dsym_to_apptics(appversion:"2.7.1",bundleid:"com.zoho.apptics", dsymfilepath: "com.zoho.apptics-2.7.1-2.0.534.dSYM.zip",modevalue:"1", platformvalue:"iOS" ,configfilepath:"/Documents/apptics-config.plist",buildversion:"2.0.4")
clean_build_artifacts
end
end
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.
default_platform(:ios)
platform :ios do
desc "Description of what the lane does"
lane :custom_lane do |options|
bundleid = options[:bundleid]
version = options[:version]
buildnumber = options[:buildnumber]
configpath = options[:configpath]
mode = options[:mode]
platform = options[:platform]
download_dsyms(app_identifier: bundleid,version: version,build_number: buildnumber)
upload_dsym_to_apptics(appversion:version,bundleid:"#{bundleid}", dsymfilepath: "#{bundleid}-#{version}-#{buildnumber}.dSYM.zip",modevalue:mode, platformvalue:platform ,configfilepath:"#{configpath}",buildversion:buildnumber)
clean_build_artifacts
end
end
Try running the lane in the CLT using the below.
fastlane custom_lane bundleid:com.zoho.apptics version:2.7 buildnumber:2.5 configpath:<PROJECT_PATH>/apptics-config.plist mode:1 platform:iOS