To create an app either from scratch or a pre-existing template, as well as to further customize your app, install AppStudio for ArcGIS.
To test your app on a device, see the Install AppStudio Player section below to install Player on a device.
Install AppStudio for ArcGIS
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.
Download the AppStudio installation file for your operating system: Windows (x86 or x64), Mac OS X, or Ubuntu Linux from http://doc.arcgis.com/en/appstudio/download/.
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:
- AppStudio for ArcGIS—For configuring and managing your apps
- Qt Creator (AppStudio for ArcGIS)—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 Mac and Linux, 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 Mac and Linux).
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, Mac, and Linux. Any apps created in AppStudio on any platform can be used on any platform in Player. To install Player on a desktop, do the following:
- Download the Player installation file for your operating system from http://doc.arcgis.com/en/appstudio/download/.
- Double-click the file to install.
Once the installation is complete, a desktop shortcut called AppStudio Player is created. The installation location for all Player files on the desktop is the same as for AppStudio.
There are now two versions of AppStudio Player. Player supports the current ArcGIS Runtime and Qt version, lacks iOS 32-bit support, and will be continually updated. AppStudio Player Classic is the same version from the AppStudio 2.1 release; supports Runtime versions 100.1 and 10.2.6, Qt 5.9.1, and iOS 32 bit; and will not be updated.
Unattended uninstall and install
When you install AppStudio or AppStudio Player on Windows, Mac, 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 Desktop, 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 Mac 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 Mac 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.