Packaging instructions

To package an Xcode project or an Android application package (APK) file, follow the steps below:

Step 1: Click the Package () button on the Appeon Developer toolbar to open the Appeon Application Package Wizard.

Step 2: Select or create a profile from the dropdown list box and click Next to proceed.

A profile is a configuration file containing the settings that you specify when packaging the application. You can select an existing profile or create one by entering a name in the text field. The profile will be automatically saved and listed for selection next time when you launch the Appeon Application Package Wizard again.

Figure 131. Welcome page

Welcome page

Step 3: Select the Package a Stand-alone Mobile Project radio button.

To package a deployment project that can deploy the application to servers, select Package a Server Deployment Project and follow detailed instructions in Packaging a server deployment project.

To customize Appeon Workspace and then package Appeon Workspace to a standalone application, select Customize and Package Appeon Workspace and follow detailed instructions in Customizing and packaging Appeon Workspace.

Figure 132. Select package type

Select package type

Step 4: Select the profile of the application that you want to package and click Next.

Only applications that have been deployed will be listed here for selection. If the application you intend to package is not listed here, you would need to deploy the target application using the Appeon Deployment Wizard first (See Deploying PowerBuilder Applications).

Figure 133. Select apps to be packaged

Select apps to be packaged

The following table gives a brief introduction to the columns:

Table 37. Application Package Wizard

Column

Description

Selected

Identical to the default application profile selected in the Appeon Developer Configuration window.

Profile Name

Identical to the application profiles configured in the Appeon Developer Configuration window.

Mode

Identical to the current mode the application profile is set to in the Appeon Developer Configuration window.

It is recommended that the packaged applications should be available in Release mode, as this mode prevents most forms of reverse engineering, and like application packaging, it protects the author's intellectual property.

Device Type

Identical to the current device type settings in the Appeon Developer Configuration window.


Step 5: Select the device type (iOS or Android) on which the application will run after packaged and then click Next.

Figure 134. Select a target device type

Select a target device type

