PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
New WINDEV Mobile 24 feature!
  • This lesson will teach you the following concepts
  • Overview
  • Generating the Android application
  • Generating the iOS application
  • Transfer the WINDEV Mobile project onto Mac
  • Compiling the project in Xcode
Lesson 5.6. Deploying the application
This lesson will teach you the following concepts
  • Generating the Android application.
  • Generating the iOS application.

Estimated time: 20 mn
Previous LessonTable of contentsNext Lesson
Overview
That's it, our application is created, we must now compile it and install it on the device in order to run its test.
If you have chosen to develop the application for Android only, you can follow the generation of Android application.
If you have chosen to develop the application for iOS, go to "Generating the iOS application".
If you want to develop the application for the two platforms, follow the generation for Android then the generation for iOS.
Generating the Android application
  • To generate the Android application:
    1. Select (if necessary) the Android platform in the project explorer.
    2. On the "Project" pane, in the "Generation" group, click "Generate" (you also have the ability to click among the quick access buttons).
    3. The wizard for generating an Android application starts.
    4. The first wizard step consists in checking the tools required to generate the Android application.
      The wizard proposes to:
      • Download and automatically install the Android SDK and Gradle: in this case, you will only have to validate the license. WINDEV Mobile takes care of everything. If an update is available, the generation wizard will automatically propose to perform the necessary updates. Only an Internet connection is required.
      • Use the tools automatically installed. This option is available if the tools have been downloaded and installed during a previous generation.
      • Specify the location of tools already installed on your computer. In this case, all you have to do is specify the setup paths of Gradle and Android SDK.
    5. Select the option corresponding to your configuration and go to the next step.
      Note: If you have chosen to download and install the tools, going to the next step may be quite long and you may have to validate the license.
    6. Go to the next step by clicking the arrow keys at the bottom of wizard. The next wizard step is used to:
      • define the application name (displayed below the icon used to start the application) and the corresponding package.
      • select the application icon in the image catalog of WINDEV Mobile ("stock" in the "Flat Soft" theme for example).
      • define the email address used by default to send an error report if necessary.
    7. Go to the next step. This step is used to define:
      • the splash screen of application,
      • the information saved in the manifest,
      • the start mode of application (when starting the device or not).
    8. Go to the next step. The wizard is used to define the version number of application.
    9. Go to the next step. This step is used to sign the application. The wizard proposes a generic signature that can be used for the application tests. A specific signature is required to distribute the application.
      See Generating an application for Android for more details.
    10. The next step is used to include the data files in the application. For our example, pre-filled HFSQL data files are available. They will be supplied with the application. In this case, they must be specified in the "Integrating files" step
      • Click the "Add" button.
      • Select the data files (.fic, .ndx and .mmo) found in the "EXE\Android application" directory of project. The list of files is displayed.

        Note

        If your project is using the Android platform only, the files must be selected in the EXE directory of project.
    11. Check the "Write" box for each file (required to be able to modify data from the application).
    12. Go to the next step.
    13. Validate the other steps until you reach the "Configuration" step that is used to configure the options of Android SDK and the setup location.
    14. Go to the next step.
    15. This step is specific to the use of Map control. It is used to enter the key required to use the Map control. If you own a Google Maps API key, type it. Otherwise, click "Get a key".
    16. Go to the next step.
    17. End the wizard. The generation is automatically performed in background task. The icon indicates that the generation is in progress.
    18. When the generation is ended, a popup window is displayed in the editor:
    19. To copy and run the application on the device linked to the computer or on an emulator, click "Deploy".
    20. A new window is displayed, allowing you to select the runtime device. If you own an Android device connected to the development computer, select the device connected to the PC.

Note

If the device is not connected to the development computer, you must:
  1. Connect the device to the development computer.
  2. In the explorer, open the generation directory of apk file corresponding to the Android application.
  3. Copy the apk file into the "Download" directory of device.
  4. Unplug the device.
  5. Start the application for file management on the device.
  6. Go to the "Download" directory and run the apk file. The application is automatically installed.
Generating the iOS application
  • To generate the iOS application:
    1. Select (if necessary) the iOS platform via the project explorer.
    2. On the "Project" pane, in the "Generation" group, click "Generate" (you also have the ability to click among the quick access buttons).
    3. The wizard for generating an iOS application starts.
    4. The wizard is used to:
      • define the application name, the company and the copyright.
      • enter the bundle identifier.

        Note

        This identifier is the unique identifier of your application beside Apple. It is defined and saved on the Apple developer account.
        This identifier will be used to save your application in order to run its test and to deploy it. By default, WINDEV Mobile automatically proposes an identifier that respects the development standard of Apple. This identifier can be modified.
      • define the email address used by default to send an error report if necessary.
    5. Go to the next step.
    6. You have the ability to specify the path of different application icons for each type of device.
    7. Go to the next step.
    8. Specify the characteristics of the splash screen.
    9. Go to the next step.
    10. Specify the version number of the generated application.
    11. Go to the next step.
    12. This step is used to include specific files (data files, images, ...).
      • Click the "Add" button.
      • Select the data files (.fic, .ndx and .mmo) found in the "EXE\iOS application" directory of project. The list of files is displayed.
    13. Indicate that these data files must be in write mode: check the "Write" box.
    14. Go to the next step.
    15. The wizard allows you to specify:
      • whether the application is allowed to be resized or not (Split View). The option allows the end user to display two windows of two different applications side by side on some devices.
      • whether files can be shared with iTunes. If this option is checked, you will have the ability to retrieve the application files on Mac during the synchronization. For example, if data files have been supplied with the application, the iTunes application will allow you to retrieve these files.
      • the minimum version of iOS required to run the application.
    16. Go to the next step. This step is used to specify the signature options for Xcode 8.
      See Signature of iOS applications for more details.
    17. Validate the wizard.
    18. The generation is performed in the EXE folder of project directory. The directory containing the source code that will be used on Mac is named "Project_name.xcode.gen" ("WM Managing Products.xcode.gen" in our example). This is the directory that must be copied onto Mac. Click the "Open the generation directory" button.
The other operations must be performed on Mac. You must:
  • Transfer the WINDEV Mobile project onto Mac.
  • Compile the project in Xcode.

Transfer the WINDEV Mobile project onto Mac

  • To transfer the WINDEV Mobile project onto Mac:
    1. Copy the entire folder generated in the EXE directory onto an external media (USB key, external hard disk, shared directory with Mac on network). This directory is named <Project Name>.xcode.gen.
    2. Paste this folder on the Mac that will compile the application.
    3. Open the folder on Mac and open the file named "Project_name.xcodeproj".
    4. The project is opened in Xcode.

Compiling the project in Xcode

WINDEV Mobile automatically generates an Xcode project for your iOS compilations. To simplify the implementation of applications, WINDEV Mobile generates a "Scheme" for Xcode.
  • To compile the project in Xcode:
    1. In the drop-down list found in the top left corner, select the compilation options. Select the scheme corresponding to your application then the compilation target (device currently connected or a simulator).
    2. To start the compilation, select "Product .. Clean" then "Product .. Build".
    3. A status report of compilation is displayed at the top ("Succeeded", otherwise the number of warnings and errors). You have the ability to click these symbols to see the list of errors/warnings.
    4. Once the program is compiled without error, you can start the simulation ("Product .. Run"). The simulation window appears with the application.
Then, you have the ability to run the test of your application on your iPhone or iPad.
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment