Config Settings

 

General

 

Default Date Format

The default date format. Possible values are:

medium, short, fullDate, longDate, mediumDate, shortDate,
yyyy/mm/dd, mm/dd/yyyy, dd/mm/yyyy,
yyyy-mm-dd, mm-dd-yyyy, dd-mm-yyyy,
yyyy.mm.dd, mm.dd.yyyy, dd.mm.yyyy

long or short year (yy or yyyy), with or without time (hh:mm:ss). The selected date format also determines the date separator ("/" or "-" or ".").

Page size The number of records per page for List page
Top pager Enable pagination and show pager at the top of the List page
Bottom pager Enable pagination and show pager at the bottom of the List page
Multi-Language

Enable multi-language project. If enabled, a language selection box will appear in the settings page for the user to select language. See Default Language (below) for selecting languages for the multi-language project.

Note The data in your database must be stored in unicode, otherwise your data will not be displayed properly.
Default Language

Default language of the project. Default is English.

There is always one default language for a project. Only the English language file (english.xml) is shipped with DB AppMaker. If your project is single language but you use another language, create a language file for your language (see Customizing Template), put it in the "languages" subfolder under the installation folder and then select your default language using this combobox.

If you enable Multi-Language, you must select one of the selected languages as the default language. Click [...] to select the languages you want to use in the project. See Multi-Language Project for more details.

 

File folder

The global folder where the local media files resides. If you do not enter a specific folder for a IMAGE/AUDIO/VIDEO field in the View Tag panel of the Field Setup page, all the media files will be assumed to be located in this folder. During generation, the local files wil be processed and copied to the project folder. NOT for use with remote data.

Note If remote data, the media files are supposed on the production server, no files will be processed or copied during generation. On the production server, the media files must be placed in a folder relative to the connection script (dnapp.php, see below). Make sure you specify the file folder in the advanced setting File folder on production server, see Tools -> Advanced Settings.
Remote Data URL

If any table uses remote data, make sure you upload all generated PHP scripts (including all files and folders under <ProjectFolder>\server\php) to your server and set up the URL of the dbapp.php here. The URL MUST be accessible by the app installed on mobile device, e.g. http://www.mycompany.com/my/path/dbapp,php

Notes

  1. Remote Data does NOT support ODBC or Connection String data sources (see Database Setup).
  2. If the connection info on your production server is different from that you entered in the user interface, you can use the advanced setting Connection Info of production server (see Tools -> Advanced Settings) to specify.
  3. If you use MS Access, by default the database will be copied to <ProjectFolder>\server\php\<ProjectName>, make sure you upload the database folder to your production server. If you want to upload to an alternative path, use advanced setting Connection Info of production server (see Tools -> Advanced Settings) to specify the actual relative path of the database folder on your server. Windows server is required for using MS Access database.
  4. If you use MS SQL Server, Windows server with Microsoft SQL Server 2012 Native Client installed (see System Requirements) is required.
  5. Web server supporting PHP is required.
  6. dbapp.php contains info about tables which support remote data, it will only output data from those tables. If you have enabled or disabled tables for remote data in your project, make sure you re-generate dbapp.php and upload it to your server again.
  7. The server scripts will be generated under <ProjectFolder>\server\php, if you use that folder as the web root of your testing website but the web server user does not have permissions to execute the dbapp.php in the folder, you cannot see remote data. To let DB AppMaker change the permissions of the folder after generation, you can run DB AppMaker as administrator, e.g. right click the desktop icon of DB AppMaker and select Run as administrator.

 

Platforms

 

App
Name Application name (e.g. "Hello World")
ID (reverse-domain identifier) Application ID in the form of reverse-domain identifier (e.g. "com.example.helloworld")
Version (major.minor.patch) Application full version number number expressed in major/minor/patch notation.(e.g. "1.0.0"). This is the version number shown to users.
Version code (integer)

Version code of your app. An internal version number. This number is used only to determine whether one version is more recent than another, with higher numbers indicating more recent versions. This is not the version number shown to users. The value must be set as an integer, such as "100". You can define it however you want, as long as each successive version has a higher number.

If not specified, the following defaults will be used:

// assuming version = MAJOR.MINOR.PATCH-whatever

versionCode = PATCH + MINOR * 100 + MAJOR * 10000

