This project is build to serve our customer/partners and give an overview of the Android agent features.
To get a local copy up and running follow these simple steps.
Android Studio downloaded (i.e. from developer.android.com) and installed.
Set of env properties, below example values for macOS 10.15
export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_261.jdk/Contents/Home"
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:/usr/local/opt/openjdk/bin"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
export PATH="$PATH:$ANDROID_HOME/emulator"
export PATH="$PATH:$ANDROID_HOME/tools/bin"
export PATH="$PATH:$ANDROID_HOME/tools"
To test the features of AppDynamics Android agent, you will need also to (hence have MRUM license). If you do not have one, please contact our sales
Please create an MRUM application on your AppDynamics Controller. You shall get the App Key and Collector URL from this process. If you would like to test additionally crash reports, this will require publishing pro-guard/dex file mappings. To upload those files, you will need to provide additionally your account name (sample: AppDynamics-abcdefghXXXXXXXX) and your EUM license's key (sample: abcdef12-3456-7890-abcd-17f7fcecd4f0).
For security reason, we keep above values inside secrets.xml and appdynamics.properties files. This is only to prevent those details to be visible on GitHub. Resource files are more vulnerable to decompilation of your application, hence discoverable. If you would like to keep those values hidden from your end-users refer to this SO answer for a detailed breakdown of the obfuscation options.
Please create a file appdynamics.properties inside your project's root folder (alongside settings.gradle).
EUM_ACCOUNT_NAME="AppDynamics-abcdefghXXXXXXXX"
EUM_LICENSE_KEY="abcdef12-3456-7890-abcd-17f7fcecd4f0"Please create a file secrets.xml in app/src/main/res/values/ as explained by CodePath
secrets.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="APP_KEY">YOUR_APP_KEY</string>
<string name="COLLECTOR_URL">YOUR_COLLECTOR_URL</string>
</resources>You can run this project directly, from Android Studio or cloning the repo and opening it with Android Studio application.
- Clone the project from gitbub
- Open project in Android studio
- Replace values in secrets.xml
- Build application on emulator or physical device
For more examples, please refer to the AppDynamics Documentation_
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the GNU GPLv3 License. See LICENSE for more information.
Feel free to reach out to AppDynamics Support Project Link: https:/Appdynamics/Sample-Android-Application