Skip to content

Commit 6f6e637

Browse files
feat: add TesterInstructions.md for installation and troubleshooting guidance
1 parent d00ee89 commit 6f6e637

1 file changed

Lines changed: 75 additions & 0 deletions

File tree

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
## Prerequisites
2+
3+
### System Requirements
4+
- Windows 11 or Windows 10 version 2004 (build 19041) or newer
5+
- x64 or ARM64 processor
6+
7+
### Required Software
8+
1. **PowerToys with Command Palette**
9+
- Install from Microsoft Store: https://apps.microsoft.com/detail/xp89dcgq3k6vld
10+
- Includes Microsoft Edge WebView2 Runtime
11+
- Available for both Windows 11 and Windows 10
12+
13+
## Installation Steps
14+
15+
### Step 1: Install PowerToys
16+
1. Open Microsoft Store
17+
2. Search for "PowerToys" or use the direct link above
18+
3. Click "Get" or "Install"
19+
4. Wait for installation to complete
20+
21+
### Step 2: Install Extension
22+
1. Download the MSIX package `WebSearchShortcut_x.x.x.0_x64(arm64).msix`
23+
2. Right-click the MSIX file
24+
3. Select "Install" from the context menu
25+
4. Follow the installation prompts
26+
5. The extension will automatically register with Command Palette
27+
28+
### Step 3: Activate Command Palette
29+
1. Open PowerToys
30+
2. Navigate to Command Palette tool
31+
3. Enable Command Palette if not already active
32+
4. Set your preferred hotkey
33+
34+
## Testing the Extension
35+
36+
### Basic Functionality Test
37+
1. Press your Command Palette hotkey
38+
2. In the search box, type "Reload"
39+
3. Select "Reload, Reload Command Palette extensions" and press Enter
40+
4. Type "google"(or bing, wiki, npm ...) in the search box
41+
5. Select the google item and press Enter
42+
6. Type anything what you want to search
43+
7. Press Enter to open browser and search your keyword
44+
45+
### Expected Behavior
46+
- Extension should fetch a random riddle from the internet
47+
- Default shortcuts(Google, bing, npm, YouTube...) should display clearly in the Command Palette
48+
- Pressing Enter should show the answer in a popup dialog
49+
- Each new activation should fetch a different riddle
50+
51+
## Troubleshooting
52+
53+
### Extension Not Appearing
54+
- Restart PowerToys
55+
- Reload Command Palette extensions (Step 3 in testing)
56+
- Verify the MSIX package installed successfully in Windows Settings > Apps
57+
58+
### Installation Issues
59+
- Run as Administrator when installing MSIX
60+
- Ensure Windows is up to date
61+
- Check Windows Event Viewer for detailed error messages
62+
63+
## What to Test
64+
65+
1. **Installation Process**: Smooth MSIX installation
66+
2. **Extension Discovery**: Appears in Command Palette after reload
67+
68+
## Reporting Issues
69+
70+
If you encounter problems, please report:
71+
- Windows version and build number
72+
- PowerToys version
73+
- Exact error messages
74+
- Steps to reproduce the issue
75+
- Screenshots if applicable

0 commit comments

Comments
 (0)