dynatrace plugin
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
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("[email protected]") # 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("[email protected]") # 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.