https://github.com/ionic-team/native-run

Utility for running native binaries on iOS and Android devices and simulators/emulators
https://github.com/ionic-team/native-run

Last synced: 27 days ago
JSON representation

Utility for running native binaries on iOS and Android devices and simulators/emulators

• Host: GitHub
• URL: https://github.com/ionic-team/native-run
• Owner: ionic-team
• License: mit
• Created: 2018-07-20T01:29:56.000Z (over 6 years ago)
• Default Branch: develop
• Last Pushed: 2024-07-29T21:10:20.000Z (3 months ago)
• Last Synced: 2024-10-01T05:41:53.500Z (about 1 month ago)
• Language: TypeScript
• Size: 2.21 MB
• Stars: 127
• Watchers: 20
• Forks: 21
• Open Issues: 46
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![github-actions](https://img.shields.io/github/actions/workflow/status/ionic-team/native-run/ci.yml?branch=develop&style=flat-square)](https://github.com/ionic-team/native-run/actions?query=workflow%3ACI)

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)](https://github.com/semantic-release/semantic-release)

[![npm](https://img.shields.io/npm/v/native-run.svg?style=flat-square)](https://www.npmjs.com/package/native-run)

# native-run

`native-run` is a cross-platform command-line utility for running native app binaries (`.ipa` and `.apk` files) on iOS and Android devices. It can be used for both hardware and virtual devices.

This tool is used by the Ionic CLI, but it can be used standalone as part of a development or testing pipeline for launching apps. It doesn't matter whether the `.apk` or `.ipa` is created with Cordova or native IDEs, `native-run` will be able to deploy it.

## Install

`native-run` is written entirely in TypeScript/NodeJS, so there are no native dependencies.

To install, run:

```

npm install -g native-run

```

:memo: Requires NodeJS 16+

## Usage

```

native-run  [options]

```

See the help documentation with the `--help` flag.

```

native-run --help

native-run ios --help

native-run android --help

```

### Troubleshooting

Much more information can be printed to the screen with the `--verbose` flag.