blob: 44bf15f121e006a312d925088f33dd9f99b90a40 [file] [log] [blame] [view]
---
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.
---
Getting Started with Bada
=========================
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
---------------
- Windows
- You need the bada 1.2 SDK to use cordova-bada (which is no longer available on Samsung's website)
2. Install SDK + Cordova
-------------------------
- Download and install the [Bada SDK](http://developer.bada.com) (Windows only).
- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `bada` directory.
3. Set up New Project
--------------------
- In Bada IDE, select __File → Import project → Bada C++ / Flash Project__.
- __NOTE:__ In Bada 1.2 select __Bada Application Project__
![](img/guide/getting-started/bada/import_bada_project.png)
- Make sure __Select root directory__ is checked, then click __Browse__
- Browse to the Cordova bada project folder (bada for 1.2 and bada-wac for 2.x) and select it. Make sure __Copy projects into workspace__ is checked.
![](img/guide/getting-started/bada/import_bada_project.png)
- Click __Finish__
![](img/guide/getting-started/bada/bada_project.png)
4. Hello World
--------------
**Bada 2.x**: Your HTML/CSS/JavaScript code lives under the `Res/` folder. Make sure your `index.html` contains the following two lines in the `<head>` section:
<link href="osp://webapp/css/style.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="osp://webapp/js/webapp_core.js"></script>
**Bada 1.2**: Your HTML/CSS/JavaScript code lives under the `Res/` folder. Make sure your `index.html` contains the following line:
<script type="text/javascript" src="cordova/cordova.js"> </script>
5A. Deploy to Simulator
-----------------------
- **Bada 2.x**: Right-click on your project's folder and select __Run As &rarr; bada Emulator Web Application__
![](img/guide/getting-started/bada/bada_1_run.png)
- **Bada 1.2**: Right-click on your project' folder and select __Build configurations &rarr; Set Active &rarr; Simulator-Debug--__
![](img/guide/getting-started/bada/bada_set_target.png)
- Right-click on your project's folder and select __Run As &rarr; bada Simulator Application__. Note that you need to close the emulator every time you update your app.
5B. Deploy to Device
--------------------
- Make sure your device is properly configured
**Bada 2.x**: Right-click on your project's folder and select __Run As &rarr; bada Target Web Application__
**Bada 1.2**:
- Right-click on your project's folder and select __Build configurations &rarr; Set Active &rarr; Target-Debug__
- Right-click on your project's folder and select __Run As &rarr; bada Target Application__. You need to close the emulator every time you update your app!
Done!
-----