For Python developers using Visual Studio Code, Clicknium extension provides features to create Python automation project, capture/edit/validate and recapture UI element locators for browsers and various types of desktop applications, run/debug the automation project, package the project as standalone executable file, and central locator store management on the cloud.
Besides, Clicknium also improves writing code experience, such as Code IntelliSense, error hint, etc.
Installation: Install Clicknium extension through Visual Studio Code marketplace or search
clicknium in Visual Studio Code Extension marketplace.
Remarks: Clicknium extension has dependency on Python extension, and the extension will be installed automatically.
You are required to sign up to Clicknium after installation, or sign in with a Google or GitHub account. Please go to Connect to Cloud for more information.
Clicknium extension provides different extensions for automation. For example, Edge Extension helps you execute automation on Microsoft Edge browser. You can select and install extensions before writing automation code. For more information, please ref to Automation Extensions
Open the Command Palette:
- Input or select:
Clicknium: Create Project
- Select project path
- You can create one empty folder and select it, and the new project will be created.
- You can also select one existing folder which will be converted to Clicknium project, and there is no impact on existing source files. You can go to Project Management for more information.
In Visual Studio Code, press
CTRL+F10 to invoke Clicknium recorder to capture UI element locators.
The Capture Technology indicates which automation technology is currently used to capture UI elements. Default is Auto Detect, which means Clicknium recorder will automatically detect the application type and choose the automation technology accordingly for locators capturing. You can go to Clicknium Recorder for more information.
After capturing the locators, you can open and edit the locator in the editor as below.
After editing the locator, you can press the button
Validate to minimize Visual Studio Code and verify if the target element can be located by the locator. The locator validation result is displayed at the head of each locator layer.
Clicknium provides plenty of features to help you write automation code more efficiently. For example:
- Auto Code Complete
For the locator parameter in
cc.find_element(, you can press
Ctrl+F10to invoke Clicknium Recorder to capture a UI element. Once you complete the capturing, the captured element will be automatically filled to code like
cc.find_element(locator.chrome.bing.search_sb_form_q)in Visual Studio Code.
If you want to choose one locator in the locator store, Clicknium code extension shows the locator store list and the locator list for you to choose.
Please go to Code IntelliSense for more features.
There are two ways to debug Clicknium Automation Project:
- Run/Debug using
Ctrl+F5, which is the same way as you debug other Python scripts.
- Open the Command Palette:
Ctrl+Shift+P, input or select:
Clicknium: Runto run project or
Clicknium: Debugto debug project.
It will configure the running/debugging environment. For example, check the Python version in clicknium.yaml, restore dependent package list, etc.
When a project is developed, you can distribute the package to the non-developer end users. Clicknium provides features to package the project as one executable file, so the end user can run automation tasks by double clicking it.
Open the Command Palette:
Ctrl+Shift+P, Input or select:
Clicknium: Package to package project.
For more details, please refer to Project Package.