The two properties
schemaVersion should always be present in an
$schema property powers the Visual Studio intellisense in the
app.json file for the various properties that each app item has. The
app.json included with the Quickstart references a schema at the root of the project. If you move an
app.json file, you will need to fix the relative path to the schema file. For more information on json schemas, see json-schema.org.
ViewerFramework folder containing the schema will not be created until an initial build is complete.
schemaVersion property is a required property that informs Geocortex Mobile what version of app config you are using. This allows for the schema to be updated in future releases without breaking old configuration.
An app config file is composed of a list of app items. App items can potentially be anything. Each app item has an item
$type, which viewer is aware of and knows how to locate and load. They usually they represent configuration for components, maps, portal items, or shared data. All item app configuration is specified within the
items array of the
Each component can only load a certain
$type of app item which corresponds to it. For example,
<map> components can only load app items of type
map-extension as their configuration.
Registering a class in this manner makes mobile aware of a new app item type, which can be added to the items list in the
app.json with the appropriate
$type specified. Components can consume these app items, and by extension, the configuration. Check out component configuration models for more details.
Item URIs are a commonly used pattern in the
app.json to uniquely identify and reference app items. They take the format
For example, the item URI for the following item is
These item URIs can be used by app items to include other app items as property values, allowing reuse.
Resource URIs are used to load layouts in Geocortex Mobile. Layout files are added to Geocortex Mobile as an asset which is copied into the end users local data folder. These copied assets are referenced with a URI of the format
For example, here's references to a small, medium, and large layout in the
The same config can be used for multiple items in a layout. For example, this allows you to reuse the same button in multiple locations in the App.
- App Config
- User Interface
All language strings used for properties in the app config, like "title" or "description", are automatically translated by the application.
Learn more about how to use and create language resources.