Gideros Mobile Academy 102
Gideros Studio: Installation and your
first code
GIDEROS MOBILE ACADEMY SERIES
Agenda
Downloading Gideros Studio Installing the prerequisites Installing Gideros Studio Running Gideros Studio Your first code!
Gideros Studio requirements
You can use Gideros Studio standalone, without installing other 3rd party applications for building your application.
This way you can
Evaluate the software Run your application under Gideros Player, and See how it'll feel like. However it may not be possible to test some of the features that come with device, e.g gyro, compass, etc. Therefore, in order to build for iOS and Android, youll need some libraries and IDEs, such as Java Eclipse and Xcode
iPhone / iPad device build requirements
To build for iPhone/iPad real device, you'll need the following: 64 bit Mac OS X Snow Leopard or Mac OS X Lion (for compiling and signing) Xcode Apple Developer License
These are not required to build for Android
Android device build requirements
To build for Android real device, you'll need the following: Java SDK Eclipse IDE Android SDK 2.1 or higher Android Development Tools (ADT) (Later) Google Developer License for sending apps to Android
markets.
These are not required to build for iOS (iPhone or iPad)
Installing Java JDK
Java is required if you want to modify, enhance and build your application using Eclipse IDE. To install Java JDK, follow these steps. Go to
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Click on Java 7 JDK Choose your platform Install Java JDK on your system
This step not required to build for iOS (iPhone or iPad)
Installing Eclipse
Eclipse is required to build APK files for Android. If you are not going to build for this platform, then you may skip this step. To install Eclipse, do the following:
Go to http://eclipse.org/downloads/ Choose your operating system Choose either 32 or 64 bit, depending on your operating system, and download "Eclipse IDE for Java Developers".
Extract the zip file to a folder
Eclipse is now ready to run.
This step not required to build for iOS (iPhone or iPad)
Installing Android SDK 2.1
Gideros Studio uses Android SDK 2.1 or higher, therefore Android applications built with Gideros Studio runs on devices running Android 2.1.
Go to http://developer.android.com/sdk/index.html Download and install the package for the platform of your choice. Run tools/android (Android SDK and AVD Manager) Click on Available Packages Install SDK Platform Android 2.1, API 7, revision 3
This step not required to build for iOS (iPhone or iPad)
Installing Android Development Tools for Eclipse
ADT extends Eclipse to let you quickly modify your application, which is exported from Gideros Studio. Using the Android SDK tools, you can export signed (or unsigned) .apk files in order to distribute your application. Since Gideros Studio can export Java source code, you can modify exported Java code before building the final APK (Android package) Install ADT plugin for Eclipse using the installation steps defined here: http://developer.android.com/sdk/eclipse-adt.html
This step not required to build for iOS (iPhone or iPad)
Downloading Gideros Studio
Downloading and installing Gideros Studio is free. You are also encouraged to try beta builds, but make sure that beta software may contain some bugs. System requirements: 1 Ghz processor 1 Gb RAM 250 Mb disk space for MS Windows 340 Mb disk space for Mac OS X
Installing Gideros Studio
For MS Windows: Double click on the executable you downloaded and follow these steps: Choose destination folder Click install For Mac OS X: Double-click the .dmg file to mount it Drag & drop Gideros folder into your Applications directory
Lets have a look at the IDE
Menu Bar
Project pane
Start Page or
Image Preview pane
Editor pane
Output pane
Gideros Player
Features of Gideros Studio IDE & Player
Multi-platform (Mac OS X, Windwos and Linux support) Start page for fast project access Code highlighting
Written in Qt Compiles Lua scripts before export Remembers all open tabs 8 scale modes to handle different
Code folding
Code completion Project manager Asset preview pane Directly runs the project on player
screen sizes
Support for several resolutions Orientation support Zoom in & out Orientation & rotation
Your first code, hello ball
Open Gideros Studio and create a new project from "File New Project" menu. Name your project HelloBall Right click the project name at Project tab and select "Add New File" Name your file "main.lua" and click OK (this is your main file) Double-click main.lua and write print("Hello Ball") in IDE. Press start button (or select "Player Start" from main menu) to run the project. Youll see the output of your project at the "Output" panel.
A more complex example
Copy the code below and paste it into main.lua
local background = Bitmap.new(Texture.new("field.png")) stage:addChild(background) local fruit = Bitmap.new(Texture.new("ball.png")) fruit.xdirection = 1 fruit.ydirection = 1 fruit.xspeed = 2.5 fruit.yspeed = 4.3 stage:addChild(fruit) function onEnterFrame(event) local x = fruit:getX() local y = fruit:getY() x = x + (fruit.xspeed * fruit.xdirection) y = y + (fruit.yspeed * fruit.ydirection) if x < 0 then fruit.xdirection = 1 end if x > 320 - fruit:getWidth() then fruit.xdirection = -1 end if y < 0 then fruit.ydirection = 1 end if y > 480 - fruit:getHeight() then fruit.ydirection = -1 end fruit:setX(x) fruit:setY(y) end stage:addEventListener(Event.ENTER_FRAME, onEnterFrame)
Adding images to asset library
Now lets add some images to our asset library Download field.png and ball.png (URL below) and copy these images to your project directory. Right click the project name and select "Add Existing Files" to add your image files to the project
Field.png: http://giderosmobile.com/documentation/assets/field.png
Ball.png: http://giderosmobile.com/documentation/assets/ball.png
Running in Gideros Player
Now select "Player Start Local Player to start Gideros Player.
It shows the IP address of your PC and the player. After player opens, start and stop icons become enabled on the toolbar. This means Gideros Studio is now connected to Gideros Player and ready to
upload your code and assets and then run the project.
Press start button (or select "Player Start" from main menu) to run the project.
Balls will be bouncing back and forth in the Player
GIDEROS MOBILE ACADEMY SERIES
info@giderosmobile.com
