> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing App Clips

> Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.

An App Clip is a small part of your iOS app that people open from a QR code, an NFC tag, or a link, without installing the full app. BugRadar opens your App Clip with a URL the same way a scan does, then tests it like any other app.

> [!NOTE]
>
> App Clips work on **iOS cloud simulators** only. Real devices, local runs from the CLI, and Android are not supported.

## Upload your build

Either upload works:

| Upload | What it is |
| - | - |
| Your full app | The simulator build of your app. Xcode puts the App Clip inside it, in `YourApp.app/AppClips/`. BugRadar installs the App Clip the first time a test opens it. |
| The App Clip on its own | The App Clip's `.app` (its `Info.plist` contains `NSAppClip`), built for the simulator and zipped like any other `.app`. |

Build either one with the steps in [Building Your Mobile App for Our Cloud](/docs/app-build-guide.md).

## Open the App Clip in a test

Write a step with the URL that your QR code or NFC tag contains:

```text theme={null}
Open the App Clip at https://example.com/e/abc123
Verify the page shows the event details
```

The App Clip receives the URL as if someone scanned it. A test can open more than one URL, one step each.

On a real phone, an App Clip only appears when the full app isn't installed. So when this step opens the App Clip and the full app is installed, BugRadar first removes your full app and its data, as on a phone that has never had it. After an "Install the full app" step, it opens the link in the full app instead (see below).

## Install the full app

After the App Clip, a test can install the full app and carry on in it:

```text theme={null}
Open the App Clip at https://example.com/invite/abc123
Finish the sign-up in the App Clip
Install the full app
Verify you're signed in as the same user
```

This step closes the App Clip, installs the full app and opens it. The full app receives the App Clip's data, as on a phone, so you can check that someone who signed up in the App Clip is still signed in.

This step needs a full app upload. BugRadar installs the same build you uploaded.

If this test, or a later test in the same suite run, opens the App Clip again after this step, the link opens inside the full app, as it would on a phone that has the full app.

## After the App Clip opens

* Closing and reopening the app act on the App Clip until a step installs the full app. If the App Clip was closed, reopening it opens it again with the most recent URL.
* Logs and performance data come from the App Clip until a step installs the full app.
* When the test ends, BugRadar closes the App Clip.
* In a suite run, later tests start in the App Clip without a URL, with its data, until a test installs the full app. After that, they start in the full app.
* Outside a suite, each test starts in the app you uploaded, without the App Clip or its data.
* In a [multi-device test](/docs/multi-device-testing.md) on iOS simulators, each device opens its own App Clip.

## Errors

| Message | What to do |
| - | - |
| App Clips are supported on iOS cloud simulators only | Run the test on an iOS simulator. |
| This build doesn't include an App Clip | Upload a build whose `.app` contains an `AppClips/` folder, or upload the App Clip itself. |
| This build includes more than one App Clip | An app can contain one App Clip. Check the build's `AppClips/` folder. |
| The app isn't installed on the simulator | Run the test again. If it happens again, contact support. |
| Couldn't open the App Clip: iOS doesn't know this App Clip | Check that the URL matches the App Clip and that the App Clip is in the uploaded build. |
| Couldn't open the App Clip: iOS blocked the request | Contact support. |
| Couldn't open the App Clip: the device was busy | Run the test again. |
| Couldn't open the App Clip: the device host was unreachable | Run the test again. |
| App Clip support is unavailable on this host | Contact support. |
| This build is the App Clip on its own, so there is no full app to install | Upload your full app, not the App Clip on its own. |
| The full app is already installed | Put the step after an "Open the App Clip" step, and use it once per test or once per suite run. |
| Couldn't install the full app: BugRadar lost its copy of the build. Run the test again. | Run the test again. |
| Couldn't install the full app: *any other reason* | Run the test again. If it happens again, contact support. |
| Couldn't open the App Clip: the device was not reset. Run the test again. | If it happens again, contact support. |
| Couldn't open the App Clip: *any other reason* | iOS refused to open the App Clip. Check the URL and that the App Clip is built for the simulator. If the reason mentions the device host, run the test again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.