studio
2024.10
true
Studio User Guide
Last updated Nov 4, 2024

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/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 startedLoading 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

Using environment variables

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.jarexport 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 startedLoading 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 started2024-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
  • Installing the extension in a custom folder
  • Using command-line parameters
  • Using environment variables
  • For native macOS applications

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.