# e2e_testing

**Repository Path**: maksimovnikita/e2e_testing

## Basic Information

- **Project Name**: e2e_testing
- **Description**: ArkUI, Arkoala, ArkTS end-to-end testing
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-06-11
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# E2E Testing Framework for HarmonyOS

## Project Description

A comprehensive end-to-end testing system for HarmonyOS UI components. Automatically tests ArkTS components on real devices with custom testing framework and automated test generation from HarmonyOS SDK.

**Key Features:**
- 🧪 **Automated E2E Testing** - Tests UI components on real HarmonyOS devices
- 🤖 **Auto Test Generation** - Creates thousands of tests from HarmonyOS API using Idlize
- 🔄 **Failure Recovery** - Resumes testing after interruptions
- 📊 **Detailed Reports** - Comprehensive test results and logs

## Quick Start

### Prerequisites

- **HarmonyOS SDK 14+** and **DevEco Studio**
- **Node.js 16+** and **HDC** (HarmonyOS Device Connector)
- **HarmonyOS device or emulator**

### 1. Setup

```bash
# Install dependencies
cd run && npm install

# Open project in DevEco Studio
# Connect HarmonyOS device/emulator
```

### 2. Run Tests

```bash
# Automatic test execution (recommended)
cd run
node test_runner.js
```

**The system will automatically:**
- Connect to device
- Install and launch test app
- Execute all tests
- Generate reports in `run/result/`

### 3. View Results

```bash
# Brief report
cat run/result/report.txt

# Full execution log  
cat run/result/test_log.txt
```

## Common Commands

```bash
# Run specific test suite
hdc shell aa start -a EntryAbility -b com.example.e2e_testing -A partly --pi suite "Button"

# Monitor test logs
hdc shell hilog | grep TEST

# Generate new tests (requires Idlize)
cd generator && IDLIZE_VER=latest ./regenerate_ut.sh
```

## Documentation

📖 **[Complete Documentation](docs/INDEX.md)** - Full documentation index and navigation

**Quick Links:**
- 🚀 **[Quick Start Guide](docs/QUICK_START.md)** - Detailed setup and first test creation
- 📚 **[API Reference](docs/API_REFERENCE.md)** - All testing functions and interfaces  
- ⚙️ **[Test Generation](docs/TEST_GENERATION.md)** - Automatic test generation with Idlize
- 🔄 **[Development Workflow](docs/DEVELOPMENT_WORKFLOW.md)** - Complete development cycle
- 🏗️ **[Architecture](docs/ARCHITECTURE.md)** - System design and internals

## Troubleshooting

**Common Issues:**
- Device not found → `hdc list targets` and check USB connection
- Tests hang → `hdc shell aa force-stop com.example.e2e_testing` and restart
- Build errors → Check HarmonyOS SDK version compatibility

**Need Help?** Check logs in `run/result/` folder for detailed error information.

---