This document will discuss the build and deployment processes of Gideros Player and your application to iPhone/iPad devices. To follow these steps, you must be an approved Apple Developer for iOS and install the iOS SDK (requires Intel-based Mac running Snow Leopard). In the future, we are planning to wake up our Mac build server to allow developers to build Gideros Player and your projects for iPhone/iPad remotely on Windows without having to install the Xcode.
Gideros Player for iOS devices allows you to see and test your application on device instantly. After you deploy and open Gideros Player on your iPhone or iPad, you see the IP of your device. Enter this IP from "Player→Player Settings" menu:
When you press start button, your codes and asset files are transferred to your iOS device via WiFi and your application starts.
Apple requires developers to subscribe to Apple Developer Program. This allows programmers the ability to run their application on real devices. If you haven't done so, click http://developer.apple.com/ to join the iOS Developer Program either as an individual or a company.
These are the steps you need to follow before going on for iOS deployment. If you have already completed these steps, go to "Deploying Gideros Player to iOS devices" section.
- Obtaining your Certificate: https://developer.apple.com/ios/manage/certificates/team/howto.action
- Assigning devices: https://developer.apple.com/ios/manage/devices/howto.action
- Creating your App IDs: https://developer.apple.com/ios/manage/bundles/howto.action
- Creating Provisioning Profiles: https://developer.apple.com/ios/manage/provisioningprofiles/howto.action
Deploying Gideros Player to iOS Devices
There are two projects
which come with the installation. You need to extract these zip files and open, build, deploy these projects from Xcode using Mac OS X. This should be done only once as player need not be updated, and it's only used to run your code.
Deploying your application to iOS devices
To deploy your application to iPhone/iPad you need to:
- Export your application as Xcode project
- Build and deploy Xcode project to actual device
First step is done through "File → Export Project" menu:
For the second step, you need Intel-based Mac running Snow Leopard and Apple Developer License.
Note: Currently, exported Xcode project only includes the libraries for the real device and not for the iOS Simulator.
(This section is only for Gideros 2011.9 beta and above, which includes Android support)
Gideros 2011.9 beta and above includes support for Android, that is, you can write your code in Gideros Studio and deploy to both iOS and Android using same set of code. In order to have a working Android environment, you need to follow these steps:
- Install Eclipse and Android SDK for your operating system (see: http://developer.android.com/sdk/installing.html). Alternatively, this shorter tutorial will guide you how to install the Android development environment easily: http://www.talkandroid.com/android-sdk-install-guide/
- Deploy Gideros Player to your Android device (this is explained below).
- Deploy your application to your Android device (this is also explained below).
After installing Eclipse and Android SDK, follow these steps to deploy your Player and application to Android.
Deploying Gideros Player to Android devices
Gideros Studio comes with GiderosAndroidPlayer.apk, which is on the root directory of the installation folder. This apk file is used to "run" your application on a real device, so you can test your application thoroughly.
There are two easy methods to install an APK file to your device.
- Using adb install command: adb command comes with Android SDK, and can be used to automatize some actions (e.g installing or removing packages) on your device. Go to the GiderosAndroidPlayer.apk folder and run the following on a command line :
adb install GiderosAndroidPlayer.apk
In order to perform the command above, your computer and your Android device should be connected, and you should have installed necessary Android drivers to your computer before.
- Installing from device: Connect your Android device to your computer and copy GiderosAndroidPlayer.apk file to your device's internal disk. Then, using an internal file manager, click on the APK file and install.
After you install Gideros Player on a real device, you can immediately start testing your applications on your Android, by clicking on the GiderosAndroidPlayer icon and observing the IP address of your device. Then go to Gideros Studio → Player → Player Settings and enter the IP here. As you click OK, Gideros Studio will connect to your Android device and the play button will go green.
Deploying your application to Android devices
- Open your application with Gideros Studio.
- Export your application for Android (File → Export Project).
- Open Eclipse IDE and import the exported project to Eclipse using these steps:
- Go to File → Import
- Choose Android → Existing Projects into Workspace
- Select root directory and choose the directory you used to export your application. Now the application is imported to Eclipse.
- Click on Run → Run. If your device is plugged to your computer, application will be installed to the device and run immediately.