XPLATFORM Hybrid’s Introduction

XPLATFORM Hybrid developed based off of XPLATFORM HTML5 applications is run on smart phones (Android, iOS) that are run by a RIA platform. By UX-Studio XPLATFORM HTML5 development environment is the same, but the execution environment is different.

XPLATFORM Hybrid’s Technology Elements

XPLATFORM Hybrid Applications for implementation and enforcement should be aware of the four skills. The four skills of XPLATFORM are language, development environment, an application execution environment, and the development environment. Between this, the application execution and development environment for each smart phone OS (Android, iOS) follows the way of the execution and deployment.

XPLATFORM Language

In XPLATFORM Hybrid, it uses the same screen and services as XPLATFORM HTML5. Therefore, XPLATFORM HTML5 uses all the features available. In addition, the Smartphone device (hereafter PDAs) that controls the unique features of the Device provides API.

The following XPLATFORM Hybrid is provided by the Device API.

Device API

Supporting Smart Phone OS

Information

System

iOS / Android

(Each support for each OS may be limited in its part.)

  • Provides basic information of the cell phone

  • Provides a dialing capability

  • Provides a simple playback of the sound file

Sms

  • SMS provides a transmitting function

  • SMS provides a detection ability

  • Provides the SMS safety of query / delete function

Audio Player

Provide for a sound file playback controls

Geo Location

GPS. WPS provides the information of where the phone was used

Acceleration

It provides an accelerometer sensor device of the speed of the mobile

Vibrator

Provides a vibration ability

Network

  • Checking the mobile's network status (No Network, 3G, Wi-Fi)

  • Ability to communicate the particular site offering an ability

Camera

Device provides the ability to use the built-in camera

Contact Set

Provides a lookup / add / delete / modify in contacts in the address book

File Dialog

Provides UI to the files and folders within the terminal for file input and output

Async V File

Provides for input and output files

Async Lite DB

Provides the ability to use the local DB

Audio Recorder

Provides ability to audio record

Image Picker

Provides access to Terminal of the photo album feature

Map

Provides Map Component to display map

External API

Provides ability to the external devices to the access / integration

Development Environment

The development and screen and services will be omitted as it is identical to the development environment of XPLATFORM HTML5.

In Android, iOS, programs cannot be executed arbitrarily but can only be executed in application programs that are made in the form of apps. Therefore, apps need to be developed so that application programs that are developed based on XPLATFORM HTML5 can be run on the terminal. XPLATFORM provides the packaging (including Archive creation) method and XPLATFORM Hybrid Library, but the actual development methods for making apps are not provided. Therefore, apps need to be made using the development environment provided by Android and iOS. Also, as shown in the picture below, Archive Files means .xzip file (means the same as zip file) and the files within the deploy server need to exist in the form of archive.

Application program execution environment

When the user executes XPLATFORM Hybrid application, XPLATFORM Hybrid Library operates first. You must install and upgrade HTML5 components to the terminal by loading XPLATFORM HTML5 Archive Files according to the update related information within hybrid_typedef.xml. After that, Load Run Archive Files and according to the contents of Run.html, run XPLATFORM HTML5 screen and service.

In the picture below, Archive Files (option) is in the case used for offline purposes and it does not mean that this particular file will necessarily be executed. Archive files (options) are installed on terminals and operated after loading.

Distribution environment

XPLATFORM Hybrid s composed of the produced results from UX-Studio and Hybrid app, which loads and operates these. A server is needed to distribute the results produced from UX-Studio, and the distribution methods are explained in XPLATFORM HTML5 and about other contents.

Distribution refers to the operation of reflecting Archive File in Deploy Server and installing XPLATFORM Hybrid app on user terminal.

Apps must be distributed through Market that supports the OS of each terminal. In the case of Android, APK distribution is possible through market run by Google, the terminal manufacturer, and the mobile communication company and it is also possible through private servers.

On the other hand, in the case of iOS, apps can only be distributed through Apple Appstore. A separate, private Market does not exist and distribution/execution on terminals that are not registered on Apple development account are impossible for testing.

The possible distribution methods on Android and iOS are as the following.

OS

Distribution method

Market type

Description

Operators

Android

market

Google Android Market

It is the market of Google, which has developed Android and the most number of Android applications are distributed here.

Google

Samsung Apps

It is the market run by the manufacturing company, Samsung.

Samsung

T store

It is the market run by the mobile communication company, SK Telecom.

