Getting Started
1. Prerequisite
Prepare a Macintosh computer installed with Mac OS X Snow Leopard (10.6) or more recent version.
JDK 6 is not included in Mac OS X 10.6 Snow Leopard.
JDK is not included in Mac OS X 10.7 Lion. Please install by downloading JDK at “Java for OS X Lion” website page.
Appspresso recommend JDK6.
Android app, that is made by Appspresso studio on JDK7 environment, occurs kind of signing error.
Android SDK is cause of problem that they has compatibility issue with JDK7 environment.
So if this problem solve, We will recommend upper version of JDK.
2. Xcode Installation
After registering the developed in the Apple Developer Site, download and install Xcode from iOS Dev Center (above Xcode 4.2).
3. Appspresso Studio Installation
Enter your e-mail address on the Download Page of the Appspresso site. The download link of Appspresso Studio is sent to the email you have entered.
Among the links that were sent to your email, click the Mac one and download the Appspresso Studio and unzip the file into the place where you desire.
Run the Appspresso and select the workspace where the projects will be saved.
When Appspresso is executed, Appspresso Perspective is activated.
When Appspresso is running, select the Appspresso Perspective.
(Main menu> Window > Open Perspective > Other…)
4. Preference
The below description for the configuration is drawn up based on XCode 4.2 version.
When using XCode 4.3 and later versions, please refer to XCode 4.3x configuration.
Select the Main Menu > Window > Preferences > Appspresso in the Windows.
In Mac, select the Main Menu > Appspresso Studio > Preferences > Appspresso.
Enter the installation path of JDK in the Java SDK Home item.
When Java SDK Home item is blank 1. Refer to advanced Prerequisites and set Java SDK Home.
Select the Main Menu > Appspresso Studio > Preferences > Appspresso.
Enter the iOS SDK Home item. The default is /Developer.
5. Project Creation
Select the Main Menu > File > New > Appspresso Application Project.
Enter the value of other items.
Project name: The name of the project.
Title: The name of the app that will be shown along with the icon.
Id: The unique identifier of the app. Follow the custom of writing the name of the domain in reverse.
Version: It’s the version of the app. In case of iOS, the app registered in the store is upgraded through increasing the value of the app. In case of Android, the purpose of this value is to show to the buyers and if you want to upgrade the app already registered in the market, you must increase the Version Code. (Refer to Tutorial)
Select the Hello World template and click the Finish button.
6. Running Application in the Simulator
Right click the HelloWorld projects in the Project Explorer View and select the “Run Appspresso application on iOS Device” menu in the context menu after clicking it.
In the “Select Target Device” dialogue Box, select the item that starts with “iphonesimulator” name.
In the selected simulator, the app will start to run.
7. Running the Application in the Device
Register in the iOS Developer Program of Apple ($99/year).
Refer to the About the iOS App Development Workflow of Apple and install the developer certificate.
Download the latest version of iTunes and install it.
Connect the iOS cell phone to the USB port.
Appspresso runs the app in the device that was used previously by default. When running the app, in order to change the device from the simulator to the iOS cell phone, select the Run as.. > Run Configurations… menu in the context menu after right clicking the HelloWolrd project in the Project Explorer View.
Click the select button on the Target tap and in the “Select Target Device” dialogue box, click the OK button after selecting the item that starts with “iphoneos” in the name and the certificate.
Click the Run button on the Run Configurations dialogue box.
After iTunes is running and app is added to the iTunes, it is synchronized with the iOS cell phone.
After synchronization is over, run the app on the iOS cell phone.
If synchronization fails, select the iOS cell phone in iTunes and check if the app to run is selected on the apps tap and check the Automatically sync new apps option and click the Sync button to synchronize manually.
8. Create .ipa file
Refer to the About the iOS App Development Workflow of Apple and install the Distribution Certificate.
Select the Export menu in the context menu after right clicking the HelloWorld project in the Project Explorer View.
Select the Appspresso> iOS Application(.ipa) and then click the Next button.
Select the project, distribution certificate and enter the path the .ipa file will be saved. Afterwards, click the Finish button and the .ipa file will be created in the selected path.
1. Prerequisites
In Windows, download and install the JDK. (Above JDK 6)
JDK 6 is not included in Mac OS X 10.6 Snow Leopard.
JDK is not included in Mac OS X 10.7 Lion. Please install by downloading JDK at “Java for OS X Lion” website page.
Appspresso recommend JDK6.
Android app, that is made by Appspresso studio on JDK7 environment, occurs kind of signing error.
Android SDK is cause of problem that they has compatibility issue with JDK7 environment.
So if this problem solve, We will recommend upper version of JDK.
In Windows Vista/7, go to control panel> system> advanced system set up> advanced and click ‘environment variable’ button.
In Windows XP, go to control panel> system> advanced and click ‘environment variable’ button.
After clicking ‘remake’ button, input JAVA_HOME in ‘name of variable’ and the navigation where JDK is installed (e.g. C:\Program Files\Java\jdk1.7.0) in ‘value of variable’, then click ‘confirm’ button.
After clicking ‘remake’ button, input PATH in ‘name of variable’ and %JAVA_HOME%\bin in ‘value of variable’, then click ‘confirm’ button.
If PATH variable already exists, add %JAVA_HOME%\bin in ‘value of variable’.
2.Android SDK Installation
Download and install the Android SDK R18 or more recent version.
After installing it, run the Android SDK Manager.
You should select Android SDK Tools, Android SDK Platform-tools and Android Platform that you need on Android SDK Manager’s package items, and the click install button.
Appspresso always build using latest version of Android SDK. (relate on April 27, 2012) So, You have to install SDK Tools upper than R18 and Platform upper than Android 4.0.3 (API 15)
In the dialog box of Choose Packages to Install, select the Accept All option and click the Install button.
If you run the “Android SDK Manager” on the Windows, the Choose Packages to Install dialog box can automatically show up. Likewise, select the Accept All option and click the Install button.
3. Appspresso Studio Installation
Enter your e-mail address on the Download Page of the Appspresso site.
The download link of Appspresso Studio is sent to the email you have entered.
By clicking on the link that has been sent to you by email, download the Appspresso Studio into the place you desire and upzip the file.
Run the Appspresso and specify the workspace where you would save your projects.
When Appspresso is executed, Appspresso Perspective is activated.
When Appspresso is running, select the Appspresso Perspective.
(Main menu > Window > Open Perspective > Other…)
4. Preference
Select the Main Menu > Window > Preferences > Appspresso in the Windows.
In Mac, select the Main Menu > Appspresso Studio > Preferences > Appspresso.
Enter the installation path of JDK in the Java SDK Home item.
When Java SDK Home item is blank 1. Refer to advanced Prerequisites and add JAVA_HOME variable in ‘environment variable’.
Enter the Installation Path of Android SDK in the Android SDK Home items.
5. Create Project
Select the Main Menu > File > New > Appspresso Application Project.
Enter the values of other items.
Project name: The name of the project
Title: The name of the app that will be shown along with the icon.
Id: The unique identifier of the app. Follow the custom of writing the name of the domain in reverse.
Version: It’s the version of the app. In case of iOS, the app registered in the store is upgraded through increasing the value of the app. In case of Android, the purpose of this value is to show to the buyers and if you want to upgrade the app already registered in the market, you must increase the Version Code. (Refer to Tutorial)
Select the Hello World template and click the Finish button.
6. Run the Application in the Emulator.
Run the Android SDK Manager.
Select the Main Menu > Tools > Manager AVDs.
Click “New..” button of “Android Virtual Device Manager” window.
Enter the name of the virtual device, the version of the virtual Android, and the size of the virtual SD card and then click the “Create AVD” button.
In the Project Explorer view, right click on the HelloWorld Project and select the Run as.. > “Run Appspresso application on Android device” menu on the context menu.
Select the already created virtual device in the dialogue box and then click the OK button
In the virtual device, the HelloWorld app will run.
7. Running the App on the Device
Connect the Android cell phone to the USB port.
(If the Android cell phone is not recognized, you must install the driver distributed by the manufacturer).
Appspresso runs the app in the device that was used previously by default. In order to change the device the app will be used from the emulator to an Android cell phone, right click the HelloWorld Project on the Project Explorer view and then select the Run as.. > Run Configurations… menu from the context menu.
Click the select button on the Target tap and select the Android cell phone in the “Android Device List” dialogue box and then click the OK button.
Click the Run button on the Run Configurations dialogue box.
The HelloWorld app will run on the cell phone.
8. Create apk file
After right clicking on the HelloWolrd Project in the Project Explorer view, select the Export menu from the Context menu.
Select the Appspresso > Android Application(.apk file) in the Export dialogue box
If you wish to upload the app onto the Android market, you must sign it. If you enter the existing Keystore information or you may create a keystore by clicking on the New button.
Enter the path the apk file will be saved and by clicking on the Finish button, the apk file will be created in the selected path.
※ If an error occur stating that you cannot locate jarsigner, then add the environment variable PATH to the bin folder of the folder where JDK is installed.
e.g. C:\Program Files\Java\jdk1.7.0\bin
