Skip to content

Conversation

@rmarinho
Copy link
Member

Description of Change

This pull request introduces a new developer skill for running .NET MAUI device tests locally on iOS simulators. It adds comprehensive documentation and two PowerShell scripts to streamline building, running, and managing device tests using xharness and the .NET SDK. The scripts automate simulator selection, build configuration, and test execution, making it easier for developers to verify iOS compatibility and run targeted tests.

Skill documentation and workflow:

  • Added .github/skills/run-device-tests/SKILL.md with detailed instructions, prerequisites, usage scenarios, supported projects, example commands, and workflow for running device tests on iOS simulators using xharness and PowerShell.

Device test automation scripts:

  • Added Run-DeviceTests.ps1 script to build and run specified MAUI device test projects on iOS simulators, supporting options for iOS version selection, test filtering, build-only mode, and output directory customization. The script also summarizes test results and failed tests.
  • Added List-Simulators.ps1 script to enumerate available iOS simulators, with support for filtering by iOS version and showing only booted simulators, helping users select appropriate test targets.

@rmarinho rmarinho requested a review from PureWeen January 12, 2026 18:46
- Remove List-Simulators.ps1 (duplicates Start-Emulator.ps1 functionality)
- Update Run-DeviceTests.ps1 to use shared Start-Emulator.ps1 for device management
- Add support for local dotnet tool (xharness via dotnet tool manifest)
- Update SKILL.md to document dependencies and remove List-Simulators references
- Net result: -59 lines while improving reusability and alignment with existing scripts

Tested: Successfully builds and runs Core device tests on iOS simulator
@rmarinho rmarinho marked this pull request as ready for review January 20, 2026 15:10
Copilot AI review requested due to automatic review settings January 20, 2026 15:10
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a new developer skill for running .NET MAUI device tests locally on iOS simulators. It provides comprehensive documentation and a PowerShell automation script to streamline the process of building, running, and managing device tests using xharness and the .NET SDK.

Changes:

  • Added complete skill documentation with prerequisites, usage scenarios, and examples for running device tests on iOS simulators
  • Added Run-DeviceTests.ps1 script that automates building device test projects, managing iOS simulators, executing tests via xharness, and reporting results
  • Integrated with existing shared infrastructure scripts for simulator management and common utilities

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
.github/skills/run-device-tests/SKILL.md Comprehensive documentation for the device tests skill including usage instructions, available test projects, workflow, and examples
.github/skills/run-device-tests/scripts/Run-DeviceTests.ps1 PowerShell script that handles building device test projects, managing iOS simulators, running tests with xharness, and reporting test results

kubaflo and others added 5 commits January 21, 2026 18:26
Enhanced the device test script to extract and validate the simulator UDID and dynamically detect the iOS version from the booted simulator. Both --target (with version) and --device (UDID) are now passed to XHarness for more reliable simulator selection, especially on ARM64 Macs. Updated documentation to explain the new detection and targeting logic.
@rmarinho rmarinho requested a review from kubaflo January 27, 2026 19:28
@kubaflo
Copy link
Contributor

kubaflo commented Jan 27, 2026

I prompted Copilot to run labeled device tests on Android, then followed up with iOS - and it worked flawlessly.

Screenshot 2026-01-27 at 22 53 59

@rmarinho rmarinho merged commit aee99e6 into main Jan 28, 2026
24 of 28 checks passed
@rmarinho rmarinho deleted the device-tests-skill branch January 28, 2026 11:44
@kubaflo kubaflo added the area-ai-agents Copilot CLI agents, agent skills, AI-assisted development label Jan 28, 2026
rmarinho added a commit that referenced this pull request Jan 29, 2026
### Description of Change

This pull request introduces a new developer skill for running .NET MAUI
device tests locally on iOS simulators. It adds comprehensive
documentation and two PowerShell scripts to streamline building,
running, and managing device tests using xharness and the .NET SDK. The
scripts automate simulator selection, build configuration, and test
execution, making it easier for developers to verify iOS compatibility
and run targeted tests.

**Skill documentation and workflow:**

- Added `.github/skills/run-device-tests/SKILL.md` with detailed
instructions, prerequisites, usage scenarios, supported projects,
example commands, and workflow for running device tests on iOS
simulators using xharness and PowerShell.

**Device test automation scripts:**

- Added `Run-DeviceTests.ps1` script to build and run specified MAUI
device test projects on iOS simulators, supporting options for iOS
version selection, test filtering, build-only mode, and output directory
customization. The script also summarizes test results and failed tests.
- Added `List-Simulators.ps1` script to enumerate available iOS
simulators, with support for filtering by iOS version and showing only
booted simulators, helping users select appropriate test targets.

---------

Co-authored-by: Shane Neuville <shneuvil@microsoft.com>
Co-authored-by: Jakub Florkowski <kubaflo123@gmail.com>
kubaflo added a commit to kubaflo/maui that referenced this pull request Feb 2, 2026
### Description of Change

This pull request introduces a new developer skill for running .NET MAUI
device tests locally on iOS simulators. It adds comprehensive
documentation and two PowerShell scripts to streamline building,
running, and managing device tests using xharness and the .NET SDK. The
scripts automate simulator selection, build configuration, and test
execution, making it easier for developers to verify iOS compatibility
and run targeted tests.

**Skill documentation and workflow:**

- Added `.github/skills/run-device-tests/SKILL.md` with detailed
instructions, prerequisites, usage scenarios, supported projects,
example commands, and workflow for running device tests on iOS
simulators using xharness and PowerShell.

**Device test automation scripts:**

- Added `Run-DeviceTests.ps1` script to build and run specified MAUI
device test projects on iOS simulators, supporting options for iOS
version selection, test filtering, build-only mode, and output directory
customization. The script also summarizes test results and failed tests.
- Added `List-Simulators.ps1` script to enumerate available iOS
simulators, with support for filtering by iOS version and showing only
booted simulators, helping users select appropriate test targets.

---------

Co-authored-by: Shane Neuville <shneuvil@microsoft.com>
Co-authored-by: Jakub Florkowski <kubaflo123@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-ai-agents Copilot CLI agents, agent skills, AI-assisted development

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants