Configuring and deploying the application in Appeon Developer

This part describes how to configure and deploy the mobile application using the Appeon Developer and run the mobile (tutorial) application in Appeon Workspace Emulator.

  1. On the Appeon Developer toolbar, click the Config Wizard () icon.

  2. In the welcome window, click Next.

  3. Do the following in the Configure basic settings window.

    1. Type tutorial as the application profile name in the Application Profile Name text box.

      The same text will be displayed in the Web Folder text box and the Mobile App Name text box. You can modify these fields to use different text.

    2. Select Mobile from the Project Type dropdown list box.

    3. Select Tablet from the Device Type dropdown list box.

      For applications that are designed for tablets, select Tablet; for applications that are designed for smartphones, select Smartphone; for applications that are designed for both devices, select Both.

    4. Click Browse next to Mobile App Icon and select an image file.

      The image will be displayed as the application icon in the Appeon Workspace. If you leave this field blank, Appeon Mobile will display the default icon for the app.

      The image file is recommended to be 172 x 172 pixels (or above) at PNG or JPG format. Appeon Mobile will automatically adjust the image to fit properly.

    5. Type the following lines as the brief description in the Mobile App Description text box.

      A sales demo listing customer information.

    6. Click Next.

    Figure 66. Appeon Developer Configuration Wizard

    Appeon Developer Configuration Wizard

  4. Do the following in the Select PBL files window:

    1. Add the tutorial.pbt by clicking the ellipsis button next to the PBT dropdown list box (and all related PBLs will be automatically added for you, if multiple PBLs are used)


      Click Add, navigate to C:\Users\Public\Documents\Appeon\Developer2015\appeondemo\AppeonMobileTutorial, (make sure the PBL Files (*.pbl) type is selected in the Files of type dropdown list box) select tutorial.pbl, and click Open to add the tutorial.pbl.

      If multiple PBLs are used in your application, you can select multiple PBLs once by using the Ctrl+click technique, and click Open to add multiple PBLs.

    2. Select PowerBuilder 12.5 from the PBL Version dropdown list box.

    3. Click Next.

    Figure 67. Add the PBT in ADT Wizard

    Add the PBT in ADT Wizard

  5. Keep the default settings and click Next.

    Since you have installed Appeon Developer and Appeon Server on the same machine, you can directly use the Local Appeon Server profile, the Local Web Server profile, and the Local Deployment profile, all of which are configured automatically by the product setup program.

    When you click Next the config wizard will automatically test the connection to the server. You will not be able to proceed if the connection test failed.

    Figure 68. Select the Appeon Server(s) and Web Server(s)

    Select the Appeon Server(s) and Web Server(s)

  6. Select and highlight the SAP ASA | UltraLite database type by checking the checkbox under the Used column, and click Next.

    The SAP ASA | UltraLite database is automatically configured (indicated with Yes under the Configured column) by Appeon for PowerBuilder during installation, so you can use it directly.

    Figure 69. Select the database type(s)

    Select the database type(s)

  7. Click Add to specify the transaction object(s) used in the tutorial application.

    Figure 70. Specify the transaction object

    Specify the transaction object

    In the Add Transaction Object window, specify the following settings:

    1. Use the default sqlca as the transaction object name in the Transaction Object text box.

    2. Select SAP ASA | UltraLite from the Database Type list box.

    3. Select Local Appeon Server from the Appeon Server dropdown list box.

    4. Select the appeonsample data source from the table.

      The data source should connect to the same database that the PowerBuilder application connects to.

      The Data Source text box will be automatically filled with appeonsample.

    5. Click OK.

      Figure 71. Add transaction object

      Add transaction object

      Tip: If you have more than one transaction object you can add additional transaction objects by repeating the above steps.

    The newly added transaction object is now listed.

    Click Next.

    Figure 72. The added transaction object is listed

    The added transaction object is listed

  8. Keep the default settings and click Next several times until you reach the Summary screen, keep the Deploy the application now option as selected and click Finish.

    Once you click Finish, the Appeon Deployment Wizard automatically starts deploying the application.

    Manually deploy an application

    To manually starts Appeon Deployment Wizard, you can click the Deploy icon () on the Appeon Developer toolbar.

  9. Click Finish and Run when the deployment process is complete.

    Figure 73. Appeon Deployment Wizard tutorial

    Appeon Deployment Wizard tutorial

  10. In the Select Project Loader window, make sure Appeon Emulator -- iPad and Landscape are selected. Click OK.

    This launches the Appeon Workspace Emulator and starts to run the tutorial application in it.

  11. In the Appeon Workspace Emulator, click the menu icon (), and then select Tutorial > Open


    Click the toolbar icon () and then click the Open icon ().

    This opens w_cusdata sheet window.

    Mobile-style title bar, menu, & toolbar

    The layout of title bar, menu and toolbar differs greatly between PB and Appeon Mobile. In Appeon Mobile, a menu icon () and a toolbar icon () are placed on the left end of the title bar. When clicked, the menu items and the toolbar buttons are displayed in a popup view. The title text is placed at the center of the title bar. On the right end of the title bar are icons for common operations for the mobile application, such as the window list icon, close app icon, home screen icon, and full screen icon.

    The layout of title bar, menu and toolbar are automatically adjusted by Appeon Mobile, to make more room for the window and controls.

    Figure 74. Application run in Appeon Workspace Emulator

    Application run in Appeon Workspace Emulator

  12. Click the Retrieve button.

    This retrieves data from the database.

    Figure 75. Data retrieved

    Data retrieved

    You can click the Insert, Delete, and/or Update buttons to insert, delete, or update the data.

    Mobile-style scroll bar

    The horizontal scroll bar and vertical scroll bar for the DataWindow control is automatically replaced with the mobile-style scroll bar, instead of the Windows-style scrollbar. The mobile-style scroll bar appears when you scroll in the DataWindow, and disappears when you stop scrolling.

  13. Click the close app icon () on the right end of the title bar. Click Yes when prompted to close the application.

  14. Click the Exit button on the Emulator Toolbar to close the Appeon Workspace Emulator.