Download the app

Download the app from the My Content tab of the content page.

1. In the My Content tab of the content page, click the app to view its item details.
2. Click Download on the Overview page. The ZIP file downloads to your computer.

Deploy the app

Deploy the app based on your portal's authentication.

• If your portal is configured with OAuth2 or SAML authentication, do the following to deploy the app on your web server:
  1. Unzip the downloaded app.
  2. Add a proxy to your app. Refer to Use proxy for details.
  3. Add and register the app. Refer to Add apps and Register your app.
  4. Copy and paste the app ID to the appId property in the app config file. Save the file.
  5. Deploy the app on your web server.
• If your portal is configured with IWA, PKI, or LDAP authentication, do the following to deploy the app on your web server:
  1. Unzip the downloaded app.
  2. Add a proxy to your app. Refer to Use proxy for details.
  3. Change URL of ArcGIS API for JavaScript.

     Caution:

     When you access the app, you might be asked to sign in many times. This is because JavaScript files hosted by your portal need to be authenticated. As a result, you should host ArcGIS API for JavaScript outside the portal and change the apiUrl variable to it. This is specific to web-tier authentication.

  4. Deploy the app on your web server.

Customize the app

Do the following to customize the app.

• Add custom widgets:
  1. Put the custom widget in the widgets folder.
  2. Add the widget to the app’s config.json file.

     The example below uses the Demo widget. Add it to the config.json file.

     {
           "uri": "widgets/Demo/Widget"
         },

• Configure the app and widgets. Refer to JSON reference.
• Reference the preferred ArcGIS API for JavaScript. Refer to Change the URL of ArcGIS API for JavaScript.

Supported browsers

For a list of browsers supported by your deployed 2D and 3D apps, see Supported browsers.

Supported versions of ArcGIS API for JavaScript

• ArcGIS API for JavaScript 3.22 and later.
• ArcGIS API for JavaScript comes with Portal for ArcGIS 10.6.