Installing the extension on macOS

Installing the extension in a custom folder

There are several methods for loading the Java extension from a custom directory on macOS, similar to the process on a Windows environment.

While these examples are based on a Java application named JavaDisabledElements launched from a .jar file, they are applicable to other applications as well.

Using command-line parameters

This method is applicable across all versions of Java, including Java 9 or greater:

/Library/Java/JavaVirtualMachines/jdk-1.8.jdk/Contents/Home/bin/java -cp /Users/example/Documents/UiPath/Driver/MacOS/Output/JavaSupport/UiPathBridge.jar:/Users/example/Documents/UiPath/Driver/MacOS/Output/JavaSupport/UiPathV8.jar:/Users/example/Documents/UiPath/Driver/Qa/UiPath.Driver.Tests/open/TestApps/JavaDisabledElementsApp/JavaDisabledElements.jar -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge JavaDisabledElements

Expected output:

Loading UiPathBridgeInterface Dll
Java resources directory: /Users/example/Documents/UiPath/Driver/MacOS/Output/JavaSupport
tryLoadFromPredefinedPaths
UiPathJavaBridge Interface DLL loaded from: /Users/example/Documents/UiPath/Driver/MacOS/Output/UiPathJavaBridgeV8.dylib
Java Version: 1.8.0_401
UiPath Access Bridge started

Uso de variáveis de ambiente

If the Java runtime supports the extension loading mechanism, you can use environment variables. Here is an example:

export JAVA_TOOL_OPTIONS=-Djava.ext.dirs=/Users/example/Documents/UiPath/Driver/MacOS/Output/JavaSupport -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge

/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin/java -jar /Users/example/Documents/UiPath/Driver/Qa/UiPath.Driver.Tests/open/TestApps/JavaDisabledElementsApp/JavaDisabledElements.jar

Expected output:

Loading UiPathBridgeInterface Dll
Java resources directory: /Users/example/Documents/UiPath/Driver/MacOS/Output/JavaSupport
tryLoadFromPredefinedPaths
UiPathJavaBridge Interface DLL loaded from: /Users/example/Documents/UiPath/Driver/MacOS/Output/UiPathJavaBridgeV8.dylib
Java Version: 1.8.0_401
UiPath Access Bridge started

For native macOS applications

For native macOS applications, parameters can be added by editing the Info.plist file. This can be done only where applicable.

Here is an example where we used an application called SAPGUI for Java and extension files from a Driver Portable build for macOS:

Expected output:

2024-09-11 11:20:34.924 SAPGUI[31468:4852735] Task succeeded.
Loading UiPathBridgeInterface Dll
Java resources directory: /Users/example/.nuget/packages/uipath.driver.portable/24.11.9014.23827-dev/tools/JavaSupport
tryLoadFromPredefinedPaths
Tools path is: /Users/example/.nuget/packages/uipath.driver.portable/24.11.9014.23827-dev/tools
Package path is: /Users/example/.nuget/packages/uipath.driver.portable/24.11.9014.23827-dev
UiPathJavaBridge Interface DLL loaded from: /Users/example/.nuget/packages/uipath.driver.portable/24.11.9014.23827-dev/native/osx-arm64/UiPathJavaBridgeV8.dylib
Java Version: 17.0.11
UiPath Access Bridge started