To create an app either from scratch or a pre-existing template, as well as to further customize your app, install ArcGIS AppStudio.
To test your app on a device, see the Install AppStudio Player section below to install AppStudio Player on a device.
Install ArcGIS AppStudio
The following steps assume you'll use only use the cloud Make service provided by Esri to create stand-alone apps. To create stand-alone apps on your machine, you'll also need to Install development tools for local Make.
Download the AppStudio installation file for your operating system: Windows (x86 or x64), macOS, or Ubuntu from https://www.esri.com/en-us/arcgis/products/appstudio-for-arcgis/resources.
Double-click the file to install, and do the following:
- Click Next.
- Choose the install folder (the default is preferred).
- Accept the license agreement.
- Nominate the start menu name.
- Click Install.
Once the installation is complete, the following two shortcuts are added to your desktop:
- ArcGIS AppStudio—For configuring and managing your apps
- Qt Creator (ArcGIS AppStudio)—For editing your apps
The application files are located in the user folder under \Applications\ArcGIS\AppStudio. On Windows, this would be as follows:
On macOS and Ubuntu, this would be as follows:
Typically you will not edit these files. If you want to uninstall AppStudio, browse to this folder and choose Uninstall AppStudio.
Apps, templates, and data files are located in the user folder under C:\Users\UserName\ArcGIS\AppStudio (on Windows), or Home\ArcGIS\AppStudio (on macOS and Ubuntu).
The folders contained in the user folder are as follows:
- Apps—Contains apps that are either created locally in Qt Creator or AppStudio or downloaded from ArcGIS. Downloaded apps are contained in a folder named with the ArcGIS item ID.
- Data—Contains data used by apps. The same data can be referenced by multiple apps.
- Modules—Coming soon—Add your own QML libraries that can be used by different apps.
- Settings—Contains properties for each app.
- Templates—Contains template apps that are either created locally in Qt Creator or downloaded from ArcGIS. Use these template apps to generate your own apps. Template apps that are downloaded are contained in a folder named with the ArcGIS item ID.
Install AppStudio Player
AppStudio Player is also available for Windows, macOS, and Ubuntu. Any apps created in AppStudio on any platform can be used on any platform in the player. To install AppStudio Player on a desktop, do the following:
- Download the AppStudio Player installation file for your operating system from https://www.esri.com/en-us/arcgis/products/appstudio-for-arcgis/resources.
- Double-click the file to install.
Once the installation is complete, a desktop shortcut called AppStudio Player is created. The installation location for all AppStudio Player files on the desktop is the same as for AppStudio.
Unattended uninstall and install
When you install AppStudio or AppStudio Player on Windows, macOS, or Ubuntu, you're also provided with script files to help perform future unattended uninstalls or installs. To prepare for these actions, follow these steps after first installing the app, using AppStudio as an example:
- Browse to the location where the app was installed, which, by default, is ~Users\UserName\Applications\ArcGIS\AppStudio.
- Copy the following files to another location on your computer, for example \InstallScripts:
- When the time comes to install a new version of AppStudio, copy the app installation file to \InstallScripts.
Once this location has been established, the .qs and script files don't change. To perform unattended installs and uninstalls, only the installation files will need to change.
If you have multiple AppStudio-based apps on your computer, you only need one copy of silent-install-controller.qs and silent-uninstall-controller.qs. Copy only the different silent-uninstall-install-appName script files to \InstallScripts along side the .qs files.
To uninstall the app using these scripts, navigate to \InstallScripts in a command window and enter the following command:
On macOS or Ubuntu:
The period at the end is important, as it indicates that nothing will be installed.
Uninstall and install, or install only
To install the app, navigate to the folder in a command window and enter this command:
On macOS or Ubuntu:
The same command uninstalls all existing version of the app before installing the new version, allowing you to upgrade the app with one command.