Codea Runtime Library (BETA)

This is the Codea Runtime Library. It provides all the Lua bindings, graphics, sound and runtime engine for Codea on iPad. Using this library you can create standalone apps from a Codea project.

This version is a BETA. Please report any issues to us on the issue tracker on github. The underlying library is release-worthy, but the related scripts could have issues.

Versions

The topmost is the current version.

• 1.4.3 Current Codea Version - Mostly bug fixes
• 1.4.2 Current Codea Beta version
• 1.4.1 Current Codea version
• 1.3.6 Release BETA Version

License

The Codea Runtime Library is Copyright 2012 Two Lives Left and is licensed under the Apache License v2.0.

Requirements

The Codea Runtime Library requires Mac OS X and the iOS 5.0 Developer Tools. An iOS Developer License is required to build for devices and distribute on the Apple App Store.

Setup

Extracting your project's codea folder from the iPad can be done using iExplorer

1. Run the make_project.sh script from a Terminal session. It takes a parameter which is the name of the app.
   • eg, ./make_project.sh Test will create a folder called Test with a CodeaTemplate.xcodeproj file inside it and targets of the same name set up
2. Open the CodeaTemplate.xcodeproj project in Xcode.
3. Delete the existing the Project.codea file from the Classes group and select Move To Trash
4. Rename your codea project Project.codea
5. Drag and drop your project into the Xcode project
6. Check the "Copy items into destination folder's group (if needed)"
7. Select "Create folder references for any added folders" and make sure your app's target is selected. Click Finish
8. Setup the bundle id and Icon for your project as per usual

Issues

Please report any issue on the github issue tracker, and/or on the Codea forums.

Open Source Libraries

The Codea Runtime Library uses the following open source libraries with gratitude to the developers:

• Lua 5.1
• Box2D
• ASIHttpRequest
• libb64
• CCTexture2D (from Cocos2D)
• GLM
• ObjectAL
• SFXR
• UIDevice-Hardware

In addition, the Codea API was inspired by Processing.

Sprite Pack Attribution

• "Planet Cute" art by Daniel Cook (Lostgarden.com)
• "Small World" art by Daniel Cook (Lostgarden.com)
• "SpaceCute" art by Daniel Cook (Lostgarden.com)
• "Tyrian Remastered" art by Daniel Cook (Lostgarden.com)
• "Cargo Bot" art by Simeon (Two Lives Left)

Copyright and Trademark Guidelines

Guidelines for app developers using the Codea Runtime Library to produce apps for distribution.

Authorized Use of Two Lives Left Trademarks

• Attribution: You may use the Codea trademark when attributing Codea in your application, for example
  • You may include the "Made with Codea™" graphic in your application
  • You may describe your application as "Made with Codea" or "Made with the Codea Runtime Library" in your application's marketing materials

Unauthorized Use of Two Lives Left Trademarks

• Company, Product, or Service Name: You may not use or register Codea, Two Lives Left, or any other Two Lives Left-owned trademark as part of a company name, product name, trade name or service name. This includes Two Lives Left-owned graphic symbols, logos and icons.
• Endorsement: You may not use Codea, Two Lives Left, or any other Two Lives Left-owned tradmarks in a manner that would imply Two Lives Left's endorsement of a third party product or service.

Marketing Graphics for Use in Your Products

• You may use the following graphical elements in your products.
  • Made with Codea (White)
  • Made with Codea (Black)