{"id":18591,"library":"native-run","title":"native-run","description":"A cross-platform CLI for deploying native app binaries (.ipa/.apk) to iOS and Android devices and simulators/emulators. Current stable version v2.0.3 requires Node >=16. Maintained by the Ionic team with regular releases (semantic-release). Key differentiators: written entirely in TypeScript without native NodeJS addons, supports both hardware and virtual devices, automatically handles provisioning profiles and emulator creation. Commonly used as part of Cordova/Ionic workflows, but works standalone.","status":"active","version":"2.0.3","language":"javascript","source_language":"en","source_url":"https://github.com/ionic-team/native-run","tags":["javascript","android","ios","cli","mobile","app","hybrid","native"],"install":[{"cmd":"npm install native-run","lang":"bash","label":"npm"},{"cmd":"yarn add native-run","lang":"bash","label":"yarn"},{"cmd":"pnpm add native-run","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"CLI tool invoked via npx or global install. No programmatic API intended.","wrong":"native-run ios --target alien-device","symbol":"default","correct":"npx native-run android --app myapp.apk --verbose"}],"quickstart":{"code":"npx native-run android --app /path/to/app.apk --verbose","lang":"typescript","description":"Deploys an APK to a connected Android device or emulator with verbose logging."},"warnings":[{"fix":"Upgrade Node.js to v16 or later.","message":"Dropped support for Node <16 in v2.0.0","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Update Xcode to version 15+.","message":"iOS 17 support requires Xcode 15 or later","severity":"deprecated","affected_versions":">=1.7.3"},{"fix":"Upgrade to v1.7.1+ or manually specify arm64 architecture.","message":"Android emulator creation may fail on M1 Macs if ARM64 system image not used","severity":"gotcha","affected_versions":"<1.7.1"},{"fix":"Ensure Node v16 or higher is installed.","message":"v2.0.0 removed support for Node 14","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Upgrade to v2.0.1 or use only ASCII paths.","message":"Non-ASCII characters in file paths cause errors (<2.0.1)","severity":"gotcha","affected_versions":"<2.0.1"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Ensure Xcode is installed: xcode-select --install","cause":"Missing Xcode or iOS platform tools","error":"Error: Unsupported platform: ios"},{"fix":"Check connections with `adb devices` (Android) or `xcrun xctrace` (iOS)","cause":"No connected devices or running emulators","error":"Error: No devices or emulators found"},{"fix":"Provide absolute path or verify relative path","cause":"Incorrect path to APK/IPA file","error":"Error: APP_PATH does not exist: /path/to/app.apk"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}