fbshipit-source-id: 32c81b4
xde 
The Exponent Development Environment
Download the latest version of XDE for macOS, Windows, or Linux.
On Linux, open with chmod a+x XDE*.AppImage and ./XDE*.AppImage.
Making a New Project
To make a new project, just click the "New" button in the upper left hand corner of the window. Then choose or make an empty directory where you want your project to live and hit OK.
This will setup that directory with a very basic React Native project that will work with Exponent and show off some basic but still cool things about React Native.
Viewing a Project on Your Phone
Once you create a new project (or open an existing project), you'll see some log messages that the packager has started and ngrok has started and the URL bar will get populated.
The url that begins with exp://... is the URL you can use to access your project while you're developing it. To view this on your phone, do the following:
- Go get the Exponent app on your Android or iOS device. It's available on the Google Play Store and on the iOS App Store.
- Open the Exponent app and put in your e-mail address.
- Go back to the XDE GUI on your computer and put in your phone number or e-mail address into the text box in the header, then hit the "Send Link" button. This will send a link via e-mail or text message, so make sure you use an address or phone number you can access from your phone.
- Check your e-mail or texts and tap the link. The Exponent app should open and you should be able to view your experience there!
Converting an existing project to work with Exponent
React Native apps that don't use native modules can work with Exponent. To configure them, you typically need to do a few quick steps:
-
In the directory that contains your React Native JavaScript source code, make sure there is a
package.jsonfile. There may already be one, but if not, runnpm initto create one. -
If the entry point of your app is not
index.jsthen add an entry"main"in yourpackage.jsonand give the filename that is the entry point for your app. Entry point basically means the file that contains the root component of your app. -
At the bottom of your entry point file, add a line like this:
AppRegistry.registerComponent('main', () => MyRootComponentName);
where MyRootComponentName is the name of your app's root component. There may already be a line like
AppRegistry.registerComponent('MyRootComponentName', () => MyRootComponentName);
Just leave that; it's totally fine to register the same component twice under two different names. Exponent by default looks for the main entry.
Now you can open this directory in xde and send the URL to yourself and view what you've made.
Publishing a Project
To publish something you've made, just follow these steps:
-
In XDE, create an Exponent account or login to an existing one using the pane on the right of the header.
-
Once you're logged in, open the project directory for the thing you want to publish. The packager should start, etc.
-
Check to make sure you can load your app by sending the link to yourself and opening it in the Exponent app.
-
Once everything looks good, hit the "Publish" button. A few seconds later, you should get a clean URL sent to you that points to the exp.host server where your package was published to.
You can publish as many times as you want and it will replace your old version, so don't worry about making a mistake!
Build From Source
git clonethis repository.git checkoutone of the release tags.git pullto make sure it is up to date.- Make sure you have Node version 6.2.2 (or compatible). If you don't have it, use nvm to install it. It won't clobber other installations of node you have and you can choose just to use it for installing xde (which is all you need it for).
touch ~/.profile
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.30.2/install.sh | bash
[Open a new terminal window]
nvm install v6
nvm use v6
- We use Yarn (https://yarnpkg.com/) to manage dependencies for XDE. Please install it by following directions here: https://yarnpkg.com/en/docs/install.
- Install
gulp-cli:npm i -g gulp-cli. - Go into the
xde/directory where you cloned the Git repo and runyarn. - Go into the
xde/appdirectory and runyarn. - Once that completes, run
yarn startfromxde/to start the GUI. - If you get a watchman error, you may need to increase your "max_queued_events" limit. On linux you can find this at /proc/sys/fs/inotify/max_queued_events.
- If you get
ENOENT: no such file or directory, open '.../node_modules/electron/path.txt', runcd node_modules/electron && node install.jsfromxde/. See the issue here: https://github.com/electron-userland/electron-prebuilt/issues/76.