SK Telecom

Olleh Market

It is the market run by the mobile communication company, Olleh(KT).

KT

OZ store

It is the market run by the mobile communication company, U+(LG).

LG

Self-deployment


It is a distribution method of distributing through a relevant URL by placing apk file in a private web server.

Self run

iOS

market

Apple Appstore

It is the market run by Apple.

However, you cannot use a private server.

Apple

The table chart above shows the commonly used markets in Korea and currently the number of markets operating in the world is increasing.

Major Components of XPLATFORM Hybrid Apps

The main components of XPLATFORM Hybrid App (APK / APP) are as the following:

XPLATFORM Hybrid App (APK / APP) of the main components are as follows:

Component

Details

Including Time

hybrid_typedef.xml

This is the file with the route information of XPLATFORM HTML5 Archive Files, Run Archive Files, Project Archive Files, and Theme Archive Files. This file must be included when developing an app.

※Precautions

  • The name of the file hybrid_typedef.xml is a designated value within XPLATOFMR, so it cannot be arbitrarily modified.

  • Other details may cause errors to occur, so configure only using UX-Studio and do not arbitrarily edit.

Build by including in Eclipse (Android) or XCode (iOS) in application program project.

XPLATFORM Hybrid Library (Native Code)

XPLATFORM Hybrid Library is a Hybrid Engine Library. This is a file that must be included. Android as an XPLATFORM.jar iOS is provided in the form of an XPLATFORM.framework. Below is detailed configuration information.

  • Mobile API Module

  • Native Code for Mobile API motion

  • WebView

  • WebView Control to output screen

  • Loading/Update Module

  • Module that manages loading and update when executing apps

XPLATFORM HTML5 Archive Files

This is a file including components for HTML5 in .is form, a compressed file of XPLATFORM HTML5 Framework files. You can download in the technical support site of XPLATFORM. The actual file name is Component.xzip.

※ precaution

  • This file must exist in the Deploy Server and because of the Sand Box concept it cannot be included in the app and executed.

  • The file name Component xzip is a value designated within XPLATFORM, so do not modify arbitrarily.

At run time loading / XPLATFORM Hybrid by an update will be downloaded into apps.

Run Archive Files

It is the file containing the route of Project Archive Files, Theme Archive Files in the case of running HTML5 Project for the first time through j네 route or offline purposes. This file must exist in the deploy server and because of the Sandbox concept, it cannot be executed within an application. The actual filename is Run.xzip.

※ Precautions

  • Create Run Archive Files only through UX-Studio and do not produce or modify them arbitrarily. This is to prevent any errors from occurring.

  • The file names Run.html, Run.xzip are values designated within XPLATFORM, so when the file names are modified operation may not be viable.

Project Archive Files

They are xadl, xfdl, the HTML5 project components developed by UX-Studio They are crated only for smart phones for offline purposes and do not have to be made.


※ Precautions

  • If you build including this file within an app, upgrade every time the screen changes among other cases, so it is not desirable to build within the app.

Theme Archive Files

It is the theme of the HTML5 project. It is created only if the smartphone is used for an offline purpose and it is not required to be made.

※ Precautions

  • If you build including this file within an app, upgrade every time the screen changes among other cases, so it is not desirable to build within the app.

The table above shows file names that must not be modified. The following sums up the list, so please take note.

File Name

Description

Run.html

Only R is capitalized and rest are small letters

Run.xzip

Only R is capitalized and rest are small letters

Component.xzip

Only C is capitalized and rest are small letters

hybrid_typedef.xml

All is lowercase.

Order of XPLATFORM Hybrid operation

XPLATFORM Hybrid works as below.

  1. If the user runs an app on a Smartphone XPLATFORM Hybrid Library that serves as Hybrid Engine operates.

  2. hybrid_typedef.xml loads and analyzes route information. However, this file name is the specified value within XPLATOFMR, and therefore should not be modified arbitrarily.

  3. Load XPLATFORM Archive Files including components for HTML5 in the form of .js on hybrid_typedef.xml according to the set route and install on smartphones. The actual file name is Component.xip, and it is a value designated within XPLATFORM, so do not modify arbitrarily.

  4. Load the initial execution jsp route of HTML5 project or Run Archive Files which includes the routes of Project Archive Files and Theme Archive Files according to the set route. The actual file name is Run.xzip. However, the file names Run.xzip, Run.html are designated values within XPLATFORM so do not modify them or their contents arbitrarily and use UX-Studio.

  5. Load and execute the initial environment according to the configured route in Run.html. For those packaged for offline purposes, load Project Archive Files, Theme Archive Files, and in other cases, download and load Server Project Files.

