Corona SDK Getting Started Guide

Transcription

1 Corona SDK Getting Started Guide November 29, ANSCA Inc. All Rights Reserved. 1

2 Ansca Inc Ansca Inc. All rights reserved. Lua 5.1 Copyright Lua.org, PUC-Rio. Ansca, Corona and Corona SDK are trademark of Ansca, Inc. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of Ansca Inc., with the following exceptions: Any person is hereby authorized to store documentation on a single computer for personal use only and to print copies of documentation for personal use provided that the documentation contains Ansca s copyright notice. The Ansca logo is a trademark of Ansca Inc. No licenses, express or implied, are granted with respect to any of the technology described in this document. Ansca retains all intellectual property rights associated with the technology described in this document. This document is intended to assist application developers to develop applications using Ansca software. Every effort has been made to ensure that the information in this document is accurate. Ansca is not responsible for typographical errors. Even though Ansca has reviewed this document, ANSCA MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS DOCUMENT, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS DOCUMENT IS PROVIDED AS IS, AND YOU, THE READER, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY. IN NO EVENT WILL ANSCA BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT OR INACCURACY IN THIS DOCUMENT, even if advised of the possibility of such damages. THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Ansca dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty. Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state. November 29, ANSCA Inc. All Rights Reserved. 2

3 Getting Started Guide This guide will help you get started using the Corona SDK. We ll cover the basics like installation, recommendations for setting up text editors, and discuss how to launch the simulator and the debugger. More in-depth information is available in: Corona SDK Applications Programming Guide will give you the foundation to create iphone applications using Corona. We recommend you follow the chapter called Tutorial? Introduction to help you get up to speed and start writing applications. Corona SDK Language and API Reference provides reference information for all functionality offered by Corona. Tools Guide provides more in-depth explanation of the various ways to use the Corona Simulator and also provides a sample session on how to use the debugger. November 29, ANSCA Inc. All Rights Reserved. 3

4 Installing the SDK 5 Installation 5 Activating the SDK 5 Launching the Simulator 7 Configuring Text Editors 8 Xcode 8 BBEdit 10 November 29, ANSCA Inc. All Rights Reserved. 4

5 Installing the SDK Installation Installation of the Corona SDK is very simple. If you haven t already, double click on the disk image you downloaded from the Corona Developer Portal. The disk image should have a name like CoronaSDK.dmg. Once it is loaded, you should see the mounted disk image folder (below). Next, drag the Corona folder into the Applications folder alias. This will copy the contents of the Corona folder into /Applications. If you are not an administrator, you will be prompted for an administrator password. A folder similar to the above should be located at /Applications/Corona after successful installation. We ll refer to this folder as the SDK folder. Activating the SDK In order to use the Corona SDK, you must perform a quick and easy one-time authorization process. In order to complete the authorization process, you must be connected to the Internet. Double click Corona Simulator in the SDK folder. The first time you launch, you will be presented with a End-user License Agreement (EULA). Assuming, you click Agree, you will then be presented with the following dialog: November 29, ANSCA Inc. All Rights Reserved. 5

6 Depending on your situation, you may already be a registered user: If you have purchased this product, then you have previously registered at the Corona Developer Portal ( as part of the checkout process., then enter your Corona Connect and password to activate the SDK. If you were a beta user, then you have already have a Corona Connect account. You can enter your account info and use the SDK on a trial basis. If you wish to purchase the full product, go to If you have never registered, then click Register. You will be taken to the Corona Developer Portal registration page to create a new Corona Connect user account. When you submit the form, you will be sent a verification to verify your identity. Once that is complete, you can enter the same and password you used to create the account into the above dialog to login. This will qualify you for a trial. If you do not to use the trial version, go to Upon successful login, you will get the following confirmation: November 29, ANSCA Inc. All Rights Reserved. 6

7 Launching the Simulator To launch the simulator, you have a couple of choices. The simplest thing is to double-click Corona Simulator. During day-to-day development, use Corona Terminal instead. This does the same thing as Corona Simulator but also opens a Terminal window that will display useful error messages such as syntax errors, runtime errors, and also allow you to print trace messages of your own. If you prefer to use the command-line, you can run simulator which does the same thing as Corona Terminal. At this point, you will be presented the standard Open dialog asking you to select a project folder. In Corona, all projects are simply folders containing a main.lua file. For example, below is the project folder for the Fishies sample project locating in the Sample Code folder of the Corona SDK (/Applications/Corona/SampleCode/Fishies). Inside the Fishies folder, you will find a file named main.lua along with some asset files for images and sounds. Select the folder and then click on the Open button and the simulator will launch. For more in-depth discussion information, consult the Tools Guide and also the Tutorial Introduction chapter of Corona SDK Applications Programming Guide. November 29, ANSCA Inc. All Rights Reserved. 7

8 Configuring Text Editors There are many editors available with which to write your code, such as the Xcode development software from Apple, BBEdit, textedit etc. For the purpose of this document, will give a basic run through with Xcode and BBEdit. The output of these programs will ultimately be a text file named main.lua. Xcode Once Xcode is installed, all of the necessary Xcode software can be found in /Developer/ on the root of your hard drive. For the proper syntax highlighting in Xcode, we recommend the following download: from this site: Follow the instructions included with the download. While syntax highlighting is not necessary, it makes it much easier to navigate your code. In Xcode, the quickest way to start writing code is to create an empty file. To do this, access the File menu and click on New File... On the left hand side, click on Other and select Empty File : November 29, ANSCA Inc. All Rights Reserved. 8

9 Once you click the next button, you will be prompted for a location and name for your file: In the File Name field, type main.lua. For Location, you ll need to create a folder to represent your project. The main.lua should be inside this folder. For example: Project Name/main.lua : Once you hit Finish, you ll be given an empty window in which to begin your project. If you have installed the syntax highlighting, things like local will be colored. This will help you navigate through your project. Once you have saved your project, you can now run it using the Corona Simulator. November 29, ANSCA Inc. All Rights Reserved. 9

10 For more advanced configuration options for XCode, please refer to the Documentation included with Xcode or on Apple s web site. BBEdit If this is your first time using BBEdit, you should see something similar to the window on the right: Hit continue when you have configured BBEdit to your liking. You should now see an empty window. In the lower left hand corner choose the appropriate language for proper syntax highlighting: Select Lua from the list. Now, as you write your program, it will attempt to automatically format for you: November 29, ANSCA Inc. All Rights Reserved. 10

11 Once you have saved your project, you can now run it using the Corona Simulator. For more advanced options with BBEdit, please refer to the BBEdit user manual. November 29, ANSCA Inc. All Rights Reserved. 11