@dynatrace/cordova-plugin 2.295.1 → 2.297.1

package/README.md

@@ -31,8 +31,8 @@ For information as to why this is necessary, read more [here](#migration-from-ma
 
 This agent versions are configured in this plugin:
 
-* Android Agent: 8.295.1.1006
-* iOS Agent: 8.295.1.1020
+* Android Agent: 8.297.1.1003
+* iOS Agent: 8.297.1.1004
 
 ## Quick Setup
 
@@ -49,6 +49,7 @@ This agent versions are configured in this plugin:
     * [Debug property](#debug-property)
     * [Content Security Policy url](#content-security-policy-url)
     * [Cookie Proxy](#cookie-proxy)
+    * [Capacitor Cookie Proxy](#capacitor-cookie-proxy)
     * [JS Agent Path](#js-agent-path)
     * [Gradle Path](#gradle-path)
     * [Plist Path](#plist-path)
@@ -81,6 +82,7 @@ This agent versions are configured in this plugin:
     * [iOS](#ios)
 * [Official documentation](#official-documentation)
 * [Doctor Dynatrace](#doctor-dynatrace)
+* [Instrumentation Overhead](#instrumentation-overhead)
 * [Troubleshooting and current restrictions](#troubleshooting-and-current-restrictions)
     * [iOS Session Correlation issues](#ios-session-correlation-issues)
 * [Changelog](#changelog)
@@ -200,7 +202,7 @@ There is flag for updating the CSP (Content Security Policy). By default this va
 
 ### Cookie Proxy
 
-Issues with cookies are somehow a persistent companion in Ionic or Capacitor applications. Therefor we provide a proxy script which is wrapping the document.cookie API and are storing the cookies which are important for the Dynatrace Agents in the session storage. Of course this wrapping is still calling the original API.
+Issues with cookies are somehow a persistent companion in Ionic or Capacitor applications. Therefor we provide a proxy script which is wrapping the document.cookie API and are storing the cookies which are important for the Dynatrace Agents in the session storage. Of course this wrapping is still calling the original API. Please see the [Capacitor Cookie Proxy](#capacitor-cookie-proxy) section below if you are using `CapacitorCookies` in your application. If not, please see the configuration below.
 
 Per default the cookie proxy is turned off. To make use of this proxy you need to enable it in the cordova configuration in the dynatrace.config.js:
 
@@ -215,6 +217,24 @@ module.exports = {
 
 The `true` in the cookieProxy property will insert a `dt-cookie-proxy.js` script in the index.html.
 
+### Capacitor Cookie Proxy
+
+If you are using `CapacitorCookies` in your capacitor application, we have added another proxy option that includes the logic used with `CapacitorCookies`. To use this option, you will need to set `CapacitorCookies` to false in your capacitor configuration and then add the following option in your `dynatrace.config.js` file:
+
+```js
+module.exports = {
+  cordova : {
+      capacitorCookieProxy: true
+    },
+  ...
+}
+```
+
+If you are not using `CapacitorCookies` in your application, please be sure to follow the steps in the [Cookie Proxy](#cookie-proxy) section instead. 
+
+**NOTE:** 
+If `CapacitorCookies` is set to true, we will not inject our proxy as there have been issues when using both `CapacitorCookies` and our proxy at the same time. Also, if you have both `cookieProxy` and `capacitorCookieProxy` set to true while `CapacitorCookies` is set to false, we will add the capacitor cookie proxy.
+
 ### JS Agent Path
 
 If you want to use a local script/text file that includes the JS Agent snippet downloaded from the WebUI or retrieved from using the Dynatrace API. Note that you can name the file whatever you want but the file and directory that you use needs to exist. The file downloaded from the WebUI will be named `jsSnippet.txt` by default.
@@ -824,6 +844,19 @@ The results will be generated in the terminal window as well as stored in log fo
 
 The log file will also include a list of your `package.json` *dependencies* and *devDependencies* which will be helpful when investigating possible issues that arise. Please add this doctor dynatrace log and [mobile agent debug logs](#native-oneagent-debug-logs) when opening a support ticket.
 
+## Instrumentation Overhead
+
+When using auto-instrumenation through our plugin, here are some examples of the size differences before and after instrumentation for release builds:
+
+| Built with           | App template            | Version     | Size Before     | Size After     | Difference     |
+|----------------------|-------------------------|-------------|-----------------|----------------|----------------|
+| Cordova - Android    | cordova-app-hello-world | 13.0.0      | 2.4 MB          | 2.6 MB         | 0.2 MB         |
+| Cordova - iOS        | cordova-app-hello-world | 7.1.0       | 749 KB          | 9.1 MB         | 8.35 MB        |
+| Ionic - Android      | Tabs                    | 13.0.0      | 3.4 MB          | 3.5 MB         | 0.1 MB         |
+| Ionic - iOS          | Tabs                    | 7.1.0       | 3.8 MB          | 12.2 MB        | 8.4 MB         |
+| Capacitor - Android  | ionic-conference-app    | 4.6.3       | 16.2 MB         | 16.3 MB        | 0.1 MB         |
+| Capacitor - iOS      | ionic-conference-app    | 4.6.3       | 33.2 MB         | 37.4 MB        | 4.2 MB         |
+
 ## Troubleshooting and current restrictions
 **Note:**
 The Dynatrace Android Gradle plugin is hosted on [Maven Central](https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.dynatrace.tools.android%22%20AND%20a%3A%22gradle-plugin%22). JCenter has noted it's [sunset](https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-chartcenter/) on May 1st so Maven Central is the primary source of the Dynatrace Android Gradle plugin.
@@ -855,6 +888,11 @@ When using Apple Pay with WKWebView, there are specific checks that WebKit (Appl
 
 ## Changelog
 
+2.297.1
+* Updated Android (8.297.1.1003) & iOS Agent (8.297.1.1004)
+* Added [Instrumentation Overhead](#instrumentation-overhead) section
+* Added [Capacitor Cookie Proxy](#capacitor-cookie-proxy) option for when `CapacitorCookies` is needed
+
 2.295.1
 * Updated Android (8.295.1.1006) & iOS Agent (8.295.1.1020)
 * Using cookie postfix of JavaScript agent when enabled

package/files/iOS/Dynatrace.xcframework/Info.plist

@@ -8,7 +8,7 @@
 			<key>BinaryPath</key>
 			<string>Dynatrace.framework/Dynatrace</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>tvos-arm64</string>
 			<key>LibraryPath</key>
 			<string>Dynatrace.framework</string>
 			<key>SupportedArchitectures</key>
@@ -16,13 +16,13 @@
 				<string>arm64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>ios</string>
+			<string>tvos</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>Dynatrace.framework/Dynatrace</string>
 			<key>LibraryIdentifier</key>
-			<string>tvos-arm64_x86_64-simulator</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>Dynatrace.framework</string>
 			<key>SupportedArchitectures</key>
@@ -31,7 +31,7 @@
 				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>tvos</string>
+			<string>ios</string>
 			<key>SupportedPlatformVariant</key>
 			<string>simulator</string>
 		</dict>
@@ -39,7 +39,7 @@
 			<key>BinaryPath</key>
 			<string>Dynatrace.framework/Dynatrace</string>
 			<key>LibraryIdentifier</key>
-			<string>tvos-arm64</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>Dynatrace.framework</string>
 			<key>SupportedArchitectures</key>
@@ -47,13 +47,13 @@
 				<string>arm64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>tvos</string>
+			<string>ios</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>Dynatrace.framework/Dynatrace</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>tvos-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>Dynatrace.framework</string>
 			<key>SupportedArchitectures</key>
@@ -62,7 +62,7 @@
 				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>ios</string>
+			<string>tvos</string>
 			<key>SupportedPlatformVariant</key>
 			<string>simulator</string>
 		</dict>