SDK Install Guide

From BUG Wiki

Jump to: navigation, search

Contents

Introduction

Dragonfly (the BUG SDK) comes with the Virtual BUG, a built-in emulator that allows you to quickly test drive your applications in a controlled environment without BUG hardware. Through the BUG SDK you can access the BUGnet community where you can browse, share and collaborate.

Dragonfly is built on Eclipse, a platform for developing Integrated Development Environments.

Prerequisites

  • Java 1.5 or greater
  • On Linux, you may need to install xulrunner for the browser view to work inside Eclipse. On a Debian or Ubuntu distribution, install like this: sudo apt-get install xulrunner

Two Install Methods

Full Install

The Full Install is Eclipse + Dragonfly bundled together. This is the easiest way to install Dragonfly and is useful if you're new to Eclipse or only plan to use Eclipse for BUG development.

NOTE: If you are using a 64-bit operating system, then you must use the Update Site method of installing Dragonfly.

Update Site

If you're an existing Eclipse user, or you are running a 64-bit operating system, you can install Dragonfly as an Eclipse plugin via our Update Site.

Full Install Instructions

(The full install bundles the latest version of Dragonfly with the latest supported version of Eclipse)

  • Download the correct zip file for your platform
  • Extract the file to whatever location is convenient
    • In Linux, /opt or ~/bin are common places to put Eclipse
    • The extracted folder will be called eclipse
  • Eclipse requires no installation. Open the extracted folder and click eclipse to run.
  • Change to the dragonfly perspective

Update Site Instructions

(These instructions are for Eclipse 3.4 and greater, for Eclipse 3.3, see below).

Install Eclipse if you don't already have it

Install the Dragonfly Plugin

  • In Eclipse, go to Help > Software Updates.
  • On the Software updates and Add-ons dialog, select the Available Software tab.
  • On the right column, select the Add Site... button to open the Add Site dialog.
  • Enter the Dragonfly Update Site url into the text box: 
http://buglabs.net/sdk/production/current/updatesite/
  • Click OK.
  • An item will appear in the Available Software list matching the above URL. Expanding that item will show a child item called Dragonfly.
  • Select the checkbox to the left of the URL. All child items should also be selected.
  • Click the Install... button on the upper right side of the dialog.
  • A progress bar should appear.
  • After a few seconds, the Install dialog will appear. One item, Dragonfly, should be listed and checked.
  • Click Next.
  • Eclipse will detect and install a dependency called the Graphical Editing Framework. You should see this listed in the following dialog if you don't already have it installed.
  • Accept the terms of the license agreement and click Finish.
  • A progress bar will appear as Eclipse downloads and installs the plugins.
  • When installation is complete, Eclipse will ask if you would like to restart.
  • Click No, then close and start Eclipse manually.
  • Once started Change to the dragonfly perspective.

Change your Perspective to Dragonfly

  • In Eclipse, go to Window > Open Perspective > Other...
  • In the Open Perspective window, click on Dragonfly to select it.
  • Click OK.

Install Dragonfly on Eclipse 3.3

These steps are for first-time Eclipse & Dragonfly installations only.

A. Install Graphical Editing Framework 3.3.0.

  1. Launch Eclipse.
  2. Go to File > Switch Workspace > Other ...
  3. In the Workspace Launcher, create a workspace similar to this: \Users\UsersName\Desktop\BUG\Workspace
  4. Go to Help > Software Updates > Find and Install
  5. In the Install/Update step, select Search for new features to install, then click Next.
  6. In the Install step, select Europa Discovery Site, then click Finish.
  7. In the Update Site Mirrors pop-up, select a download site, or mark the Automatically select mirrors checkbox.
  8. Click OK.
  9. In the new Updates window, make sure the "Filter features included in other features on the list" is unchecked.
  10. Click the arrow to open the Europa Discovery Site node.
  11. Click the arrow to open the Graphical Editors and Frameworks node.
  12. Mark the checkbox for Graphical Editing Framework 3.3.0—not the "SDK" version.
  13. Click Next.
  14. Below the Feature License, select I accept the terms in the license agreement, then click Next.
  15. Click Finish.

B. Install the BUG SDK:

  1. In Eclipse, go to Help > Software Updates > Find and Install.
  2. In the Install/Update step, select Search for new features to install, then click Next.
  3. In the Install step, click New Remote Site.
  4. In the Name form field, type: BUG SDK
  5. In the URL form field, type: http://www.buglabs.net/sdk/production/current/updatesite/
  6. Click OK.
  7. In the Install/Update step, select BUG SDK.
  8. Select Finish.
  9. Select the checkbox next to BUG SDK
  10. Select Next
  11. Select the radio button I accept the terms in the license agreement
  12. Select Next
  13. Select Finish
  14. At the prompt, select Install All
  15. Select Yes to restart Eclipse



Help

Need more help

Email our Support Staff or check out our Bug Labs Developer Resources

Retrieved from "http://bugcommunity.com/wiki/index.php/SDK_Install_Guide"