App QML Type

This is the main component of an Application. More...

Import Statement: import ArcGIS.AppFramework 1.0




Detailed Description

It defines all the attributes that are common across visual items, such as x and y position, width and height, anchoring and key handling support. App component can be useful for grouping several items under a single root visual item. Following code snippet explains the usage of the App component.

App {
    id: app;
    width: 400;
    height: 640;

    Text {
        id: appText;

        anchors {
            left: parent.left;
            right: parent.right;
            topMargin: 100;

        text: "My App"
        font.pointSize: 24
        color: "black"

        horizontalAlignment: Text.AlignHCenter;

    Button {
        anchors.bottom: parent.bottom
        anchors.bottomMargin: 100
        anchors.horizontalCenter: parent.horizontalCenter

        text: "Close"
        onClicked: {


BackButtonAction enumeration

This is currently under review. Please ignore.


Property Documentation

[read-only] arguments : QStringList

Returns the list of arguments passed to the app on launch.

backButtonAction : BackButtonAction

The action performed by the app when the device's back button is pressed.

[read-only] folder : FileFolder

Provides access to a folder and its contents.

[read-only] info : AppInfo

Provides details of the Application.

[read-only] releaseType : string

Returns the type of release as defined by the app's appinfo.json file.

[read-only] settings : Settings

Parameters can be set using this property

Signal Documentation


Signal emitted when the device's back button has been pressed.

Note: The corresponding handler is onBackButtonClicked.


This is currently under review. Please ignore.

Note: The corresponding handler is onColorChanged.

errorChanged(string error)

Signal emitted when the last error encountered by the app has changed.

Note: The corresponding handler is onErrorChanged.


Signal emitted when the system is low on available RAM. This signal is only supported on Android and iOS.

Note: The corresponding handler is onLowMemory.

openUrl(url url)

This signal is emitted when url is opened. For example,

onOpenUrl: {
    console.log("onOpenUrl:", url);

    var urlInfo = AppFramework.urlInfo(url);

    if (! {
        console.log("onOpenUrl parameters:", JSON.stringify(urlInfo.queryParameters, undefined, 2));

This URL can either be a traditional HTTP or HTTPS URL (for example, or a custom URL scheme (for example example-url://).

Note: The corresponding handler is onOpenUrl.

Method Documentation

AppDependency dependency(string propertyName, string value)

This method is currently under review. Please ignore.

The propertyName parameter

The value parameter

AppDependency dependency(string value)

This method is currently under review. Please ignore.

The value parameter


Restarts the app. When the app is run in Player, Player will be restarted.

Item {
    Button {
        width: 100
        height: 30
            text: "Restart app"
        onClicked: {
            txtArea.text += "\n\n" + "Restarting app..." + Date().toString();

    Timer {
        id: timer
        interval: 500; running: false; repeat: true
        onTriggered: {


Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.