Step 6: Specify the parameters according to the device type and then click Next.

  • For apps running on iOS, specify the parameter according to the following table.

    Figure 135. Configure parameters for the Xcode project

    Configure parameters for the Xcode project

    Table 38. Parameters for the Xcode project

    Group

    Value

    Description

    General

    App Name (Required)

    Specify the name of your app that will appear in the Apple App Store.

    For the name to be displayed completely, it should be about 12 letters but it depends on the width of each individual letter, for example, w takes more room than i.

    The App Name will also be used as the name of the generated package.

    App Description

    Provide the description of your app that will appear in the screen under iOS Settings > App Name after the app is installed on the iOS-based device.

    App URL (Required)

    Specify the URL to the mobile application that is deployed to the Appeon Server, for example, http://192.0.0.201/sales. For more information, see URLs of Appeon applications.

    The URL supports both HTTP and HTTPS formats, for example, https://192.0.0.201/sales.

    The URL can be changed in the screen under iOS Settings > App Name after the app is installed on the iOS-based device.

    Apple ID (Required)

    Specify the developer's Apple ID, and it must be the same Apple ID used in the provisioning profile for building the Xcode project later. By default, the Apple ID you input last time is displayed automatically.

    Keep the developer's Apple ID consistent for different apps, so that these different apps running on the same mobile device can be recognized as running on one device, not on multiple devices by the Appeon license file. For details on the Device control type in the Appeon license file, refer to the section called “Product Activation” in Appeon Server Configuration Guide for .NET or in Appeon Server Configuration Guide for J2EE.

    Startup Orientation

    Set the initial interface orientation when the app starts.

    SSL Verify Peer

    Enable or disable the SSL peer verification.

    SSL Verify Host

    Enable or disable the SSL host name verification.

    Connection Timeout (seconds)

    Specify the timeout seconds for your app connecting to the server.

    Record Logs

    Set whether to record app logs.

    Titlebar Icons

    Full Screen by Default

    Whether to display the app in full screen view (with the titlebar hidden) by default when it is opened. In the full scree view, the normal view icon will be available on the top right corner of the window, and when it is tapped, the application will return to the normal view (with the titlebar visible).

    Xcode

    App Major Version

    Specify the version number for your app.

    App Build No.

    Specify the build number for your app.

    Xcode Version

    Select the Xcode version which will be used to compile the application. By default, 5 or the version number you selected last time is selected.

    It is recommended that the latest version of Xcode should be installed and used, so that the compiled application can support up to the latest iOS platform. For example, application compiled by Xcode 5.1 or above can run on iOS 7.1 and earlier platforms, application compiled by Xcode 5.0.2 can only run on iOS 7 and earlier platforms, and applications compiled by Xcode 4.x can only run on iOS 6.x and earlier platforms.

    App Icon

    iPhone Standard Display (iOS 6.1 or earlier)

    Specify the app icon for the standard display on iPhone (57 x 57 pixels).

    iPhone Retina Display (iOS 6.1 or earlier)

    Specify the app icon for the retina display on iPhone (114 x 114 pixels).

    iPhone Retina Display (Xcode 5 only)

    Specify the app icon for the retina display on iPhone (120 x 120 pixels).

    iPad Standard Display (iOS 6.1 or earlier)

    Specify the app icon for the standard display on iPad (72 x 72 pixels).

    iPad Retina Display (iOS 6.1 or earlier)

    Specify the app icon for the retina display on iPad (144 x 144 pixels).

    iPad Standard Display (Xcode 5 only)

    Specify the app icon for the standard display on iPad (76 x 76 pixels).

    iPad Retina Display (Xcode 5 only)

    Specify the app icon for the retina display on iPad (152 x 152 pixels).

    Launch Image

    iPhone 4 Standard Display

    Specify the launch image for the standard display on iPhone 4 (320 x 480 pixels).

    iPhone 4 Retina Display

    Specify the launch image for the retina display on iPhone 4 (640 x 960 pixels).

    iPhone 5

    Specify the launch image for the retina display on iPhone 5 (640 x 1136 pixels).

    iPad Standard Display in Landscape

    Specify the launch image for the standard display in landscape on iPad (1024 x 768 pixels).

    iPad Standard Display in Portrait

    Specify the launch image for the standard display in portrait on iPad (768 x 1024 pixels).

    iPad Retina Display in Landscape

    Specify the launch image for the retina display in landscape on iPad (2048 x 1536 pixels).

    iPad Retina Display in Portrait

    Specify the launch image for the retina display in portrait on iPad (1536 x 2048 pixels).

    Spotlight Icon

    iPhone Standard Display (iOS 6.1 or earlier and Xcode 5 only)

    Specify the app spotlight icon for the standard display on iPhone (29 x 29 pixels).

    iPhone Retina Display (iOS 6.1 or earlier and Xcode 5 only)

    Specify the app spotlight icon for the retina display on iPhone (58 x 58 pixels).

    iPhone Retina Display (Xcode 5 only)

    Specify the app spotlight icon for the retina display on iPhone (80 x 80 pixels).

    iPad Standard Display (iOS 6.1 or earlier and Xcode 5 only)

    Specify the app spotlight icon for the standard display on iPad (50 x 50 pixels).

    iPad Retina Display (iOS 6.1 or earlier and Xcode 5 only)

    Specify the app spotlight icon for the retina display on iPad (100 x 100 pixels).

    iPad Standard Display (Xcode 5 only)

    Specify the app spotlight icon for the standard display on iPad (40 x 40 pixels).

    iPad Retina Display (Xcode 5 only)

    Specify the app spotlight icon for the retina display on iPad (80 x 80 pixels).


  • For apps running on Android, specify the parameter according to the following table.

    Figure 136. Configure parameters for the Android APK file

    Configure parameters for the Android APK file

    Table 39. Parameters for the Android APK file

    Group

    Value

    Description

    General

    App Name (Required)

    Specify the name of your app that will appear in the Android marketplace.

    The App Name will also be used as the name of the generated package.

    App URL (Required)

    Specify the URL to the mobile application that is deployed to the Appeon Server, for example, http://192.0.0.201/sales. For more information, see URLs of Appeon applications.

    The URL supports both HTTP and HTTPS formats, for example, https://192.0.0.201/sales.

    App Identifier (Required)

    Specify the identifier for the app(s).

    This field is used to identify the app and can only contain letters, or a combination of letters with dots, and/or numbers without spaces (for example, com.appeon.sales), but cannot start or end with dots and contain numbers between dots. When an app is to be installed on a device where another app with the same identifier has already been installed, the installation will fail.

    SSL Verify Peer

    Enable or disable the SSL peer verification.

    SSL Verify Host

    Enable or disable the SSL host name verification.

    Connection Timeout (seconds)

    Specify the timeout seconds for your app connecting to the server.

    Record Logs

    Set whether to record app logs.

    APK Project

    Delete project after packaged

    Whether to delete the APK project after the app is packaged.

    If not, there will be an App Name folder under ...\Developer2013R2\AppTemplate\Android\NativeConfig\.

    App Signing

    Alias (Required)

    Enter the alias name for key.

    Only the first 8 characters of the alias name are used.

    You can use the default alias name generated by Appeon (which is appeon) or use your own name. If you use the default keystore file in the Directory field, you need to keep this field as default.

    Alias Password

    Enter the key password.

    You can use the default alias password generated by Appeon (which is appeon) or use your own password. If you use the default keystore file in the Directory field, you need to keep this field as default.

    Directory (Required)

    Click the browse button (...) to select the keystore file.

    You can use the default keystore file or click the browse button to select your own one.

    For how to create the keystore file, refer to Preparations for the Android package.

    Keystore Password

    Enter the keystore password.

    You can use the default keystore password generated by Appeon (which is appeon) or use your own password. If you use the default keystore file in the Directory field, you need to keep this field as default.

    Titlebar Icons

    Full Screen by Default

    Whether to display the app in full screen view (with the titlebar hidden) by default when it is opened. In the full scree view, the normal view icon will be available on the top right corner of the window, and when it is tapped, the application will return to the normal view (with the titlebar visible).

    App Icon (in PNG format)

    App Icon in Google Play

    Specify the app icon displayed in Google Play (512 x 512 pixels).

    App Icon for MDPI Screen

    Specify the app icon for MDPI (~160 DPI) device screens (48 x 48 pixels).

    App Icon for HDPI Screen

    Specify the app icon for HDPI (~240 DPI) device screens (72 x 72 pixels).

    App Icon for XHDPI Screen

    Specify the app icon for XHDPI (~480 DPI) device screens (96 x 96 pixels).

    App Icon for XXHDPI Screen

    Specify the app icon for XXHDPI (~640 DPI) device screens (144 x 144 pixels).

    Splash Image

    Splash Image in Landscape

    Specify the splash image in landscape for the app.

    The recommended size is 1024 x 768 pixels, and the tool will stretch or compress the images to accommodate various heights and widths.

    Splash Image in Portrait

    Specify the splash image in portrait for the app.

    The recommended size is 768 x 1024 pixels, and the tool will stretch or compress the images to accommodate various heights and widths.


Step 7: Specify the storage location for the package and click Next.

  • For iOS, the generated package will be stored under a folder named "App Name_install_XcodeX" (The second "X" in XcodeX indicates the Xcode version number, for example, Sales Demo_install_Xcode5.0) under the specified location.

  • For Android, the generated package will be stored under a folder named "App Name_install_Android" (for example, Sales Demo_install_Android) under the specified location.

Figure 137. Specify directory

Specify directory

Step 8: Wait until the package process is complete.

Figure 138. Package process

Package process

Step 9: Click Finish when the package process is complete.

If the package log reports the error "Failed to build the native mobile app" when creating the Android APK file, you may try the solution in the section called “"Failed to build the native mobile app" error when creating the Android APK package” in Appeon Troubleshooting Guide.

Figure 139. Package complete

Package complete

Step 10: Go to the folder "App Name_install_X" (X indicates the suffix XcodeX or Android) under the specified location.