studio
latest
false
- Getting Started
- Setup and Configuration
- Automation Projects
- Dependencies
- Types of Workflows
- Control Flow
- File Comparison
- Automation Best Practices
- Source Control Integration
- Debugging
- Logging
- The Diagnostic Tool
- Workflow Analyzer
- About Workflow Analyzer
- ST-NMG-001 - Variables Naming Convention
- ST-NMG-002 - Arguments Naming Convention
- ST-NMG-004 - Display Name Duplication
- ST-NMG-005 - Variable Overrides Variable
- ST-NMG-006 - Variable Overrides Argument
- ST-NMG-008 - Variable Length Exceeded
- ST-NMG-009 - Prefix Datatable Variables
- ST-NMG-011 - Prefix Datatable Arguments
- ST-NMG-012 - Argument Default Values
- ST-NMG-016 - Argument Length Exceeded
- ST-NMG-017 - Class name matches default namespace
- ST-DBP-002 - High Arguments Count
- ST-DBP-003 - Empty Catch Block
- ST-DBP-007 - Multiple Flowchart Layers
- ST-DPB-010 - Multiple instances of [Workflow] or [Test Case]
- ST-DBP-020 - Undefined Output Properties
- ST-DBP-021 - Hardcoded Timeout
- ST-DBP-023 - Empty Workflow
- ST-DBP-024 - Persistence Activity Check
- ST-DBP-025 - Variables Serialization Prerequisite
- ST-DBP-026 - Delay Activity Usage
- ST-DBP-027 - Persistence Best Practice
- ST-DBP-028 - Arguments Serialization Prerequisite
- ST-USG-005 - Hardcoded Activity Arguments
- ST-USG-009 - Unused Variables
- ST-USG-010 - Unused Dependencies
- ST-USG-014 - Package Restrictions
- ST-USG-017 - Invalid parameter modifier
- ST-USG-020 - Minimum Log Messages
- ST-USG-024 - Unused Saved for Later
- ST-USG-025 - Saved Value Misuse
- ST-USG-026 - Activity Restrictions
- ST-USG-027 - Required Packages
- ST-USG-028 - Restrict Invoke File Templates
- ST-USG-032 - Required Tags
- ST-USG-034 - Automation Hub URL
- Variables
- Arguments
- Imported Namespaces
- Coded automations
- Introduction
- Registering custom services
- Before and After contexts
- Generating code
- Generating coded test case from manual test cases
- Trigger-based Attended Automation
- Recording
- UI Elements
- Selectors
- Object Repository
- Data Scraping
- Image and Text Automation
- Citrix Technologies Automation
- RDP Automation
- VMware Horizon Automation
- Salesforce Automation
- SAP Automation
- macOS UI Automation
- The ScreenScrapeJavaSupport Tool
- The WebDriver Protocol
- Extensions
- About extensions
- SetupExtensions tool
- UiPathRemoteRuntime.exe is not running in the remote session
- UiPath Remote Runtime blocks Citrix session from being closed
- UiPath Remote Runtime causes memory leak
- UiPath.UIAutomation.Activities package and UiPath Remote Runtime versions mismatch
- The required UiPath extension is not installed on the remote machine
- Screen resolution settings
- Group Policies
- Cannot communicate with the browser
- Chrome extension is removed automatically
- The extension may have been corrupted
- Check if the extension for Chrome is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and Incognito mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- List of extensions for Chrome
- Chrome Extension on Mac
- Group Policies
- Cannot communicate with the browser
- Edge extension is removed automatically
- The extension may have been corrupted
- Check if the Extension for Microsoft Edge is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and InPrivate mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- List of extensions for Edge
- Extension for Safari
- Installing the extension on macOS
- Troubleshooting
- Extension for VMware Horizon
- Extension for Amazon WorkSpaces
- SAP Solution Manager plugin
- Excel Add-in
- Test Suite - Studio
- Troubleshooting
Installing the extension on macOS
Studio User Guide
Last updated Dec 17, 2024
Installing the extension on macOS
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.
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 started
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
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
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
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, 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
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