appium-espresso-driver 4.0.1 → 4.0.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [4.0.2](https://github.com/appium/appium-espresso-driver/compare/v4.0.1...v4.0.2) (2025-02-14)
+
+### Miscellaneous Chores
+
+* Describe how to precompile the server into the AUT ([#1043](https://github.com/appium/appium-espresso-driver/issues/1043)) ([1a92717](https://github.com/appium/appium-espresso-driver/commit/1a92717510c5016bd1b795421805a47b54118a30))
+
 ## [4.0.1](https://github.com/appium/appium-espresso-driver/compare/v4.0.0...v4.0.1) (2025-02-14)
 
 ### Miscellaneous Chores

package/README.md

@@ -37,6 +37,17 @@ On top of standard Appium requirements Espresso driver also expects the followin
 - Both the server package and the application under test must be signed with the same digital signature. Appium does sign them automatically upon session creation, so this could only be an issue if one wants to test an application, which is already installed on the device (using `noReset=true` capability).
 - The package under test must not have mangled class names (e.g. [Proguard](https://developer.android.com/studio/build/shrink-code) must not be enabled for it)
 
+
+## Consuming Espresso Server as Library
+
+If you have access to the source code of the application under test then it is
+possible to integrate Espresso server into your application and make it to a library.
+This approach allows to simplify the dependency conflicts resolution
+as well as to optimize the session startup performance.
+Read the corresponding [article](./docs/as-library.md) from the driver
+documentation for more details.
+
+
 ### Doctor
 
 Since driver version 2.31.0 you can automate the validation for the most of the above
@@ -1773,14 +1784,14 @@ Appium allows to do this on per-process (multiple server processes running on di
 or per-request basis (single server process managing multiple sessions, more preferable, uses less resources and ensures better control over running sessions). Check [Parallel Android Tests](docs/parallel-tests.md) article for
 more details.
 
-> **Note**
+> [!NOTE]
 > If you are _not_ going to run your tests in parallel then consider enabling the `--session-override` Appium server argument. It forces the server to close all pending sessions before a new one could be opened,
 > which allows you to avoid possible issues with such sessions silently running/expiring in the background.
 
-
 ## Troubleshooting
 
-* If you observe Espresso server crash on startup and various exceptions about missing class/method in the logcat output then consider updating [appium:espressoBuildConfig](#espresso-build-config) capability with module versions that match your application under test. This might require some experimentation, as different apps have different module requirements. Check, for example, [issue #812](https://github.com/appium/appium-espresso-driver/issues/812)
+* If you observe Espresso server crash on startup and various exceptions about missing class/method in the logcat output then consider updating [appium:espressoBuildConfig](#espresso-build-config) capability with module versions that match your application under test. This might require some experimentation, as different apps have different module requirements. Check, for example, [issue #812](https://github.com/appium/appium-espresso-driver/issues/812). Another solution might be
+to [integrate](#consuming-espresso-server-as-library) Espresso Server with the application under test in form of a library.
 * If you experince issues with application activities being not found or not starting then consider checking [How To Troubleshoot Activities Startup](docs/activity-startup.md) article.
 * Espresso requires the debug APK and app-under-test APK (AUT) to have the same signature. It automatically signs the AUT with the `io.appium.espressoserver.test` signature. This may be problematic if you're using an outdated Android SDK tools and/or an outdated Java version.
 * If there are problems starting a session, set the capability `forceEspressoRebuild` to `true` and retry. This will force rebuilding of Espresso Server. If the following session startup is successfull, set it back to `false`, so the session startup performance is back to normal.

package/espresso-server/library/src/main/java/io/appium/espressoserver/lib/helpers/Version.kt

@@ -2,6 +2,6 @@ package io.appium.espressoserver.lib.helpers
 
 // This value is updated automatically by the NPM versioning script
 // It should be in sync with the NPM module version from package.json
-private const val VERSION = "4.0.1"
+private const val VERSION = "4.0.2"
 
 fun getEspressoServerVersion() = VERSION

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-espresso-driver",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-espresso-driver",
-      "version": "4.0.1",
+      "version": "4.0.2",
       "license": "Apache-2.0",
       "dependencies": {
         "appium-adb": "^12.12.0",

package/package.json

@@ -7,7 +7,7 @@
     "automated testing",
     "android"
   ],
-  "version": "4.0.1",
+  "version": "4.0.2",
   "author": "Appium Contributors",
   "license": "Apache-2.0",
   "repository": {