installApp - Momentic

Installs an app on the device under test. installApp takes an .apk file on Android or a .app bundle on iOS, from a local path, a URL, or a managed asset:// reference. A URL must point to an .apk or a zipped .app bundle. The simplified form takes the app reference as a single string. The reference is one of:

A local path, relative to the Momentic project root. Android takes an .apk file. iOS takes a .app bundle or a zipped .app bundle.
An http:// or https:// URL to an .apk file or a zipped .app bundle.
An asset://<channel>/<tag> reference to an app asset you uploaded to Momentic. See app assets.

Local paths install on local emulators and simulators only. A hosted emulator or simulator installs from an asset:// reference or a publicly accessible URL. An asset:// reference needs an authenticated Momentic session.

Parameters

Parameter	Type	Required	Description
`path`	`string`	Yes	Local path, URL, or `asset://channel/tag` reference.
`saveAs`	`string`	No	Variable to store this step’s return value on `env.<name>`.
`retries`	`number`	No	Times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Shorthand

App reference as a single string.

- installApp: asset://my-app/latest

Examples

- installApp:
    path: ./build/app-release.apk

- installApp:
    path: ./build/MyApp.app

- installApp:
    path: asset://staging/nightly

⌘I