The repo contains Qt projects for each sample that can be run from within the Qt Creator IDE. It also contains source code to build and run the sample viewer app locally.
- Prerequisites
- Set up the ArcGIS Maps SDK for Qt samples repo locally
- Open a sample project file in Qt Creator
- Build and run the ArcGIS Maps SDK for Qt Sample Viewers locally
- Use a previous version
- Use offline data in the samples
- Resources
- Issues
- Contributing
- Licensing
- Qt SDK 6.5.6 or higher (Open source or commercial)
- Qt Creator
- An access token
- ArcGIS Maps SDK for Qt Toolkit 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.
How to clone a forked repository
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-maps-sdk-samples-qt.gitChange directory into your locally cloned samples repo and then use git clone to get a copy of the ArcGIS Maps SDK for Qt Toolkit.
# Change directory to the clone of the samples repository
# Clone the toolkit repository into the current directory in terminal
cd /arcgis-maps-sdk-samples-qt
git clone https://github.com/Esri/arcgis-maps-sdk-toolkit-qt.gitCloning 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-maps-sdk-samples-qt.git (fetch)
origin https://github.com/YOUR_USERNAME/arcgis-maps-sdk-samples-qt.git (push)- Specify a new remote upstream repository
git remote add upstream https://github.com/Esri/arcgis-maps-sdk-samples-qt.git- Verify the new upstream repository
$ git remote -v
origin https://github.com/YOUR_USERNAME/arcgis-maps-sdk-samples-qt.git (fetch)
origin https://github.com/YOUR_USERNAME/arcgis-maps-sdk-samples-qt.git (push)
upstream https://github.com/Esri/arcgis-maps-sdk-samples-qt.git (fetch)
upstream https://github.com/Esri/arcgis-maps-sdk-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/mainStart 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, set your ArcGIS Developer API key in main.cpp, and run the sample.
Start Qt Creator. When the IDE opens to the Welcome screen, click on the Open Project button and browse to either sample viewer's project file (.pro) within your forked repo location. The sample viewer project file is located at arcgis-maps-sdk-samples-qt\SampleViewer\. Configure the project, set your API key in SampleViewer\SampleManager.cpp, and run the sample.
NOTE: the sample viewer project files search for the toolkit.pri at the default location specified above. If you cloned the toolkit repo to a different location, you will need to update the path in the respective sample viewer's project file.
The main branch contains samples for the current, most up-to-date version of ArcGIS Maps SDK. To access previous versions, you can checkout by a tag or commit, or alternativley you can download the source zip: https://github.com/Esri/arcgis-maps-sdk-samples-qt/releases.
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 it in a specified location. This location is the path returned by QStandardPaths::writableLocation(QStandardPaths::HomeLocation) from the Qt QStandardPaths class. <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 | <APPROOT>/files |
<APPROOT>/files/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