| --- |
| 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. |
| --- |
| |
| Tizen Platform Guide |
| ========================= |
| |
| This guide describes how to set up your development environment for Cordova and run a sample application. Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name. |
| |
| 1. Requirements |
| --------------- |
| |
| - Linux Ubuntu 10.04/10.10/11.04/11.10 32-bit, Windows XP SP3/7 32-bit. |
| |
| 2. Install SDK + Cordova |
| ------------------------- |
| |
| - Download and install the [Tizen SDK](https://developer.tizen.org/sdk). |
| - Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `tizen` directory. |
| - (optional) Install Tizen Cordova template projects: copy the `/templates` directory content into you Tizen Eclipse IDE web templates directory (e.g: `/home/my_username/tizen-sdk/IDE/Templates/web`). |
| |
| 3. Set up New Project |
| -------------------- |
| |
| - **Method #1: Import a Cordova Tizen project sample** |
| - Launch Tizen Eclipse IDE |
| - Select **File → Import → Tizen Web Project** |
| |
|  |
| |
| - Click **Next** |
| - Make sure that **Select root directory** is checked |
| - Make sure **Copy projects into workspace** is checked |
| - Click **Browse** |
| - Browse to one of the Cordova Tizen `samples` project directory (e.g: `/cordova-basic`) and select it |
| |
|  |
| |
| - Click **Finish** |
| |
|  |
| |
| - Your project should now be imported and appear in the **Project Explorer** view |
| |
| - **Method #2: Use Tizen Eclipse IDE Cordova Tizen project templates** |
| - Launch Tizen Eclipse IDE |
| - Select **File → New → Tizen Web Project** |
| - Select **User Template** and **User defined** items |
| - Select one of the Tizen Cordova template (e.g: **CordovaBasicTemplate**) |
| - Fill the **Project name** and its target **Location** |
| |
|  |
| |
| - Click **Finish** |
| |
|  |
| |
| - Your project should now appear in the **Project Explorer** view |
| |
| 4. Hello World |
| -------------- |
| - To build your project: |
| |
| - **Right Click** your project in the **Project Explorer** view and Select **Build Project** |
| |
|  |
| |
| - A widget package should be generated in your project root directory (e.g: `cordova-basic.wgt`) |
| |
| - __NOTE:__ The sample Tizen Cordova projects provided go beyond basic "hello world" applications, and feature example usage of the Battery API. |
| |
| 5A. Deploy to Simulator |
| ----------------------- |
| |
| - **Right Click** your project in the **Project Explorer** view and Select **Run As** and **Tizen Web Simulator Application** |
| |
|  |
| |
| 5B. Deploy to Device/Emulator |
| -------------------- |
| |
| - Make sure that your target device is properly launched, connected and configured. Its __Date and Time__ settings must be set correctly. |
| - Select your application deployment target with the **Connection Explorer** view (Select **Window → Show View → Connection Explorer**.) |
| |
|  |
| |
| - **Right-click** your project in the **Project Explorer** view and select **Run As** and **Tizen Web Application** |
| |
|  |
| |
| Done! |
| ----- |
