wdio-mobile-utils-demo

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

wdio-mobile-utils-demo

★ 11 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://travis-ci.com/martinfrancois/wdio-mobile-utils-demo.svg?token=8WqsSGJvE4SAqmHHx2Z7&branch=master)](https://travis-ci.com/martinfrancois/wdio-mobile-utils-demo)

# wdio-mobile-utils Demo App

# Table of Contents

- [Installation](#installation)
  - [Basic Installation](#basic-installation)
  - [iOS Real Device Build Installation](#ios-real-device-build-installation)
  - [Setup Tests to run locally](#setup-tests-to-run-locally)
  - [Setup Tests to run on Sauce Labs](#setup-tests-to-run-on-sauce-labs)
- [Available Commands](#available-commands)
  - [Preview app](#preview-app)
  - [Run app locally](#run-app-locally)
    - [Android Emulator](#android-emulator)
    - [iOS Simulator](#ios-simulator)
  - [Build app locally](#build-app-locally)
    - [Android](#android)
    - [iOS Simulator](#ios-simulator-1)
    - [iOS Real Device](#ios-real-device)
  - [Run E2E Tests](#run-e2e-tests)
    - [Android](#android-1)
    - [iOS Simulator](#ios-simulator-2)
    - [iOS Real Device](#ios-real-device-1)
    - [Android & iOS Simultaneously](#android---ios-simultaneously)
- [Fastlane Certificates](#fastlane-certificates)
- [Upload App to Sauce Labs](#upload-app-to-sauce-labs)
  - [Android RDC](#android-rdc)
  - [iOS RDC](#ios-rdc)
  - [iOS Simulator](#ios-simulator-3)
- [Release](#release)

# Installation

Prerequisites:

- NodeJS 10 or 12
- NativeScript 6.5.0 or newer
  - follow the [CLI full setup guide](https://docs.nativescript.org/angular/start/quick-setup#full-setup) for your operating system

## Basic Installation

Run the following command:

```shell script
npm install
```

## iOS Real Device Build Installation

To be able to build an IPA file for deployment on real iOS devices, run the following command:

```shell script
npm run setup.ios.real
```

Then copy the file `.env.default.template` as `.env.default` and fill out the missing environment variables in the section `# iOS Real Device Build`.

## Setup Tests to run locally

To be able to run the E2E tests locally, you need to have Appium installed and running before running any of the testing commands below.

To install Appium globally using npm, run the following command:

```shell script
npm i -g appium@latest
```

Now you should be able to run Appium like this:

```shell script
appium
```

## Setup Tests to run on Sauce Labs

To be able to run the E2E tests on Sauce Labs, a few environment variables need to be set.

To do that, copy the file `.env.default.template` as `.env.default` and fill out the missing environment variables in the section `# E2E Tests on Sauce Labs`.

# Available Commands

To run anything iOS related, a macOS machine must be used.
Everything considering Android runs on Windows, Mac or Linux.

## Preview app

To preview the app on a real device using NativeScript's preview app, run the following command:

```shell script
npm run preview
```

## Run app locally

### Android Emulator

To run the app on the Android Emulator, run the following command:

```shell script
npm run run.android
```

### iOS Simulator

To run the app on the iOS Simulator, run the following command:

```shell script
npm run run.ios
```

## Build app locally

### Android

To build the app as an .apk file, run the following command:

```shell script
npm run build.android
```

You will then be able to find the built file in the following path:

```shell script
build/wdio-mobile-utils-demo.apk
```

### iOS Simulator

To build the app as an .app file to install on an iOS Simulator, run the following command:

```shell script
npm run build.ios.sim
```

You will then be able to find the built file in the following path:

```shell script
build/wdio-mobile-utils-demo.app
```

### iOS Real Device

To build the app as an .ipa file to install on a real iOS device, run the following command:

```shell script
npm run build.ios.real
```

You will then be able to find the built file in the following path:

```shell script
build/wdio-mobile-utils-demo.ipa
```

## Run E2E Tests

To run the E2E tests using WebdriverIO, run the following commands depending on the type.

Make sure to check the corresponding config files inside `/e2e/config/` and match the `deviceName` and `platformVersion` you use.

### Android

If you want to run the tests locally on an Emulator, make sure it is running before running any of the following commands!

```shell script
npm run e2e.android.run           # Runs the test locally
npm run e2e.android.debug         # Runs the test locally in debug mode
npm run e2e.android.sauce         # Runs the test on Sauce Labs RDC
```

### iOS Simulator

```shell script
npm run e2e.ios.sim.install       # Runs the test locally and installs the app
npm run e2e.ios.sim.run           # Runs the test locally using the already installed app
npm run e2e.ios.sim.debug         # Runs the test locally using the already installed app in debug mode
npm run e2e.ios.sim.sauce         # Runs the test on Sauce Labs Virtual Cloud
```

### iOS Real Device

To run E2E tests on real iOS devices locally, remember after connecting the device to your Mac to **enable** the following in the settings of the device:

- Developer -> `Enable UI Automation`
- Safari -> Advanced -> `Web Inspector` and `Remote Automation`

```shell script
npm run e2e.ios.real.install       # Runs the test locally and installs the app
npm run e2e.ios.real.run           # Runs the test locally using the already installed app
npm run e2e.ios.real.debug         # Runs the test locally using the already installed app in debug mode
npm run e2e.ios.real.sauce         # Runs the test on Sauce Labs RDC
```

### Android & iOS Simultaneously

To run the tests on both Android and iOS at the same time in parallel, run one the following commands.

If you want to run the tests locally on an Android Emulator, make sure it is running before running any of the following commands!

```shell script
npm run e2e.multiplatform.run           # Runs the test locally on Android Emulator and iOS Simulator
npm run e2e.multiplatform.debug         # Runs the test locally on Android Emulator and iOS Simulator in debug mode
npm run e2e.multiplatform.sauce         # Runs the test on Sauce Labs RDC on both Android and iOS
```

# Fastlane Certificates

To install or update iOS developer certificates using fastlane, run the following command:

```shell script
npm run dev.build.ios.real.setup
```

# Upload App to Sauce Labs

To upload the built app to Sauce Labs, use the following commands depending on the type.

## Android RDC

```shell script
npm run e2e.android.upload.sauce
```

## iOS RDC

```shell script
npm run e2e.ios.real.upload.sauce
```

## iOS Simulator

```shell script
npm run e2e.ios.sim.upload.sauce
```

# Release

To build a release, create a git tag on the master branch with the version number (in the format x.y.z) and push it.
Travis CI will then take care of the rest and publish a release on GitHub releases.

Example:

```shell script
git tag 1.0.0
git push --tags
```

wdio-mobile-utils-demo

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README