howto_ionic client generation

Table of Contents

• Ionic client generation
  • Prerequisites
  • Generation
  • Running it on Android

Ionic client generation

We are going to show you how to generate a CRUD Ionic application from an ETO using CobiGen.

Note	This is a short introduction to the Ionic generation. For a deeper tutorial including the generation of the backend, we strongly recommend you to follow this document.

Prerequisites

Before starting, make sure you already have in your computer:

• Ionic: by following the steps defined on that page. It includes installing:

  • NodeJS: We have to use "NPM" for downloading packages.

  • Ionic CLI.

• Capacitor: Necessary to access to native device features.

If CobiGen_Templates are not already downloaded, follow the next steps:

• Right click on any file of your workspace CobiGen > Update Templates and now you are able to start the generation.

• If you want to adapt them, click Adapt Templates and you should have the CobiGen_Templates as a new project in Eclipse’s workspace.

After following those steps correctly, you should have the latest version of the templates ready to use.

Generation

We are going to generate the CRUD into a sample application that we have developed for testing this functionality. It is present on your workspaces/examples folder (devon4ng-ionic-application-template). If you do not see it, you can clone or download it from here.

After having that sample app, please create an devon4j project and then start implementing the ETO: You will find an example here.

As you can see, TableEto contains 3 attributes: 2 of them are Long and the third one TableState is an enum that you will find here. The Ionic generation works fine for any Java primitive attribute (Strings, floats, chars, boolean…​) and enums. However, if you want to use your own objects, you should override the toString() method, as explained here.

The attributes explained above will be used for generating a page that shows a list. Each item of that list will show the values of those attributes.

For generating the files:

• Right click your ETO file and click on CobiGen > Generate as shown on the figure below.

• Select the Ionic increments for generating as shown below. Increments group a set of templates for generating different projects.

  1. Ionic List used for generating the page containing the list.

  2. Ionic devon4ng environments is for stating the server path.

  3. Ionic i18n used for generating the different language translations for the translationService (currently English and Spanish).

  4. Ionic routing adds an app-routing.module.ts file to allow navigation similar to the one available in Angular.

  5. Ionic theme generates the variables.scss file which contains variables to style the application.

Note

By default, the generated files will be placed inside "devon4ng-ionic-application-template", next to the root of your project’s folder. See the image below to know where they are generated. For changing the generation path and the name of the application go to CobiGen_Templates/crud_ionic_client_app/cobigen.properties.

Now that we have generated the files, lets start testing them:

• First change the SERVER_URL of your application. For doing that, modify src/environments/environments.ts, also modify src/environments/environments.android.ts (android) and src/environments/environments.prod.ts (production) if you want to test in different environments.

• Check that there are no duplicated imports. Sometimes there are duplicated imports in src/app/app.module.ts. This happens because the merger of CobiGen prefers to duplicate rather than to delete.

• Run npm install to install all the required dependencies.

• Run `ionic serve on your console.

After following all these steps your application should start. However, remember that you will need your server to be running for access to the list page.

Running it on Android

To run the application in an android emulated device, it is necessary to have Android Studio and Android SDK. After its installation, the following commands have to be run on your console:

• npx cap init "name-for-the-app (between quotes)" "id-for-the-app (between quotes)"

• ionic build --configuration=android. To use this command, you must add an android build configuration at angular.json

  "build": {
    ...
    "configurations": {
      ...
      "android": {
        "fileReplacements": [
          {
            "replace": "src/environments/environment.ts",
            "with": "src/environments/environment.android.ts"
          }
        ]
      },
    }
  }

• npx cap add android

• npx cap copy

• npx cap open android

The last steps are done in Android studio: make the project, make the app, build and APK and run in a device.