Description Metadata to appear within app-store listings
Author Contact information to appear within app-store listings
Email Email address of author
Website Website of author
Disallow Overscroll Set to true if you don't want the interface to display any feedback when users scroll past the beginning or end of content. The default value is false.
Orientation Allows you to lock orientation and prevent the interface from rotating in response to changes in orientation. Possible values are default, landscape or portrait. The default value is default.
Append user agent If set, the value will append to the end of old UserAgent of webview. When using with Override user agent (see below), this value will be ignored.

Read The config.xml File for more information.

 

Android (Android-specific settings)
Background color Set the app's background color. Supports a four-byte hex value, with the first byte representing the alpha channel, and standard RGB values for the following three bytes. This example specifies blue: 0xff0000ff
Keep running Default: true 
Determines whether the app 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.
Load URL timeout value (ms) Default: 20000, 20 seconds 
When loading a page, the amount of time to wait before throwing a timeout error.
Log level Default: ERROR 
Allowed values: ERROR, WARN, INFO, DEBUG, VERBOSE 
Sets the minimum log level through which log messages from your app will be filtered.
Launch mode Default: singleTop 
Allowed values: standard, singleTop, singleTask, singleInstance 
Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running.
Default volume stream Default: default 
This preference sets which volume the hardware volume buttons link to. By default this is "call" for phones and "media" for tablets. Set this to "media" to have your app's volume buttons always change the media volume. Note that when using Cordova's media plugin, the volume buttons will dynamically change to controlling the media volume when any Media objects are active.
Fullscreen Default: false 
Allows you to hide the status bar at the top of the screen. 
Note: Recommended platform-agnostic way to achieve this is to use the StatusBar plugin.
Override user agent If set, the value will replace the old UserAgent of webview. It is helpful to identify the request from app/browser when requesting remote pages. Use with caution, this may causes compatible issue with web servers. For most cases, use AppendUserAgent instead.
Icon (min. 96px)

Large icon for the app. Will be resized to smaller versions automatically. PNG format is recommended.

Note If you use one single image for both Android and iOS, you should provide an icon of min 180x180px.
Splash screen (min. 960x960px)

Splash screen for the app. Will be resized to smaller versions automatically. PNG format is recommended.

Notes

  1. The outer edges of the images will be cropped, and the amount will vary based on device an viewport. Important graphics (logos, icons, titles) should be centered. The safe bounding region will vary, so you may need to test to ensure that the important graphics are never cropped.
  2. The image should be square so that it can be cropped as portrait or landscape splash screen.
  3. It is possible to use one single image for both Android and iOS, but be reminded that the minimum size of splash screen for Android is 960x960px and that for iOS is 2732x2732px, so you should provide an image of 2732x2732px for both platforms.
iOS (iOS-specific settings)
Build version number Alternative version for iOS. (CFBundleVersion) For further details, see iOS versioning.
Allow inline media playback

Default: false 
Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any <video> elements

Backup web storage Default: cloud 
Allowed values: none, local, cloud. 
Set to cloud to allow web storage data to backup via iCloud. Set to local to allow only local backups via iTunes sync. Set to none prevent web storage backups.
Gap between pages Default: 0 
The size of the gap, in points, between pages.
Keyboard display requires user action Default: true 
Set to false to allow the keyboard to appear when calling focus() on form inputs.
Media playback allows Air Play Default: true 
Set to false to prevent Air Play from being used in this view.
Media playback requires user action Default: false 
Set to true to prevent HTML5 videos or audios from playing automatically with the autoplay attribute or via JavaScript.
Page length Default: 0 
The size of each page, in points, in the direction that the pages flow. When PaginationMode is right to left or left to right, this property represents the width of each page. When PaginationMode is topToBottom or bottomToTop, this property represents the height of each page. The default value is 0, which means the layout uses the size of the viewport to determine the dimensions of the page.
Pagination breaking mode Default: page 
Allowed values: page, column 
Valid values are page and column. The manner in which column- or page-breaking occurs. This property determines whether certain CSS properties regarding column- and page-breaking are honored or ignored. When this property is set to column, the content respects the CSS properties related to column-breaking in place of page-breaking.
Pagination mode Default: unpaginated 
Allowed values: unpaginated, leftToRight, topToBottom, bottomToTop, rightToLeft 
This property determines whether content in the web view is broken up into pages that fill the view one screen at a time,or shown as one long scrolling view. If set to a paginated form, this property toggles a paginated layout on the content, causing the web view to use the values of PageLength and GapBetweenPages to relayout its content.
Suppresses 3D Touch gesture Default: false 
Set to true to avoid 3D Touch capable iOS devices rendering a magnifying glass widget when the user applies force while longpressing the webview. Test your app thoroughly since this disables onclick handlers, but plays nice with ontouchend. If this setting is true, SuppressesLongPressGesture will effectively be true as well.
Suppresses incremental rendering Default: false 
Set to true to wait until all content has been received before it renders to the screen.
Suppresses long press gesture Default: false 
Set to true to avoid iOS9+ rendering a magnifying glass widget when the user longpresses the webview. Test your app thoroughly since this may interfere with text selection capabilities.
Top activity indicator Default: gray 
Allowed values: whiteLarge, white, gray.
Controls the appearance of the small spinning icon in the status bar that indicates significant processor activity.
UI WebView deceleration speed Default: normal 
Allowed values: normal, fast 
This property controls the deceleration speed of momentum scrolling. normal is the default speed for most native apps, and fast is the default for Mobile Safari.
Icon (min. 180px) Large icon for the app. Will be resized to smaller versions automatically. PNG format is recommended.
Splash screen (min. 2732x2732px)

