Class DebugOptions

java.lang.Object
com.dynatrace.tools.android.dsl.DebugOptions
All Implemented Interfaces:
com.dynatrace.tools.android.api.DebugOptions, Serializable

public class DebugOptions extends Object implements Serializable, com.dynatrace.tools.android.api.DebugOptions
DSL object for additional configuration properties that should only be used in special cases like troubleshooting.

For example, the support team may instruct you to activate agent debug logging by enabling the property agentLogging.

See Also:
  • Constructor Details

    • DebugOptions

      public DebugOptions()
      Creates new DebugOptions.
  • Method Details

    • certificateValidation

      @Deprecated public void certificateValidation(boolean certificateValidation)
      Deprecated.
      As of version 8.257, instead add your self-signed certificate to the Network Security Configuration.
      Specifies if the certificate validation of the agent should be activated.

      WARNING: If the certificate validation is deactivated, the agent will not verify the server certificate and therefore the agent communication is vulnerable to malicious attacks. Hostname verification can't be deactivated with this option

      Do not deactivate certificate validation in production.

      The default value is true.
      Parameters:
      certificateValidation - true, if the certificate validation of the agent should be activated
      See Also:
    • agentLogging

      public void agentLogging(boolean agentLogging)
      Specifies if the debug logging of the agent should be activated.

      WARNING: Do NOT activate debug logging for your production apps. Logging will decrease the agent performance and can write sensitive information into the device logs. This option should only be used to troubleshoot agent problems.

      The default value is false.

      Parameters:
      agentLogging - true, if the debug logging of the agent should be activated
    • byteCodeVerification

      @Deprecated public void byteCodeVerification(boolean byteCodeVerification)
      Deprecated.
      feature was removed in version 8.245
      Specifies if simple byte-code verification should be performed after the class was instrumented

      Note: The verification can also show False Positives. For example, the verification will fail if the byte-code contains unusual characters in the class name.

      The default value is false.

      Parameters:
      byteCodeVerification - true, if simple byte-code verification should be performed
    • failOnWarnings

      @Deprecated public void failOnWarnings(boolean failOnWarnings)
      Deprecated.
      feature was removed in version 8.249
      Specifies if the build should fail when a warning occurs

      The default value is false.

      Parameters:
      failOnWarnings - true, if the build should fail when a warning occurs
    • isCertificateValidation

      @Deprecated public boolean isCertificateValidation()
      Deprecated.
      As of version 8.257, instead add your self-signed certificate to the Network Security Configuration.
      Specifies if the certificate validation of the agent should be activated.

      WARNING: If the certificate validation is deactivated, the agent will not verify the server certificate and therefore the agent communication is vulnerable to malicious attacks. Hostname verification can't be deactivated with this option

      Do not deactivate certificate validation in production.

      The default value is true.
      Specified by:
      isCertificateValidation in interface com.dynatrace.tools.android.api.DebugOptions
      Returns:
      true, if the certificate validation of the agent should be activated
      See Also:
    • isAgentLogging

      public boolean isAgentLogging()
      Specifies if the debug logging of the agent should be activated.

      WARNING: Do NOT activate debug logging for your production apps. Logging will decrease the agent performance and can write sensitive information into the device logs. This option should only be used to troubleshoot agent problems.

      The default value is false.

      Specified by:
      isAgentLogging in interface com.dynatrace.tools.android.api.DebugOptions
      Returns:
      true, if the debug logging of the agent should be activated
    • isByteCodeVerification

      @Deprecated public boolean isByteCodeVerification()
      Deprecated.
      feature was removed in version 8.245
      Specifies if simple byte-code verification should be performed after the class was instrumented

      Note: The verification can also show False Positives. For example, the verification will fail if the byte-code contains unusual characters in the class name.

      The default value is false.

      Specified by:
      isByteCodeVerification in interface com.dynatrace.tools.android.api.DebugOptions
      Returns:
      true, if a simple byte-code verification should be performed
    • isFailOnWarnings

      @Deprecated public boolean isFailOnWarnings()
      Deprecated.
      Specifies if the build should fail when a warning occurs

      The default value is false.

      Specified by:
      isFailOnWarnings in interface com.dynatrace.tools.android.api.DebugOptions
      Returns:
      true, if the build should fail when a warning occurs
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • equals

      public boolean equals(Object other)
      Overrides:
      equals in class Object
    • toString

      public String toString()
      Overrides:
      toString in class Object