robotframework-appiumwindows 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,48 +1,48 @@
1
- from robot.utils import ConnectionCache
2
-
3
-
4
- class ApplicationCache(ConnectionCache):
5
-
6
- def __init__(self):
7
- ConnectionCache.__init__(self, no_current_msg='No current application')
8
- self._closed = set()
9
-
10
- @property
11
- def applications(self):
12
- return self._connections
13
-
14
- def get_open_browsers(self):
15
- open_applications = []
16
- for application in self._connections:
17
- if application not in self._closed:
18
- open_applications.append(application)
19
- return open_applications
20
-
21
- def close(self, ignore_fail=False, quit_app=True):
22
- if self.current:
23
- application = self.current
24
- try:
25
- if quit_app:
26
- application.quit()
27
- else:
28
- application.close()
29
- except Exception as err:
30
- if not ignore_fail:
31
- raise err
32
- self.current = self._no_current
33
- self.current_index = None
34
- self._closed.add(application)
35
-
36
- def close_all(self, ignore_fail=True, quit_app=True):
37
- for application in self._connections:
38
- if application not in self._closed:
39
- try:
40
- if quit_app:
41
- application.quit()
42
- else:
43
- application.close()
44
- except Exception as err:
45
- if not ignore_fail:
46
- raise err
47
- self.empty_cache()
48
- return self.current
1
+ from robot.utils import ConnectionCache
2
+
3
+
4
+ class ApplicationCache(ConnectionCache):
5
+
6
+ def __init__(self):
7
+ ConnectionCache.__init__(self, no_current_msg='No current application')
8
+ self._closed = set()
9
+
10
+ @property
11
+ def applications(self):
12
+ return self._connections
13
+
14
+ def get_open_browsers(self):
15
+ open_applications = []
16
+ for application in self._connections:
17
+ if application not in self._closed:
18
+ open_applications.append(application)
19
+ return open_applications
20
+
21
+ def close(self, ignore_fail=False, quit_app=True):
22
+ if self.current:
23
+ application = self.current
24
+ try:
25
+ if quit_app:
26
+ application.quit()
27
+ else:
28
+ application.close()
29
+ except Exception as err:
30
+ if not ignore_fail:
31
+ raise err
32
+ self.current = self._no_current
33
+ self.current_index = None
34
+ self._closed.add(application)
35
+
36
+ def close_all(self, ignore_fail=True, quit_app=True):
37
+ for application in self._connections:
38
+ if application not in self._closed:
39
+ try:
40
+ if quit_app:
41
+ application.quit()
42
+ else:
43
+ application.close()
44
+ except Exception as err:
45
+ if not ignore_fail:
46
+ raise err
47
+ self.empty_cache()
48
+ return self.current
AppiumLibrary/version.py CHANGED
@@ -1,2 +1,2 @@
1
- # -*- coding: utf-8 -*-
2
- VERSION = '3.0-beta'
1
+ # -*- coding: utf-8 -*-
2
+ VERSION = '0.1.1'
@@ -0,0 +1,214 @@
1
+ Metadata-Version: 2.4
2
+ Name: robotframework-appiumwindows
3
+ Version: 0.1.2
4
+ Summary: Robot Framework AppiumLibrary extension for Windows desktop automation using NovaWindows2 Driver instead of WinAppDriver.
5
+ Author-email: Huy Nguyen <nguyenvanhuy0612@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/nguyenvanhuy0612/robotframework-appiumwindows
8
+ Project-URL: Repository, https://github.com/nguyenvanhuy0612/robotframework-appiumwindows
9
+ Project-URL: Issues, https://github.com/nguyenvanhuy0612/robotframework-appiumwindows/issues
10
+ Classifier: Development Status :: 3 - Alpha
11
+ Classifier: Framework :: Robot Framework
12
+ Classifier: Framework :: Robot Framework :: Library
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Operating System :: Microsoft :: Windows
18
+ Classifier: License :: OSI Approved :: MIT License
19
+ Classifier: Intended Audience :: Developers
20
+ Classifier: Topic :: Software Development :: Testing
21
+ Classifier: Topic :: Software Development :: Quality Assurance
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Requires-Python: >=3.10
24
+ Description-Content-Type: text/markdown
25
+ License-File: LICENSE
26
+ Requires-Dist: robotframework>=7.3.2
27
+ Requires-Dist: Appium-Python-Client>=5.1.1
28
+ Dynamic: license-file
29
+
30
+ # Robot Framework AppiumLibrary for Windows
31
+
32
+ This library extends the standard [AppiumLibrary](https://github.com/serhatbolsu/robotframework-appiumlibrary) to support **Windows Desktop Automation** using the **Appium NovaWindows2 Driver**. It bridges the gap between Robot Framework and the modern Windows automation ecosystem, providing robust tools for interacting with Windows applications via PowerShell integration and native Windows APIs.
33
+
34
+ ---
35
+
36
+ ## 🚀 Key Features
37
+
38
+ * **Native Windows Interaction**: Seamless simulation of mouse events including Right Click, Double Click, Hover, and Drag & Drop.
39
+ * **PowerShell Integration**: distinct capability to execute PowerShell commands and scripts directly on the target machine, allowing for advanced system manipulation and state checking.
40
+ * **Resilient Automation**: Includes fallback mechanisms for clicking and typing when standard driver commands are intercepted or fail.
41
+ * **Advanced File Transfer**: Bypass standard Appium limitations with specialized keywords to push/pull files and folders, including handling large files via chunked transfer.
42
+ * **Remote Desktop Ready**: Optimized for running in headless or remote desktop environments where standard interaction methods might struggle.
43
+
44
+ ---
45
+
46
+ ## 🔧 Underlying Driver
47
+
48
+ This library is a Robot Framework wrapper specifically validated for the **[Appium NovaWindows2 Driver](https://github.com/nguyenvanhuy0612/appium-novawindows2-driver)**.
49
+
50
+ * **Repository**: [nguyenvanhuy0612/appium-novawindows2-driver](https://github.com/nguyenvanhuy0612/appium-novawindows2-driver)
51
+ * **Purpose**: Replaces the legacy WinAppDriver with a modern, PowerShell-backed engine.
52
+ * **Mechanism**: Translates Appium commands into optimized PowerShell scripts, executing them directly on the Windows target. This approach allows for:
53
+ * Bypassing UI Automation limitations.
54
+ * Direct system control (registry, processes, files).
55
+ * Zero-dependency setup on the target (no "Developer Mode" required).
56
+
57
+ ---
58
+
59
+ ## 🏗️ Architecture
60
+
61
+ ```text
62
+ +------------------------------+ +----------------------------------+
63
+ | Test Runner (Local PC) | | Target Machine (Windows) |
64
+ |------------------------------| |----------------------------------|
65
+ | | | |
66
+ | [ Robot Framework ] | | [ Appium Server 3.x+ ] |
67
+ | | | HTTP | ^ |
68
+ | [ AppiumLibrary ] | JSON | | |
69
+ | | | Wire | [ Appium NovaWindows2 Driver ] |
70
+ | [ robotframework- | ----------> | | |
71
+ | appiumwindows ] | | [ PowerShell Session ] |
72
+ | | | | |
73
+ | | | [ Application ] |
74
+ | | | |
75
+ +------------------------------+ +----------------------------------+
76
+ ```
77
+
78
+ ---
79
+
80
+ ## 📋 Prerequisites
81
+
82
+ ### 1. On Test Runner (Local Machine)
83
+ * **Python**: 3.10 or higher
84
+ * **Robot Framework**: Installed via pip
85
+
86
+ ### 2. On Target Machine (Remote Windows PC)
87
+ * **Node.js**: [Download](https://nodejs.org/en/download)
88
+ * **Appium Server**: Global installation (`npm install -g appium`)
89
+ * **NovaWindows2 Driver**: `appium driver install --source=npm appium-novawindows2-driver`
90
+ * **PowerShell**: Accessible and allowed by the Appium server context.
91
+
92
+ ---
93
+
94
+ ## 📦 Installation
95
+
96
+ To install the library on your test runner:
97
+
98
+ ```bash
99
+ pip install robotframework-appiumwindows
100
+ ```
101
+
102
+ ---
103
+
104
+ ## ⚙️ Configuration & Startup
105
+
106
+ On the **Target Machine**, start the Appium server with relaxed security to enable PowerShell execution:
107
+
108
+ ```bash
109
+ appium --relaxed-security
110
+ ```
111
+
112
+ *Note: `--relaxed-security` is required for the library to execute PowerShell commands, which powers many of the advanced features.*
113
+
114
+ ---
115
+
116
+ ## 💻 Example Test
117
+
118
+ Here is a comprehensive example demonstrating connection, application launching, efficient file transfer, and advanced user interactions.
119
+
120
+ ```robot
121
+ *** Settings ***
122
+ Library AppiumLibrary
123
+
124
+ Test Setup Open Windows App
125
+ Test Teardown Close All Applications
126
+
127
+ *** Variables ***
128
+ ${REMOTE_URL} http://192.168.1.10:4723
129
+ ${APP_PATH} C:\\Windows\\System32\\notepad.exe
130
+
131
+ *** Test Cases ***
132
+ Automate Notepad With Advanced Features
133
+ [Documentation] Demonstrates launching an app, typing, using right-click context menu, and verifying via PowerShell.
134
+
135
+ # 1. Launch Application using PowerShell (more reliable for some Win apps)
136
+ Appium Execute Powershell Command Start-Process "${APP_PATH}"
137
+
138
+ # 2. Attach to the "Root" session allows finding top-level windows
139
+ Open Application ${REMOTE_URL} platformName=Windows appium:automationName=NovaWindows2 appium:app=Root
140
+
141
+ # 3. Wait for Notepad window
142
+ Wait Until Page Contains Element name=Untitled - Notepad
143
+
144
+ # 4. Input Text (Standard)
145
+ Appium Input name=Text Editor Hello from Robot Framework!
146
+
147
+ # 5. Advanced Interaction: Right Click to open context menu
148
+ Appium Right Click name=Text Editor
149
+
150
+ # 6. Select "Select All" from context menu
151
+ Appium Click name=Select All
152
+
153
+ # 7. Use PowerShell to verify the process is running
154
+ ${process}= Appium Execute Powershell Command Get-Process notepad | Select-Object -ExpandProperty Id
155
+ Log Notepad Process ID: ${process}
156
+
157
+ # 8. Drag and Drop Example (Conceptual)
158
+ # Appium Drag And Drop name=SourceItem name=TargetFolder
159
+
160
+ *** Keywords ***
161
+ Open Windows App
162
+ [Arguments] ${app_id}=Root
163
+ &{capabilities}= Create Dictionary
164
+ ... platformName=Windows
165
+ ... appium:automationName=NovaWindows2
166
+ ... appium:app=${app_id}
167
+ ... appium:newCommandTimeout=300
168
+ Open Application ${REMOTE_URL} &{capabilities}
169
+ ```
170
+
171
+ ---
172
+
173
+ ## 📚 Keyword Reference
174
+
175
+ ### Windows Specific Keywords
176
+ *Extends standard interactions with Windows-specific mouse events.*
177
+
178
+ | Keyword | Arguments | Description |
179
+ | :--- | :--- | :--- |
180
+ | `Appium Right Click` | `locator`, `timeout=20`, `**kwargs` | Performs a mouse right-click on the element found by `locator`. |
181
+ | `Appium Double Click` | `locator`, `timeout=20`, `**kwargs` | Performs a mouse double-click on the element found by `locator`. |
182
+ | `Appium Hover` | `locator`, `start_locator=None`, `timeout=20` | Hovers the mouse cursor over the specified element. |
183
+ | `Appium Drag And Drop` | `start_locator`, `end_locator`, `timeout=20` | Drags an element from `start_locator` and drops it at `end_locator`. |
184
+ | `Appium Click Offset` | `locator`, `x_offset`, `y_offset` | Clicks at a specific coordinate offset relative to an element. |
185
+ | `Appium Sendkeys` | `text` | Sends keystrokes to the active window using native Windows APIs. |
186
+
187
+ ### PowerShell & System Keywords
188
+ *Directly interact with the underlying OS for setup, teardown, and validation.*
189
+
190
+ | Keyword | Arguments | Description |
191
+ | :--- | :--- | :--- |
192
+ | `Appium Execute Powershell Command` | `command` | Executes a single-line PowerShell command and returns the output. |
193
+ | `Appium Execute Powershell Script` | `ps_script` OR `file_path` | Executes a full PowerShell script block or a `.ps1` file. |
194
+ | `Appium Ps Click` | `locator`, `x`, `y`, `button='left'` | Simulates a mouse click using PowerShell (useful as a fallback). |
195
+ | `Appium Ps Drag And Drop` | `start_locator`, `end_locator`, `...` | Simulates drag and drop using PowerShell mouse events. |
196
+ | `Appium Ps Sendkeys` | `text` | Sends keys using PowerShell `System.Windows.Forms.SendKeys`. |
197
+
198
+ ### Advanced File Transfer
199
+ *Optimized for reliability and handling large files over the wire.*
200
+
201
+ | Keyword | Arguments | Description |
202
+ | :--- | :--- | :--- |
203
+ | `Appium Pull File` | `path`, `save_path=None` | Downloads a file from the target machine. |
204
+ | `Appium Pull Folder` | `path`, `save_path_as_zip=''` | Zips and downloads a folder from the target machine. |
205
+ | `Appium Push File` | `destination_path`, `source_path` | Uploads a file to the target machine. |
206
+ | `Appium Split And Push File` | `source_path`, `remote_path`, `chunk_size_mb` | Splits a large file, uploads chunks, and recombines on target. |
207
+
208
+ ---
209
+
210
+ ## 🤝 Contributing
211
+
212
+ Contributions are welcome! Please feel free to open issues or submit pull requests to improve compatibility or add new features.
213
+
214
+ **Repository**: [nguyenvanhuy0612/robotframework-appiumwindows](https://github.com/nguyenvanhuy0612/robotframework-appiumwindows)
@@ -0,0 +1,23 @@
1
+ AppiumLibrary/__init__.py,sha256=2lme6iRjrBnYP73kbyZpI9eYPnD1mgB6-gwNVnG2TrU,5794
2
+ AppiumLibrary/appium_path.py,sha256=fAsq8pY-Rknqxph0SS4qYQvZSvzKif5PV9XE9uz5Myw,268
3
+ AppiumLibrary/version.py,sha256=tiPfWbcvAi_f_6m9SWjLspGk6wtLrLIYPpARm5C07o4,41
4
+ AppiumLibrary/keywords/__init__.py,sha256=j9ug8IsxoltsFwiYMvuk1lGWPzJdmrrG9btcmjgFYIE,746
5
+ AppiumLibrary/keywords/_applicationmanagement.py,sha256=J0rDv8neQwX4tnmR7QdbfPPF9BxVyyq-hyK5gGzsuwk,22682
6
+ AppiumLibrary/keywords/_element.py,sha256=-zgbutTG2NUPf2zwxyAUeNm1wL2b9AfUdLofnWhuWEo,53822
7
+ AppiumLibrary/keywords/_logging.py,sha256=07VoC1CYkCBWeEBeay-kpBHhES-uIb5g6_B7kXf1IHI,1864
8
+ AppiumLibrary/keywords/_powershell.py,sha256=o-E2-4AXbuEEL0m29yJ2Rva-4xIig9x7EDmNLjNo9u8,22982
9
+ AppiumLibrary/keywords/_runonfailure.py,sha256=dsy0qAyvoRFbnLy1lZgwadnFrKoFRh8hwTmRHocoz40,2847
10
+ AppiumLibrary/keywords/_screenrecord.py,sha256=ND1BQXt14uXbnknCNU2l4Wzna5abIUGU1l8FHM6dqZs,6789
11
+ AppiumLibrary/keywords/_screenshot.py,sha256=K5JJciCLOYbuSGzY5OErxL1Kc9tJX16GhqztdAzw32o,3747
12
+ AppiumLibrary/keywords/_waiting.py,sha256=GvX2Yn88zX_1rrl-MEADgx62wXUm08m8E04fcDlSLls,6265
13
+ AppiumLibrary/keywords/_windows.py,sha256=LNp6W-SuRsHXD3EUOXuB3GOz2zsogu-grhsBFCtUi4U,11502
14
+ AppiumLibrary/keywords/keywordgroup.py,sha256=nd7zhoqodlG4E7-smySMGbK6e1cV9AjI0FAxr4YncMc,2467
15
+ AppiumLibrary/locators/__init__.py,sha256=XtTYoS3PKdGSjZIR7fvaaK-ExaOh8ZWW2dddNBL419c,102
16
+ AppiumLibrary/locators/elementfinder.py,sha256=acwAJ2OJsN59yJ5201UH5GdRgWJIzEj5Cc-xCgHTJW8,10977
17
+ AppiumLibrary/utils/__init__.py,sha256=kFiEGeyc2IJVA1nUx2DezPkkO7HWTDnoL__gW4nRRlw,1572
18
+ AppiumLibrary/utils/applicationcache.py,sha256=YrRQgz-4d77hToib4ApBjFT5VohO65DMNiNVUr_PI_0,1523
19
+ robotframework_appiumwindows-0.1.2.dist-info/licenses/LICENSE,sha256=0usw_6IO4DLz-QIR_RLmRq9n4JX_Yns3Ew6dO-2FQmc,1070
20
+ robotframework_appiumwindows-0.1.2.dist-info/METADATA,sha256=RiIrHIstfVhj3lqmKiSoMoZmlFciYUU0_vEPaWktafI,10155
21
+ robotframework_appiumwindows-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
22
+ robotframework_appiumwindows-0.1.2.dist-info/top_level.txt,sha256=2o2iQDagXnzsewODgcttx95vTzvaYaZB7q6KJB8sf-I,14
23
+ robotframework_appiumwindows-0.1.2.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (80.9.0)
2
+ Generator: setuptools (80.10.2)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5
 
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Nguyen Van Huy
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Nguyen Van Huy
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.
@@ -1,148 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: robotframework-appiumwindows
3
- Version: 0.1.0
4
- Summary: Robot Framework AppiumLibrary extension for Windows desktop automation using NovaWindows Driver instead of WinAppDriver.
5
- Author-email: Huy Nguyen <nguyenvanhuy0612@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/nguyenvanhuy0612/robotframework-appiumwindows
8
- Project-URL: Repository, https://github.com/nguyenvanhuy0612/robotframework-appiumwindows
9
- Project-URL: Issues, https://github.com/nguyenvanhuy0612/robotframework-appiumwindows/issues
10
- Classifier: Development Status :: 3 - Alpha
11
- Classifier: Framework :: Robot Framework
12
- Classifier: Framework :: Robot Framework :: Library
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Programming Language :: Python :: 3.10
15
- Classifier: Programming Language :: Python :: 3.11
16
- Classifier: Programming Language :: Python :: 3.12
17
- Classifier: Operating System :: Microsoft :: Windows
18
- Classifier: License :: OSI Approved :: MIT License
19
- Classifier: Intended Audience :: Developers
20
- Classifier: Topic :: Software Development :: Testing
21
- Classifier: Topic :: Software Development :: Quality Assurance
22
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
- Requires-Python: >=3.10
24
- Description-Content-Type: text/markdown
25
- License-File: LICENSE
26
- Requires-Dist: robotframework>=7.3.2
27
- Requires-Dist: Appium-Python-Client>=5.1.1
28
- Dynamic: license-file
29
-
30
- # Robot Framework AppiumLibrary Compatible with NovaWindows Driver
31
-
32
- ---
33
-
34
- ## Overview
35
- This library extends [AppiumLibrary](https://github.com/serhatbolsu/robotframework-appiumlibrary) to provide compatibility with the **NovaWindows Driver** for Appium 2.x.
36
-
37
- It allows you to automate Windows desktop applications using **Robot Framework** with minimal setup.
38
-
39
- ---
40
-
41
- > **Note**
42
- >
43
- > - NovaWindows Driver currently uses a **PowerShell session** as its back-end.
44
- > - No Developer Mode required
45
- > - No extra dependencies required
46
- > - A future update is planned to move to a **.NET-based backend** for:
47
- > - Improved reliability
48
- > - Better error handling
49
- > - More feature support beyond PowerShell limitations
50
- >
51
- > Reference: [AutomateThePlanet/appium-novawindows-driver](https://github.com/AutomateThePlanet/appium-novawindows-driver)
52
-
53
- ---
54
-
55
- ## Installation
56
-
57
- ### 1. On the **Test Runner (local machine)**
58
-
59
- Install the Robot Framework library:
60
-
61
- ```bash
62
- pip install robotframework-appiumwindows
63
- ```
64
-
65
- > This is the only requirement on the machine where you run Robot Framework tests.
66
- > No need to install Node.js or Appium here.
67
-
68
- ---
69
-
70
- ### 2. On the **Target Machine (remote machine under test)**
71
-
72
- This is where the Appium server and NovaWindows driver must be installed.
73
-
74
- 1. Install **Node.js**
75
- [Download Node.js](https://nodejs.org/en/download)
76
-
77
- 2. Install **Appium** globally:
78
- ```bash
79
- npm install -g appium
80
- ```
81
-
82
- 3. Install **NovaWindows Driver**:
83
- ```bash
84
- appium driver install --source=npm appium-novawindows-driver
85
- ```
86
-
87
- 4. Start the Appium server:
88
- ```bash
89
- appium --relaxed-security
90
- ```
91
- (use `--relaxed-security` if you plan to execute PowerShell commands)
92
-
93
- ---
94
-
95
- ## Example Test
96
-
97
- ```robot
98
- *** Settings ***
99
- Library AppiumLibrary
100
-
101
- Test Setup Open Root Session
102
- Test Teardown Appium Close All Applications
103
-
104
-
105
- *** Test Cases ***
106
- Type To Notepad
107
- [Documentation] Launch Notepad, type text, and close without saving
108
- Appium Execute Powershell Command Start-Process "notepad"
109
- Appium Input class=Notepad This is example{enter 3}Close without save
110
- Appium Click //Window[@ClassName='Notepad']//Button[@Name='Close']
111
- Appium Click name=Don't Save
112
-
113
-
114
- *** Keywords ***
115
- Open Root Session
116
- ${parameters}= Create Dictionary
117
- ... remote_url=http://<TARGET_MACHINE_IP>:4723
118
- ... platformName=Windows
119
- ... appium:app=Root
120
- ... appium:automationName=NovaWindows
121
- ... appium:newCommandTimeout=30
122
- Open Application &{parameters}
123
- ```
124
-
125
- ---
126
-
127
- ## Architecture
128
-
129
- ```text
130
- +--------------------------+ +----------------------------+
131
- | Test Runner (Local PC) | | Target Machine (Windows) |
132
- |--------------------------| |----------------------------|
133
- | - Robot Framework | | - Node.js |
134
- | - robotframework- | ---> | - Appium 2.x |
135
- | appium-windows (pip) | | - NovaWindows Driver |
136
- +--------------------------+ +----------------------------+
137
- ```
138
-
139
- ---
140
-
141
- ## References
142
-
143
- - [Appium](https://appium.io/)
144
- - [Robot Framework](https://robotframework.org/)
145
- - [AppiumLibrary](https://github.com/serhatbolsu/robotframework-appiumlibrary)
146
- - [NovaWindows Driver](https://github.com/AutomateThePlanet/appium-novawindows-driver)
147
-
148
- ---
@@ -1,23 +0,0 @@
1
- AppiumLibrary/__init__.py,sha256=_8Mcsywy1P1ebzUl0Cn49RCLSHzG4zRrFQTNAL1r_2o,5901
2
- AppiumLibrary/appium_path.py,sha256=0LZFLn07dsxOY0FIJ4REEfyRbNBxtgNzX-rEfovEh_4,260
3
- AppiumLibrary/version.py,sha256=hrqXUu4slpU-usm7Rv3LJhMR6paooe0eSmHZXr8iYHY,47
4
- AppiumLibrary/keywords/__init__.py,sha256=vRZLNwHfUSaBPBY3dmDUejCihFL0N2ODYkrubhBwcjA,767
5
- AppiumLibrary/keywords/_applicationmanagement.py,sha256=qJYKpNjHEcNvXlWVfKIh-xCUkWJGyDTWigl2-nAJSMk,19786
6
- AppiumLibrary/keywords/_element.py,sha256=MsY69h0ZiRc8Tl6K4KU56k8fgWHv4WeHwIGm_h68TTE,53655
7
- AppiumLibrary/keywords/_logging.py,sha256=r9P56w85BFQIZw3pMQtFliu7uD4sqoCITDXDhB_LURM,1927
8
- AppiumLibrary/keywords/_powershell.py,sha256=j_-LrLIOkx6sdKj-P-bUerfcdpHIC_fIG4VZT4G2Ovo,23611
9
- AppiumLibrary/keywords/_runonfailure.py,sha256=t6kJrVJdCo9cHbuUUs1Qoy63Z7AKTrDBepOIxvsSNDQ,2921
10
- AppiumLibrary/keywords/_screenrecord.py,sha256=e8EXHTwiujeQVMrDhmYq6QIQk3MwSuuFpu8SWHZ0r7Q,6927
11
- AppiumLibrary/keywords/_screenshot.py,sha256=L_o1ncYsJ_ghJEVrNVlilXCxvkR9KyR7D-twZIAmEAQ,3998
12
- AppiumLibrary/keywords/_waiting.py,sha256=vDp7duuVuRsmtpf4DYgyvP363KpG9Ldffr2TD3GqTcI,6446
13
- AppiumLibrary/keywords/_windows.py,sha256=W7M5ba1IZ7YdAn3CPP58fq-CrBC_Ck-GaKXVh7dJjFE,9666
14
- AppiumLibrary/keywords/keywordgroup.py,sha256=SvgJNazRMZoyH4pBmGY_05l1FjVDaoVfwX6I3YN_fU0,2449
15
- AppiumLibrary/locators/__init__.py,sha256=-t6gBYeVN8LS1q_agwCNikDaH54v_JXPfRtE5slY9dg,109
16
- AppiumLibrary/locators/elementfinder.py,sha256=EdKVUJIHZCxrQkAu-0xp3yhCwA5qd5y55SnP58-dBP0,11241
17
- AppiumLibrary/utils/__init__.py,sha256=FlB2DCknRHFvtj4ZZbq3B0sSmZ9RTnvqucHNC9pReN4,1622
18
- AppiumLibrary/utils/applicationcache.py,sha256=AeeZIzRLxqcOLw9lIAir2_CypGAEwglCzzvMep4IQrg,1571
19
- robotframework_appiumwindows-0.1.0.dist-info/licenses/LICENSE,sha256=yVLQqHcOliLXZJC6M0K2u0WJL9yIW1u7d5bsM_qW1Es,1090
20
- robotframework_appiumwindows-0.1.0.dist-info/METADATA,sha256=HXX0laXT4t3XFysxHQL8Pr9G_bD6cs930X2-5Aux_iE,4902
21
- robotframework_appiumwindows-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
22
- robotframework_appiumwindows-0.1.0.dist-info/top_level.txt,sha256=2o2iQDagXnzsewODgcttx95vTzvaYaZB7q6KJB8sf-I,14
23
- robotframework_appiumwindows-0.1.0.dist-info/RECORD,,