license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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.

Amazon Fire OS Configuration

The config.xml file controls an app's basic settings that apply across each application and CordovaWebView instance. This section details preferences that only apply to Amazon Fire OS builds. See The config.xml File for information on global configuration options.

  • KeepRunning (boolean, defaults to true): Determines whether the application stays running in the background even after a pause event fires. Setting this to false does not kill the app after a pause event, but simply halts execution of code within the cordova webview while the app is in the background.

      <preference name="KeepRunning" value="false"/>
    
  • ErrorUrl (URL, defaults to null): If set, will display the referenced page upon an error in the application instead of a dialog with the title “Application Error”.

      <preference name="ErrorUrl" value="error.html"/>
    
  • LoadingDialog (string, defaults to null): If set, displays a dialog with the specified title and message, and a spinner, when loading the first page of an application. The title and message are separated by a comma in this value string, and that comma is removed before the dialog is displayed.

      <preference name="LoadingDialog" value="Please wait, the app is loading"/>
    
  • LoadingPageDialog (string, defaults to null): The same as LoadingDialog, but for loading every page after the first page in the application.

      <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
    
  • LoadUrlTimeoutValue (number, default is 20000): When loading a page, the amount of time to wait before throwing a timeout error. This example specifies 10 seconds rather than 20:

      <preference name="LoadUrlTimeoutValue" value="10000"/>
    
  • SplashScreen: The name of the file minus its extension in the res/drawable directory. Various assets must share this common name in various subdirectories.

      <preference name="SplashScreen" value="splash"/>
    
  • SplashScreenDelay (number, defaults to 5000): The amount of time the splash screen image displays.

      <preference name="SplashScreenDelay" value="10000"/>
    
  • ShowTitle (boolean, defaults to false): Show the title at the top of the screen.

      <preference name="ShowTitle" value="true"/>
    
  • LogLevel (string, defaults to ERROR): Sets the minimum log level through which log messages from your application will be filtered. Valid values are ERROR, WARN, INFO, DEBUG, and VERBOSE.

      <preference name="LogLevel" value="VERBOSE"/>