Development and execution procedures of XPLATFORM Hybrid

Development and execution of XPLATFORM Hybrid are implemented as the following.

The following procedure of the steps is as following the steps placed above.

Procedure

Details

Create HTML5 project

It develops application programs such as screen using the same method of XPLATFORM HTML5 development in UX-Studio.

Application to Deploy Server

After creating XPLATFORM HTML5 Archive File and Run Archive File in UX-Studio, they are applied to deploy server. In the case of using Smartphone for offline purposes, they are reflected on the deploy server after creating Project Archive Files and Theme Archive Files in UX-Studio.

Hybrid APP Project Generation

Hybrid App projects are generated in Eclipse (Android) and XCode (iOS). General APK / APP project is generated and refer to the provided XPLATFORM.jar (Android) and XPLATFORM. Framework (iOS). Hybrid_typedef.xml created by UX-Studio needs to be included in Hybrid App.

App (APK/APP)Build

Build App (APK / APP) in Eclipse (Android) and XCode (iOS), build the App (*In the case of building IOS as target, Apple Developer account is required.)

Execution

After the connection terminals run it through Eclipse (Android), XCode (iOS).

(* IOS devices targeted for the Apple developer account in order to run is needed as required.)

Distribution procedures and methods of XPLATFORM Hybrid

As shown in the figure below, XPLATFORM Hybrid and Hybrid app Archive Files are distributed separately. Archive Files is consisted of XPLATFORM HTML5 Framework packaged in UX-Studio, Run Archive, Form, Theme and are distributed to the deploy server. Hybrid apps consist of XPLATFORM Hybrid Library and hybrid_typedef.xml and are distributed to a market or a private server (Android only). After a user operates a Smartphone and downloads and executes an app from a market or a private server, the app loads the necessary information from the deploy server and runs the app. After a user-driven Smartphone handset market or a private server download and run apps from the app if Deploy the necessary information from the server will load and run the screen.

Using Market XPLATFORM Hybrid App (APK / APP) distribution procedures are as follows: The details for each market and each market difference see the relevant Guide.

Recommended specifications for App development

Recommended the following are the recommended specifications for terminals such as Android, and SDK Version of iOS.

For distribution, the newest version tool and SDK are recommended.

Android

Division

Item

Contents

Development

PC

Window/Mac/Linux use allowed

Eclipse

Tool for app development of ‘Android use (Provided for free)

  • Newest version : Eclipse Classic 3.7.1

ADT

  • Eclipse pluginprovided from Google for Android development (free of charge)

  • Recent newest version: ADT 15.0.0

Android SDK

  • Android SDK used in Eclipse, which has ADT installed on it (free of charge)

  • The minimum : greater than Android 3.0 SDK

  • Recent newest version: Android SDK r15

Developer’s Account

To distribute to Google Android Market / Samsung Apps developer accounts for each company is needed. The price for developer account is different for each company.

Terminal

Terminal OS

Android OS

  • Minimum : higher than 2.1

  • Recommended : higher than 4.1.2

Recent newest version: Android SDK r15

※ However, other than the OS mentioned above, needs an additional review.

Supported Terminal type

Samsung: Galaxy S2, 10.1 Galaxy tab

Pentek: Sky Racer Vega,

LG: Optimus 3D

Motorola: Atrix

HTC: sensation

Sony: Xperia arc

※ However, other products needs more investigation

iOS

Division

Item

Contents

Development

PC

  • Mac OS X only development / development can Minimum: Mac 10.6.8 or later

XCode

  • APP development for iOS for the tool

  • (provided free).

  • The latest version: XCode 4.2

iOS SDK

  • Will be installed with XCode. (Provided free).Be built to the latest version of the SDK can be development in the Appstore.

  • The latest version: iOS 5 SDK

Developer’s Account

Apple iOS developers in the form on the page will generate annual cost has been priced. The price is about 100,000 won per year depends on the exchange rate.

Terminal

Terminal OS

iOS

  • Minimum : higher than 3.1.2

  • Recommended : higher than 4.0

※ However, other OS from the ones mentioned above need further review

Supported terminal type

  • iPhone4

  • iPad2

※ However, other OS from the ones mentioned above need further review