Getting Started with RoboVM Studio
This section shows how to build and test RoboVM iOS applications using RoboVM Studio. It will explain how to activate your commercial license, create new iOS projects, build an iOS application and then compile, test and debug using the tools and interfaces you are already familiar with.
Installing RoboVM Studio
Before installing, make sure to intall Xcode and Oracle's JDK 7+. RoboVM Studio will help you get everything else setup automatically the first time you open it. First it will ask you to point to the JDK you would like to use, which should be automatic. Then you can choose where it should install the android sdk, if you want to use RoboVM Studio for cross platform development. And finally you input your license key for one of RoboVM's subscription plans.
Creating a New Project
Creating a new iOS project from within RoboVM Studio is pretty simple. Selecting File > New > Project will open the dialog shown below, where you should choose RoboVM iOS App without storyboards.
The next two steps in the project wizard will allow you to customize your project with the following values:
- Package Name, e.g. com.mycompany.myapp
- Main Class Name, e.g. Main
- Application Name, the name used when your app is installed to an iOS device or simulator
- Application Id, a unique identifier, usually your package name
- Build System, the tool to use for managing builds and dependencies
Finally, specify your Project Name and Project Location.
Running & Debugging
In order to run your newly created iOS application, you must first setup a Run Configuration. Navigating to Run > Edit Configurations, and clicking the '+' to add a RoboVM iOS config, will open the dialog shown below.
You can create multiple configurations, one for each device and simulator you want to debug on. After closing the dialog, select the Run menu and choose the configuration you just created.
NOTE: The first time you run your application on the simulator or the device, RoboVM has to compile not only the classes of your app, but also any runtime classes required by your code. This can take some time. The next time you compile your app, RoboVM will only recompile the classes that have changed since the last compilation. You can view RoboVM's progress in the RoboVM console view.
When starting you app in debug mode, you have the full debugging tools of RoboVM Studio at your disposal: you can set breakpoints, step into/out/over source lines, inspect and set variables and even use RoboVM Studio's Evaluate Expression view.
Once you are happy with your app and have tested it on multiple devices, it is time to publish it to the App Store. For this you need to create an iOSApplication Archive (IPA). You can do so from within RoboVM Studio by selecting Build > Create IPA.
Specify the output directory, your signing identity and provisioning profile and click OK. You will find a file with the extension
.ipa in the output directory, which is ready to be uploaded to iTunes Connect via the Application Loader.
NOTE: Please refer to Apple's documentation on how to submit your application.