Deployment
The experience you created with ArcGIS Experience Builder can be downloaded and hosted on a web server. Any experience that is using private content must be registered on ArcGIS Online or ArcGIS Enterprise. In order to provide the best user experience for your end-users, please see the system requirements prior to deploying your experience.
Download the experience
To download the experience on the experience gallery home page, click on the ellipsis (three dots)
and click Download
(make sure there is no error in your client terminal when the app includes custom widgets). A ZIP file is created and downloaded to your local drive. It is located in the download directory defined for your browser.
Deploy the experience
To deploy the experience on your web server, complete the following steps:
- Unzip the downloaded experience and copy the folder to your web server.
- If your app has private content, complete steps 3-6, otherwise your experience is deployed.
- Add and register the app. See Add apps and Register your app for details.
- Copy the
App
and open the appI D config.json
file located in the root app folder (e.g. <.zip file root>\cdn\0\config.json). - Create a
client
property under theI d attributes
object. - Paste the
App
in theI D client
property in the app config.json file. Save the file.I d
The app is now available by browsing to your server/app name/index.html.
Service worker cache
Experience Builder uses service workers to proactively control the caching of assets to improve the load times of your application. If a deployed application requires an update to its source code, config.json, or any other changes, you can do the update in the Developer edition, then re-download and deploy the app. However, if you need to do the update in the download package directly, you must complete the following steps to update the service worker cache.
- In your app directory, rename
cdn/0
tocdn/1
. - Modify any source code or changes you need to make in the app.
- Open
index.html
on your application's root folder.- Change
<base href="./cdn/0/"/>
to<base href="./cdn/1/"/>
. - Change the
build
toNumber = '0' build
.Number = '1'
- Change
To get better performance, here are some recommended settings for the cache header:
- Cache
index.html
for a very short period such as one minute or no cache. - Cache the
cdn
folder for a long period such as one year.