HomeGuidesReferenceLearn

Use expo-dev-client with EAS Update

Learn how to use the expo-dev-client library to preview a published EAS Update inside a development build.


This guide is likely to change as we continue to work on EAS Update.

The expo-dev-client library allows launching different versions of a project. One of the most popular use cases is to preview a published update inside a development build using the expo-dev-client library.

It supports loading published EAS Updates through channels. In this guide, you'll learn how to load a specific channel to preview an update in a development build.

How to load a published EAS Update inside a development build

1

Create a development build of the project.

2

Make non-native changes locally, then publish them using eas update --branch .... The branch specified should correspond to a channel. You can see how channels are linked to branches with eas channel:list.

3

After publishing an update, it's time to load the update in the development build. All development builds that have the expo-updates package installed include an Extensions tab where you can select an update:

Extensions tab in the Expo dev client.

Alternatively, you can construct a specific URL to open your EAS Update. The URL will look like this:

exp+[project-slug]://expo-development-client/?url=[https://u.expo.dev/project-id]?channel-name=[channel]

# Example
exp+form-duo://expo-development-client/?url=https://u.expo.dev/675cb1f0-fa3c-11e8-ac99-6374d9643cb2?channel-name=preview

Let's break down the parts of this URL:

  • exp+: The beginning of the URL.
  • form-duo: This is the project slug found in app.json/app.config.js.
  • ://expo-development-client/: necessary for the deep link to work with the expo-dev-client library.
  • ?url=: Defines a url query parameter.
  • https://u.expo.dev/675cb1f0-fa3c-11e8-ac99-6374d9643cb2: This is the updates URL, which is inside the project's app config (app.json/app.config.js) under updates.url.
  • ?channel-name=: Defines a channel query parameter.
  • preview: The name of the channel to request.

4

Once we've constructed the URL, we can either copy/paste it directly into the expo-dev-client's launcher screen. Alternatively, we could create a QR code of the URL, then scan it. Scanning this URL should open up the development build to the specified channel.

More

Working example

See a working example on using expo-dev-client with EAS Update.