# app-runner

**Repository Path**: mirrors_getsentry/app-runner

## Basic Information

- **Project Name**: app-runner
- **Description**: A set of scripts that automate running apps for e2e testing on Sentry
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-02
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# App Runner

PowerShell automation toolkit for application deployment, lifecycle management, and diagnostics collection across multiple target platforms.

## Overview

This repository contains PowerShell modules for automating application testing and diagnostics:

- **[app-runner](./app-runner)** - Platform lifecycle management, app deployment, and diagnostics collection
- **[sentry-api-client](./sentry-api-client)** - Sentry REST API client for event retrieval and CLI operations

## Supported Platforms

Currently supported:

- **Gaming Consoles:**
  - Xbox (One, Series X/S)
  - PlayStation 5
  - Nintendo Switch
- **Desktop Platforms:**
  - Windows
  - macOS
  - Linux
- **Mobile Platforms:**
  - Android (via ADB or SauceLabs Real Device Cloud)
  - iOS (via SauceLabs - coming soon)

## Requirements

### Platform-Specific Prerequisites

**Important:** Using this toolkit to run applications on target platforms requires:

1. **Valid development agreements** with the respective platform holders (Microsoft, Sony, Nintendo, Apple, Google, etc.)
2. **Licensed access to platform SDKs** and development tools
3. **Authorized development hardware** (devkits, testflight access, etc.) where applicable
4. **Compliance with platform holder NDAs** and terms of service

### General Requirements

- PowerShell 7.0 or later
- Appropriate platform SDKs installed and configured
- Platform-specific environment variables set (see individual module documentation)

## Getting Started

See individual module READMEs for detailed usage:

- [SentryAppRunner Module](./app-runner/README.md)
- [SentryApiClient Module](./sentry-api-client/README.md)

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md) for development standards and testing requirements.

## License

MIT License - See [LICENSE](./LICENSE) for details.