Skip to main content

​
Overview

NativeBridge Test Automation provides a powerful, cloud-based platform for automating mobile application testing across iOS and Android devices. With support for industry-standard frameworks like Appium and Maestro, teams can execute comprehensive test suites, continuous integration workflows, and performance validations at scale.

Appium Support

Full compatibility with Appium WebDriver protocol for cross-platform testing

Maestro Framework

Native support for Maestro’s declarative testing approach

Cloud Devices

Access to real devices in the cloud for authentic testing scenarios

CI/CD Integration

Seamless integration with popular CI/CD pipelines

​
Getting Started

​
Accessing the Automation Platform

1

Navigate to Your Profile

Click on the profile icon in the top-right corner of the interface
2

Select App Automation

Choose App Automation from the menu or navigate directly to App Automation Section
3

Choose Your Workspace

Select an existing workspace or create a new one for your automation projects

​
Project Management

​
Creating Projects

NativeBridge offers multiple methods to initialize your automation projects:
  • New Project
  • Import Folder
  • GitHub Integration
Start fresh with a structured project template:
  • Pre-configured directory structure
  • Sample test files for quick start
  • Framework-specific boilerplate code
  • Environment configuration templates

​
IDE Environment

The integrated development environment provides a comprehensive workspace for test development:
  • Syntax Highlighting: Language-specific highlighting for test scripts
  • IntelliSense: Auto-completion for framework methods and properties
  • Error Detection: Real-time syntax and logic error identification
  • Code Formatting: Automatic code formatting and linting
  • Project Explorer: Hierarchical view of all project files
  • Search & Replace: Global search across all project files
  • Version Control: Built-in Git integration for tracking changes
  • File Templates: Quick creation of test files from templates
  • Test Runner: Execute tests directly from the editor
  • Debugging: Breakpoint support and step-through debugging
  • Console Output: Real-time test execution logs
  • Result Viewer: Interactive test result analysis

​
Test Execution

​
Execution Methods

UI Execution

Run tests directly from the web interface with visual feedback

API Triggers

Programmatic execution via REST API for automation pipelines

Magic Links

Shareable URLs for triggering specific test suites

​
Running Tests via UI

​
Single Test Execution

  1. Navigate to your project in the IDE
  2. Select the desired spec file from the project explorer
  3. Click the Run button (green play icon) in the toolbar
  4. Configure device and environment settings in the modal
  5. Monitor real-time execution progress

​
Batch Test Execution

Multi-file Selection: Hold Ctrl/Cmd while clicking to select multiple test files, or use Shift+Click for range selection. All selected tests will run sequentially or in parallel based on your configuration.

​
API-Based Execution

Integrate test execution into your CI/CD pipeline: 
curl -X POST https://api.nativebridge.io/v1/tests/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "your-project-id",
    "testFiles": ["test1.spec.js", "test2.spec.js"],
    "device": "iPhone-14-Pro",
    "framework": "appium"
  }'
Generate shareable execution links for non-technical stakeholders:
  1. Configure your test suite in the UI
  2. Click Generate Magic Link
  3. Share the URL with team members
  4. Recipients can trigger tests without platform access

​
Supported Frameworks

​
Appium Configuration

  • Capabilities
  • Sample Test
{
  "platformName": "iOS",
  "platformVersion": "16.0",
  "deviceName": "iPhone 14 Pro",
  "app": "path/to/app.ipa",
  "automationName": "XCUITest",
  "noReset": true
}

​
Maestro Configuration

  • Flow Definition
  • Advanced Flow
appId: com.example.app
---
- launchApp
- tapOn: "Get Started"
- inputText: "[email protected]"
- tapOn: "Continue"
- assertVisible: "Welcome Dashboard"

​
Advanced Features

​
Parallel Execution

Run multiple tests simultaneously across different devices:
Performance Boost: Parallel execution can reduce total test time by up to 80% compared to sequential runs. Configure parallelization in your project settings.

​
Test Data Management

Environment Variables

Secure storage and injection of sensitive test data

Data Files

CSV, JSON, and Excel support for data-driven testing

Dynamic Generation

Built-in functions for generating test data on-the-fly

External APIs

Integration with external data sources and services

​
Reporting & Analytics

​
Test Reports

  • Detailed Results: Pass/fail status, execution time, error messages
  • Screenshots: Automatic capture at failure points
  • Video Recording: Full session recordings for debugging
  • Performance Metrics: CPU, memory, and network usage

​
Analytics Dashboard

  • Trend Analysis: Historical pass rates and execution times
  • Flaky Test Detection: Identify unstable tests automatically
  • Coverage Metrics: Track test coverage across features
  • Custom Dashboards: Build personalized views with key metrics

​
Best Practices

  • Group related tests into suites
  • Use descriptive naming conventions
  • Implement page object patterns
  • Maintain separate configuration files
  • Minimize unnecessary waits
  • Use efficient element locators
  • Implement smart retry logic
  • Cache reusable test data
  • Regular review of test failures
  • Update locators proactively
  • Remove obsolete tests
  • Document test purposes clearly
  • Automate test triggers on commits
  • Set up quality gates
  • Configure notifications
  • Archive test artifacts

​
Troubleshooting

​
Common Issues

IssueSolution
Tests timing outIncrease wait times or check network connectivity
Element not foundVerify selector accuracy and page load status
Session creation failedCheck device availability and app compatibility
Parallel execution errorsReduce concurrency or increase resource allocation
Resource Limits: Be aware of your plan’s concurrent execution limits. Exceeding these may result in queued tests or execution failures.

​
API Reference

​
Authentication

All API requests require authentication via Bearer token: 
Authorization: Bearer YOUR_API_KEY

​
Endpoints

  • POST /v1/tests/run - Execute test suite
  • GET /v1/tests/{id}/status - Check execution status
  • GET /v1/tests/{id}/results - Retrieve test results
  • POST /v1/projects/create - Create new project
  • PUT /v1/projects/{id}/update - Update project configuration
For additional documentation and support resources, please check the main platform documentation or contact your system administrator.