Skip to content
This plugin allows you to decode and upload symbolication files to Dynatrace. You can also use it to first download your latest dSym files from AppStore Connect if you use Bitcode.
Ruby
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
fastlane Initial commit Apr 4, 2019
lib/fastlane/plugin Removed Bundle name requirement May 20, 2019
spec Initial commit Apr 4, 2019
.gitattributes Initial commit Apr 4, 2019
.gitignore
.rspec
.rubocop.yml Initial commit Apr 4, 2019
.travis.yml
Gemfile Initial commit Apr 4, 2019
LICENSE Initial commit Apr 4, 2019
README.md Update README.md May 28, 2019
Rakefile
fastlane-plugin-dynatrace.gemspec

README.md

dynatrace plugin

fastlane Plugin Badge

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-dynatrace, add it to your project by running:

fastlane add_plugin dynatrace

Make sure you have the latest version of the DSS client (bundled with the agent). You can download it here Latest iOS Agent

About dynatrace

This plugin allows you to decode and upload symbolication files to Dynatrace. You can also use it to first download your latest dSym files from AppStore Connect if you use Bitcode.

Action: dynatrace_process_symbols

Supported Platforms ios, android
Author @MANassar

Parameters

Key Description default value
downloadDsyms Boolean variable that enables downloading the Dsyms from AppStore Connect (iOS only) false
username The username or the AppleID to use to download the Dsyms. You can also store this in your AppFile as "apple_id and it will be automatically retrieved."
dtxDssClientPath The full path to your DTXDssClient. For example, it could be ./ios/agent/DTXDssClient ./DTXDssClient
action The action to perform. upload/decode upload
appID The app ID you get from your Dynatrace WebUI
os The OperatingSystem of the symbol files. Either "ios" or "android"
apitoken The Dynatrace API token. It should have the correct permissions.
bundleId The CFBundlebundleId (iOS) / package (Android) of the Application. Usually in reverse com notation. Ex. com.your_company.your_app. This can also be stored in the AppFile as "app_identifier" and it will be automatically retrieved.
bundleName The CFBundleName of the Application (iOS only)
versionStr The CFBundleShortVersionString (iOS) / versionName (Android
version The CFBundleVersion (iOS) / versionCode (Android). This will also be used for dsym download.
symbolsfile The path to a local symbol files to be processed and uploaded. You do not need to specify that if you use downloadDsyms.
server The API endpoint for the Dynatrace environment. For example https://environmentID.live.dynatrace.com or https://dynatrace-managed.com/e/environmentID
debugMode Debug logging enabled false

Example

Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

##Example

In your fastfile

Supplying all parameters locally

dynatrace_process_symbols(
	dtxDssClientPath:"<path>/DTXDssClient",
	appId: "your DT appID",
	apitoken: "your DT API token",
	os: "<ios> or <android>",
	bundleId: "com.yourcompany.yourApp",
	bundleName: "MyApp",
	versionStr: "1.0",
	version: "1",
	symbolsfile: "<path to my app>.app.dSYM",
	server: "https://<environmentID.live.dynatrace.com",
	debugMode: true)

Downloading dsyms and using AppFile

AppFile

app_identifier("com.yourcompany.yourappID") # The bundle identifier of your app
apple_id("user@email.com") # Your Apple email address

Fastfile

dynatrace_process_symbols(
	downloadDsyms: true,
	dtxDssClientPath:"<path>/DTXDssClient",
	appId: "your DT appID",
	apitoken: "your DT API token",
	os: "<ios> or <android>",
	bundleName: "MyApp",
	versionStr: "1.0",
	version: "1",
	server: "https://<environmentID.live.dynatrace.com",
	debugMode: true)

Downloading dsyms, using AppFile - Only decoding them

AppFile

app_identifier("com.yourcompany.yourappID") # The bundle identifier of your app
apple_id("user@email.com") # Your Apple email address

Fastfile

dynatrace_process_symbols(	
	action = "decode",
	downloadDsyms: true,
	dtxDssClientPath:"<path>/DTXDssClient",
	appId: "your DT appID",
	apitoken: "your DT API token",
	os: "<ios> or <android>",
	bundleName: "MyApp",
	versionStr: "1.0",
	version: "1",
	server: "https://dynatrace-managed.com/e/environmentID",
	debugMode: true)

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository or contact Dynatrace Support.

Troubleshooting

If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

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.

You can’t perform that action at this time.