Skip to content

feat: add iOS launchAppWithArguments#1031

Open
Dor-bl wants to merge 2 commits intoappium:mainfrom
Dor-bl:feat/ios-launchapp-args-tests
Open

feat: add iOS launchAppWithArguments#1031
Dor-bl wants to merge 2 commits intoappium:mainfrom
Dor-bl:feat/ios-launchapp-args-tests

Conversation

@Dor-bl
Copy link
Collaborator

@Dor-bl Dor-bl commented Mar 27, 2026

List of changes

This pull request adds support for launching iOS apps with custom process arguments and environment variables via the Appium .NET client. It introduces a new helper method, exposes it through the IOSDriver API, and adds an integration test to verify the new functionality.

iOS App Launch Enhancements:

  • Added a new method LaunchAppWithArguments to IOSCommandExecutionHelper that allows launching an app on an iOS device with optional command line arguments and environment variables, using the mobile: launchApp Appium script.
  • Exposed the new LaunchAppWithArguments functionality through the IOSDriver class, making it available to client code.

Testing:

  • Added an integration test CanLaunchAppWithArguments in AppTests.cs to verify that an app can be launched with specific arguments and environment variables, and that it starts correctly in the foreground.

Types of changes

What types of changes are you proposing/introducing to the .NET client?
Put an x in the boxes that apply

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change that adds functionality or value)
  • Breaking change (fix or feature that would cause existing functionality not to work as expected)
  • Test fix (non-breaking change that improves test stability or correctness)

Documentation

  • Have you proposed a file change/ PR with Appium to update documentation?

This can be done by navigating to the documentation section on http://appium.io selecting the appropriate command/endpoint and clicking the 'Edit this doc' link to update the C# example

Integration tests

  • Have you provided integration tests for your changes? (required for Bugfix, New feature, or Test fix)

Details

Please provide more details about changes if necessary. You can provide code samples showing how they work and possible use cases if there are new features. Also, you can create gists with pasted C# code samples or put them here using markdown.
About markdown please read Mastering markdown and Writing on GitHub

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 27, 2026 10:29
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 adds a new iOS-specific API to launch an app with custom process arguments and environment variables via the mobile: launchApp execute-method, and validates it with an integration test.

Changes:

  • Added IOSCommandExecutionHelper.LaunchAppWithArguments to execute mobile: launchApp with optional arguments/environment.
  • Exposed the helper via IOSDriver.LaunchAppWithArguments.
  • Added an iOS integration test covering launching an app with arguments and environment variables.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
test/integration/IOS/Device/AppTests.cs Adds an integration test exercising the new launch-with-args API.
src/Appium.Net/Appium/iOS/IOSDriver.cs Adds a public driver method that forwards to the iOS command helper.
src/Appium.Net/Appium/iOS/IOSCommandExecutionHelper.cs Implements the execute-script helper for mobile: launchApp with args/env support.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@Dor-bl Dor-bl linked an issue Mar 27, 2026 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feat]: Provide a Friendly Method for mobile: launchApp Execution

2 participants