http://git-wip-us.apache.org/repos/asf/incubator-cordova-tizen/blob/f98b376a/LICENSE ---------------------------------------------------------------------- diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..6a504ba --- /dev/null +++ b/LICENSE @@ -0,0 +1,12 @@ + +Licensed 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. \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cordova-tizen/blob/f98b376a/NOTICE ---------------------------------------------------------------------- diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..c38e7d7 --- /dev/null +++ b/NOTICE @@ -0,0 +1,5 @@ +Apache Cordova +Copyright 2012 The Apache Software Foundation + +This product includes software developed by +The Apache Software Foundation (http://www.apache.org) \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-tizen/blob/f98b376a/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index 4c1fab0..fe68761 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,77 @@ -incubator-cordova-tizen -======================= +Cordova implementation for Tizen +=== + +Cordova implementation for Tizen is a JavaScript Wrapper library allowing to build and run Cordova based projects on [Tizen](https://www.tizen.org/). +Cordova based applications are, at the core, an application written with web technology: HTML, CSS and JavaScript. + +Apache Cordova is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator project. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF. + +Pre-requisites +--- + - [Tizen SDK 1.0 Larkspur Release](https://developer.tizen.org/sdk) + +Directory Structure +--- + /tizen + /samples ..... Ready-to-run Tizen Eclipse IDE sample projects + /templates ... Cordova Tizen SDK projects templates for Tizen Eclipse IDE + /www ......... Barebones project assets + +Import a Cordova Tizen project sample into Tizen Eclipse IDE +---- + +1. File -> Import +2. Select Import Source: Widget -> Projects and Widget file -> Next +3. Import Widget -> Select root directory: Point to the one of the sample projects (e.g: /cordova-basic) -> Finish +4. The project should be available now in the Tizen Eclipse IDE Project Explorer +5. You can now go to the [Build and Deploy a project] section of this document + + +Install Cordova Tizen project templates into Tizen Eclipse IDE +---- +1. Copy the entire /templates directory content into you Tizen Eclipse IDE web templates directory (e.g: /home/my_username/tizen-sdk/IDE/Templates/web) +2. You can now create Cordova Tizen project by using Tizen Eclipse IDE project templates + +Create a project with the Tizen Eclipse IDE Cordova Tizen project templates +---- +1. File -> New -> Tizen Web Project. +2. Select: User Template. +3. Select: User defined. +4. Select one of the Cordova templates, fill the Project Name, then -> Finish. +5. The project should be available now in the Tizen Eclipse IDE Project Explorer +6. You can now go to the [Build and Deploy a project] section of this document + +Build and Deploy a project +---- +1. Select and Right click the project -> Select Build project, this will generate your project widget package (.wgt) +2. Select and Right click the project -> Run As -> Here you can choose: + - Tizen Web Simulator application + - Tizen Web application (this will deploy you application to a pre-launched Tizen emulator or a Tizen connected device) + +Barebones project assets +---- + +The `www` folder contains the Cordova specific assets that must be available in a Tizen Web project to make it 'Cordova enabled'. +If you have an existing Tizen Web application project, copy/merge these files into its root directory. + + /www + config.xml .............. Tizen configuration file + cordova-x.y.z.js ........ Tizen Cordova JavaScript API implementation library + /sounds + beep.wav ............ Needed for Cordova Notification API implementation + +Add the following lines into the `<head>` section of your `index.html` project file: + + <script type="text/javascript" src="js/cordova.x.y.z.js"></script> + +`config.xml` is a sample that you are free to alter or merge with an existing Tizen configuration file. +It contains the `<feature>` elements required by the Cordova API. + +Further Reading +--- + +- [Cordova home](http://incubator.apache.org/cordova/) +- [Cordova Documentation](http://docs.phonegap.com) +- [Cordova Issue Tracker](https://issues.apache.org/jira/browse/CB) +- [Tizen Web SDK Documentation](https://developer.tizen.org/documentation) -temporary <incubator-cordova-tizen> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-tizen/blob/f98b376a/VERSION ---------------------------------------------------------------------- diff --git a/VERSION b/VERSION new file mode 100644 index 0000000..227cea2 --- /dev/null +++ b/VERSION @@ -0,0 +1 @@ +2.0.0 http://git-wip-us.apache.org/repos/asf/incubator-cordova-tizen/blob/f98b376a/samples/cordova-basic/.project ---------------------------------------------------------------------- diff --git a/samples/cordova-basic/.project b/samples/cordova-basic/.project new file mode 100644 index 0000000..a3b2b69 --- /dev/null +++ b/samples/cordova-basic/.project @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<projectDescription> + <name>cordova-basic</name> + <comment></comment> + <projects> + </projects> + <buildSpec> + <buildCommand> + <name>org.eclipse.wst.common.project.facet.core.builder</name> + <arguments> + </arguments> + </buildCommand> + <buildCommand> + <name>json.validation.builder</name> + <arguments> + </arguments> + </buildCommand> + <buildCommand> + <name>org.tizen.web.jslint.nature.JSLintBuilder</name> + <arguments> + </arguments> + </buildCommand> + <buildCommand> + <name>org.eclipse.wst.validation.validationbuilder</name> + <arguments> + </arguments> + </buildCommand> + <buildCommand> + <name>org.tizen.web.project.builder.WACBuilder</name> + <arguments> + </arguments> + </buildCommand> + <buildCommand> + <name>org.tizen.web.css.nature.CSSBuilder</name> + <arguments> + </arguments> + </buildCommand> + </buildSpec> + <natures> + <nature>org.eclipse.wst.jsdt.core.jsNature</nature> + <nature>json.validation.nature</nature> + <nature>org.tizen.web.jslint.nature.JSLintNature</nature> + <nature>org.tizen.web.WACnature</nature> + <nature>org.tizen.web.css.nature.CSSNature</nature> + <nature>org.eclipse.wst.common.project.facet.core.nature</nature> + <nature>org.eclipse.wst.common.modulecore.ModuleCoreNature</nature> + </natures> +</projectDescription> http://git-wip-us.apache.org/repos/asf/incubator-cordova-tizen/blob/f98b376a/samples/cordova-basic/config.xml ---------------------------------------------------------------------- diff --git a/samples/cordova-basic/config.xml b/samples/cordova-basic/config.xml new file mode 100644 index 0000000..44cf211 --- /dev/null +++ b/samples/cordova-basic/config.xml @@ -0,0 +1,19 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<widget xmlns="http://www.w3.org/ns/widgets"; xmlns:tizen="http://tizen.org/ns/widgets"; version="2.0 Beta" viewmodes="fullscreen" id="http://yourdomain/cordova-basic";> + <icon src="icon.png"/> + <content src="index.html"/> + <feature name="http://tizen.org/api/application"; required="true"/> + <feature name="http://tizen.org/api/application.kill"; required="true"/> + <feature name="http://tizen.org/api/application.launch"; required="true"/> + <feature name="http://tizen.org/api/application.read"; required="true"/> + <feature name="http://tizen.org/api/contact"; required="true"/> + <feature name="http://tizen.org/api/contact.read"; required="true"/> + <feature name="http://tizen.org/api/contact.write"; required="true"/> + <feature name="http://tizen.org/api/systeminfo"; required="true"/> + <feature name="http://tizen.org/api/time"; required="true"/> + <feature name="http://tizen.org/api/time.read"; required="true"/> + <feature name="http://tizen.org/api/time.write"; required="true"/> + <feature name="http://tizen.org/api/tizen"; required="true"/> + <name>cordova-basic</name> +</widget>
