Tiggzi Docs > Documentation > App Builder > Exporting the app

Exporting the app

Tiggzi makes it very easy to export app source code or get a binary file for Android, iOS and Windows Phone. To see the export options, click Export button in the top menu:

Mobile web

To download the app as mobile web, select HTML/JS/CSS button. You can select any of the buttons under Web resources.

Android

For Android, you have a couple of options:

  • HTML/CSS/JS - this is basically mobile Web app
  • Eclipse project (source code) - you will get HTML/CSS/JS + PhoneGap library configred as an Eclipse project. Learn how to open the project in Eclipse.
  • Debug binary (.apk) - you will get a binary Android file (with PhoneGap). This app version can be installed only on the device directly. This file cannot be published to the Android App Market as it’s missing Android market meta data.
  • Release binary (.apk) - this Android binary version can be published to the Android App Market (with PhoneGap).

Android binary properties

Before you can publish apps to Google Play Market, you will need to pay $25 registration free.

To make it possible to generate an Android release binary version of the app, Tiggzi comes with a special editor that lets you enter and edit all necessary Android .apk properties to prepare it for the Android Market. To open the editor, Project view > Project > App settings > Android binary APK properties. The editor looks like this:

iOS

For iOS, you have a couple of options:

  • HTML/CSS/JS - this is basically mobile Web app
  • xCode project (source code) - you will get HTML/CSS/JS + PhoneGap library configred as an xCode project.
  • Release binary (.api) - this iOS binary version can be published to Apple App store

What you need to build a binary IPA file

Before you build the binary file, make sure you have the following

  • Apple certificate (***.p12)
  • Apple provision profile (***.provision)
  • Bundle ID (com.company.***) - you can find it in your Apple certificate

iOS binary properties

Before you can build an iOS binary, you will need to sign up for iOS Developer Program and then provide all developer information and certificates below. If you are new to this, here are some very good links to get you started:

Building and running iOS app on a mobile device

What you need before you start

  • Mac OS X 10.6.8
  • Xcode 4.2 with iOS SDK installed.
  • You should be enrolled to the iOS development program and have correct pair of the developer (or distribution) certificate and provisioning profile. You can get Xcode, iOS SDK, certificates and profiles from the http://developer.apple.com . Please refer to the corresponding documentation from Apple.

Run Tiggzi app in iOS Simulator

If you want to run Tiggzi app in the iOS Simulator, you have to perform the following steps:

  1. Open [app_name].xcodeproj with the Xcode.
  2. Select correct scheme to run: [app_name] > iPhone 5.0 Silmulator or [app_name] > iPad 5.0 Simulator in the top-left part of the Xcode window.
  3. Click Run button in the top-left corner of the Xcode window (MultPhoneGap is the app name):

After this, you should see running iOS Simulator and Tiggzi app launched.

Run Tiggzi app on iOS device (iPhone, iPad)

Running Tiggzi app on the iOS device is more involved procedure than running it on the simulator (it’s all Apple). Note that steps #1 and #2 are option if you have already completed them for a different app.

  1. Add the certificate to the keychain. Double-click on the .cer-file and confirm adding the certificate. You can see the certificate in the keychain window (shown below).
    1. Repeat the same steps for the Distribution certificate
  2. You have to add the provisioning profile to the Xcode Organizer and to the iOS device.
    1. Go to the Xcode menu: Window > Organizer.
    2. Select Devices icon on the top bar. Left panel shows all devices ever added to organizer. Connected device will be checked with green dot.
    3. Select device and open it.
    4. Select Provisioning profiles item in the list.
    5. On the bottom of the window you can find Add button. Click it and add your provisioning profile to the device:
    6. It is recommended to add your profile to the Organizer > Library > Provisioning Profiles (on the left panel).Note: Make a note of App Identifier in the provisioning profile. This parameter contains the mask for the allowed bundle identifiers (see the step #9 for the details).
  3. Open the [app_name].xcodeproj with Xcode.
  4. Select the [app_name] project file on the top of the project navigator:
  5. Select Build Settings tab and proceed to the Code Signing section (MultPhoneGap is the app name):
  6. Find Code Signing Identity group and open it. If you use the app source code you built and exported from Tiggzi, there should be 2 sub items - Debug and Release.
    1. If you use Tiggzi Mobile Tester there should be 3 sub items – AdHoc, Debug and Release as shown below:
  7. Different certificates can be used for different purpose
    1. If you have developer’s certificate, you should ensure that the values for Debug > Any iOS SDK and Release > Any iOS SDK are set to your developer’s certificate (Recommended behavior is: there should be set the iPhone Developer value, which means automatic profile selection. But you can click on the value and see the actual certificate and profile which will be used by Xcode for code signing):
    2. If you have distribution certificate, you should ensure that the value for AdHoc > Any iOS SDK is set to your distribution certificate (Recommended behavior is: there should be set the iPhone Distribution value, which means automatic profile selection. But you can click on this value to see the actual certificate and profile which will be used by Xcode for code signing).
  8. Select the Resources > [app_name]-Info.plist file in the project navigator
  9. Find the Bundle identifier parameter and set its value to the value which corresponds to allowed application identifiers for your provisioning profile:
  10. Select correct scheme to run: [app_name] > [Your connected device's name]
  11. Click Run button in the top-left corner of the Xcode window:

Common problems

If you are getting:

“warning: iPhone/iPod Touch: application executable is missing a required architecture. At least one of the following architecture(s) must be present: armv6”

error when trying to build, go to Architectures and hit the “+” in the window to add “armv6” below (current ARCHS = “armv7″

Windows Phone

For Windows Phone, you have a couple of options:

  • HTML/CSS/JS - this is basically mobile Web app
  • VS project (Visual Studio project source code) - you will get HTML/CSS/JS + PhoneGap library configured as an Visual Studio project.

We are working on binary build for Windows Phone. For now you have two options:

Other Platforms

Right now all the HTML/JS/CSS buttons under Web resources will download the same files.

Guidelines on Getting Your PhoneGap App Approved by Apple

Some Guidelines on Getting Your PhoneGap App Approved by Apple