Clicknium

Clicknium是一个Python界面自动化库，可以非常简单直观地使用它操作浏览器和Windows平台APP。官网：https://www.clicknium.comGithub: https://github.com/clicknium/clicknium-docsVS Code插件：Clicknium extension

为什么要做Clicknium

Python有很多自动化的库，比如Selenium，Pyautogu，Playwright。有的只能操作网页，有的只能操作App，并且使用起来都算不上简单：Selenium需要安装Driver，需要学习XPath；Pyautogui使用简单，代码可读性强，完全模拟鼠标单击，双击拖动；但是它采用xy轴的方式定位桌面元素。分辨率变化，位置变化都会影响运行。要想用好这些工具，学习成本实在不低。但是大多数人的自动化需求其实非常简单。花大量的时间和精力学习自动化技术，可能还不如自己手动点点鼠标键盘, 本末倒置。好的自动化工具，需要易学易用才能帮助更多的人。

有多简单

Clicknium提供了简洁直观的API来操作UI元素，如set_text, get_text, click 等等。查看代码时，逻辑非常清晰，贴近自然语言和实际操作。那怎么解决元素定位的问题。我们为此设计了Clicknium Recorder。打开Recorder，Clicknium会自动识别鼠标所指的元素。 按住Ctrl+鼠标单击，Recorder会自动抓取元素，生成Locator。直接使用 Locator就能直接获取UI元素并对其进行操作： Clicknium 还提供了智能提示和代码补全的功能：

Locator的使用：

当鼠标悬停在代码上时，会自动展示locator对应的UI元素快照，可以直接Open, Validate, Recapture。

在Locator store中，可以配置locator的参数，验证locator的有效性，重新capture，甚至支持实时Action来操作locator对应的UI元素，测试locator的功能。

如何尝试

环境：

• Windows 7+
• Python 3.7+
• VS Code

  配置 Clicknium

  在VS Code Extension市场中搜索并安装Clicknium，据欢迎页面的步骤完成配置:

建议第一次使用：

先运行 Welcome 页面中的Sample了解自动化运行的效果。跟着教材花3分钟完成第一个自动化程序：First Automation Project

交流

目前项目仍在早期阶段。后期我们会根据需求将项目拓展到全平台。有任何问题或者意见欢迎交流, 比如需要PyCharm 插件？需要某个App或者网站的稳定locator？