Splash screen for the app. Will be resized to smaller versions automatically. PNG format is recommended.

Notes

  1. The outer edges of the images will be cropped, and the amount will vary based on device an viewport. Important graphics (logos, icons, titles) should be centered. The safe bounding region will vary, so you may need to test to ensure that the important graphics are never cropped.
  2. The image should be square so that it can be cropped as portrait or landscape splash screen.

Read the following for more information:
Config.xml
Icons and Splash Screens

 

Settings

You can define the settings for your app here

ID

The ID of the setting.

Notes
  1. The ID should be alphanumeric only since this setting will be used as a JavaScript object property.
  2. There is a built-in setting for font size. The ID must be fontsize. Requires Use mobile accessibility enabled and Use preferred text zoom disabled (see Advanced Settings), otherwise the setting will be ignored.
  3. For multi-language project, there is a built-in setting for language. The ID must be language. You can set the Type as "SELECT" or "RADIO", no need to setup Options, which will be set up automatically as the selected languages (see above)for the project.
Name Name of the setting.
Type

Type of the setting. Supported types are:

  • LINK - Hyperlink
  • SELECT - Selection list for single selection
  • CHECKBOX - Checkbox list for multiple selection (Options will be displayed in a separate page)
  • RADIO - Radio button list for single selection (Options will be displayed in a separate page)
  • TOGGLE - Toggle button for boolean setting
  • TEXT - Text input
  • CUSTOM - Custom type, requires HTML setting (see below).
Default

Default value of the setting.

Notes
  1. The value must be in JavaScript literals, if it is string, it should be quoted, e.g. "value1".
  2. For CHECKBOX type, it must be an array of values even there is only one value, e.g. ["value1", "value2"].
Options

Options for SELECT/CHECKBOX/RADIO types. The options must be an array of values or object:

  1. Array of values, e.g. ["value1","value2","values3"]
  2. Array of object, e.g. [{ "value": "value1", "text": "Text 1" }, { "value": "value2", "text": "Text 2" }, { "value": "value3", "text": "Text 3" }]
Note For array of object, the keys of the objects must be "text" and "value". Only the values will be saved, the texts are for display only.
Attributes

Optional. Additional attributes for the HTML tag(s) of the setting.

Note The attributes must be in JavaScript object literals, e.g. { "attr1": "value1", "attr2": "value2" }.
HTML

Custom HTML for the setting. Required for the type CUSTOM (see above). In general, the HTML should contain ng-model="settings.<id>" where <id> is the ID of the setting.

Note This setting will override all above settings. Test your HTML carefully first or the setting cannot be saved. Read Directive components in ng for details.

There are 5 menu items in the toolbar for the Settings tab:

Add Add a new setting
Delete Delete the selected setting
Save Save the modified setting
Move up Move the selected setting up
Move down Move the selected setting down
Note
  1. To set the settings in the generated mobile app, click the gear icon at the top right of the screen of your mobile device and go to the Settings page. Change the settings as you need, they will be saved when you leave the Settings page.
  2. To use the settings in events, you can get the settings by dbapp.settings.<id> where <id> is the ID of the setting.

 

 

 ©2017 e.World Technology Ltd. All rights reserved.