ArcGIS Runtime SDK 100.11 for Qt sample applications. The repo contains Qt projects for each sample that can be run from within the Qt Creator IDE.
- Qt SDK 5.15.2 or higher (Open source or commercial)
- Qt Creator
- ArcGIS Runtime Toolkit - Qt is required as some samples utilize toolkit components.
- For more information, please visit the System Requirements page.
If you haven't already, fork the repo.
Clone the ArcGIS Qt SDK Samples
Open your terminal, navigate to your working directory, use git clone to get a copy of the repo.
# Clone your fork of the repository into the current directory in terminal
$ git clone https://github.com/YOUR_USERNAME/arcgis-runtime-samples-qt.git
Change directory into your locally cloned samples repo and then use git clone to get a copy of the ArcGIS Runtime Toolkit - Qt.
# Change directory to the clone of the samples repository
# Clone the toolkit repository into the current directory in terminal
$ cd /arcgis-runtime-samples-qt
$ git clone https://github.com/Esri/arcgis-runtime-toolkit-qt.git
Cloning the toolkit in this location will allow for the samples to automatically pick it up. If you wish to place the toolkit in another location, you will need to update the samples project file accordingly to locate the necessary .pri file.
To sync changes you make in a fork with this repository, you must configure a remote that points to the upstream repository in Git.
- Open a terminal (Mac users) or command prompt (Windows & Linux users)
- List the current configured remote repository for your fork
$ git remote -v
origin https://github.com/YOUR_USERNAME/arcgis-runtime-samples-qt.git (fetch)
origin https://github.com/YOUR_USERNAME/arcgis-runtime-samples-qt.git (push)
- Specify a new remote upstream repository
$ git remote add upstream https://github.com/Esri/arcgis-runtime-samples-qt.git
- Verify the new upstream repository
$ git remote -v
origin https://github.com/YOUR_USERNAME/arcgis-runtime-samples-qt.git (fetch)
origin https://github.com/YOUR_USERNAME/arcgis-runtime-samples-qt.git (push)
upstream https://github.com/Esri/arcgis-runtime-samples-qt.git (fetch)
upstream https://github.com/Esri/arcgis-runtime-samples-qt.git (push)
Once you have set up a remote upstream you can keep your fork up to date with our samples repository by syncing your fork.
- Open a terminal (Mac users) or command prompt (Windows & Linux users)
- Change to the current working directory of your local repository
- Fetch the branches and commits from the upstream repository. Commits to
mainwill be stored in a local branch,upstream/main.
$ git fetch upstream
- Check out your forks local
mainbranch
$ git checkout main
- Merge changes from
upstream/maininto your localmainbranch which syncs your forksmainbranch with our samples repository.
$ git merge upstream/main
Start Qt Creator. When the IDE opens to the Welcome screen, click on the Open Project button and browse to a project file (.pro) within your forked repo location. Configure the project and run the sample.
The main branch contains samples for the current, most up-to-date version of ArcGIS Runtime. To access previous versions, you can checkout by a tag or commit, or alternativley you can download the source zip:
Some of the samples consume offline data, including TPKs, VTPKs, mobile geodatabases, and mobile map packages, among other data formats. If the sample does consume offline data, the sample's associated readme.md will note where you can download the data (from ArcGIS Online), and where the data can be placed once downloaded. For example, it may say something like:
| Link | Local Location |
|---|---|
| Los Angeles Vector Tile Package | <userhome>/ArcGIS/Runtime/Data/vtpk/LosAngeles.vtpk |
In this case, you would download the VTPK from the ArcGIS Online Location, and place in specified location. <userhome> is used throughout to denote a generic location on the different platforms. The below table specifies where this is on all of the supported platforms:
| Platform | Userhome Location | Example Location |
|---|---|---|
| Windows | %userprofile% |
C:\Users\Bob\ArcGIS\Runtime\Data |
| Linux | ~ |
/users/bob/ArcGIS/Runtime/Data |
| Mac OS X | ~ |
/Users/Bob/ArcGIS/Runtime/Data |
| Android | /sdcard |
/sdcard/ArcGIS/Runtime/Data |
| iOS | <your app bundle> |
<appbundle>/ArcGIS/Runtime/Data |
Find a bug or want to request a new feature? Please let us know by submitting an issue.
Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.
Copyright 2020 Esri
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
A copy of the license is available in the repository's license.txt file