Tag: iiziApp

Distribution of your iiziApp

Distribution of your iiziApp

Note: This option is not yet available for the early access.

Your iizi project can be built and deployed to your server through the Distribution option under ‘iizi’ found in your project’s properties.

The developed iiziApp can consist of Module projects and Java projects. It can also refer to libraries and directories containing Java code, both project-based and external. In order to run the application on an iizi Server, the iiziApp must be compiled into a Jar file. The iiziApp compiled into a Jar file is called an Application Distribution. The process of creating this Jar file is called Application Distributor.

The Application Distributor is a utility that is integrated in iiziGo but is also available as a stand-alone Java program that you can run from a batch file or a build system, e.g. Ant.

Configuration

The Application Distributor must first be configured for a Module project to be distributed. Open the Module project properties dialog and select Enable Application Distribution:

Fill in the Jar file name. If the iiziApp consists of several modules projects, specify them in a comma separated list in Include Modules. Dependent modules and Java project, libraries and directories are always added to the Jar file, with the exception of externals that provides a separate option for the operation to perform.

Dependent modules are known at build time of the distribution when all references are resolved. All the referenced modules (including their references) will therefore be included in the iiziApp. Dependent Java projects, libraries and directories are known from the Java Build Path.

Externals

The Externals are external libraries and directories that may be specified in the projects classpaths of the Java Build Path.

If you do not include externals, the Jar file will be smaller and if several module applications share the same externals, you will use less memory for the server because it will only be loaded once. However, the externals must be in the server classpath.

Note: Be careful with this option, as the same class may from a library or a directory can be loaded several times from different iiziApp’s, and each class static (instance) will not be same between two iiziApp’s (meaning that there can be multiple “static singletons”). If this could be the case, you will have to unselect the option Include externals and to set the classpath of the server to include these externals.

Exporting iiziApp

The iiziApp is created by exporting the Module project. Open the Export Wizard using File → Export:

Click on Next and select the project to create a distribution for:

Only projects configured for application distribution are shown above.

When you press Finish, the Application Distributor will be started in a separate Eclipse job.

Note: An application containing errors and/or warnings cannot be exported!

iiziRun Custom

iiziRun Custom

To finally release an iiziRun Custom app that is branded for use with your new application and for submission to the App Store, Google Play, and the Microsoft Store, you will use the iiziRun Builder utility integrated into the iiziGo IDE. The resulting mobile app is given a custom graphical appearance to represent your software’s branding and meant to be downloaded by the consumer of your application.

The difficult process of submitting to the App Store, Google Play and the Microsoft Store is automated for you in the iiziRun Builder workspace where you prepare the explicit build requirements for each.

By right-clicking your project and choosing properties and expanding the ‘iizi’ option, you will find three further options ‘App’, ‘Distribution’ and ‘Runtime. Choose ‘Runtime’ to display the iiziRun Builder instructions and forms necessary for the creation of your iiziRun Custom app.

The instructions and forms under Runtime for enabling iiziRun Builder

This iiziRun Custom instance carrying your application branding will be submitted only once to each mobile app distributor i.e. the App Store, Google Play, and the Microsoft Store. All further versioning and updating of your application will be made to the iiziApp that has been deployed to your production server.

Location of code

Location of code

The application code can reside in Module projects, Java projects, libraries and directories. When the application distribution is created, it is packed into a single iiziApp using the Application Distributor, see separate chapter.

Java code plays an important role in for an iiziApp. To build application logic into the iiziApp, it needs to refer to various parts. All references to iizi elements are done using a reference name that looks like “module:/path/name”. This reference can have the module defined as “.” to refer to the current project where the Java code resides.

Connect devices for Live preview

Connect devices for Live preview

As you develop your iiziApp, you can update and view instantly on connected devices with iiziRun Developer mobile app. In addition to the live updates in Design Editor, you can connect as many devices as you wish for viewing and testing your Java code, UI Components or any other app functionality as you develop.

Set up iiziServer for live development

To use the iiziServer included in iizi, minimal server configuration is required.

  • Choose the menu item ‘Run > Run configuration’, select and press  to create a ‘New Launch Configuration’.
  • Fill in the Name to e.g. iizi Development Server and enter the File name for the server configuration that is required.

When your iiziServer has been configured and is running in iiziGo:

  • Download iiziRun Developer from the App Store and Google Play for free.
  • Open iiziRun Developer to ‘Open a Panel’ or ‘Add application’.

Design viewer

Test your designs and code in real-time on any device. To access the iizi Design Viewer, click on  in the toolbar above the Design Editor for a desktop viewer and download the iiziRun Developer app for a phone and tablet viewer on a real device.

In iiziRun Developer:

  • Click ‘Open Panel’, then select ‘iiziGo instance’ or add your iiziGo by entering your DNS computer name and the default port 2800, make sure ‘Secure’ is off.

Choose the language and theme (for now, only iOS is available).

  • Enter the ‘address’ of the iiziGo machine. The ‘address’ can be either a DNS name (recommended) or an IP address.
  • Launch the app and see how the app simultaneously adapts when changes are made in iiziGo.
  

Tip: On the main screen of iiziRun Developer, you can choose another language for the panel to display, e.g. in Russian or Chinese (all texts are translated automatically without checking in the panels below).

 

If you see the little  sign next to the panel name, you can choose language to display in the opened panel (of course, this requires that you app is configured for multiple languages).

Tip: To quickly restart iiziRun Developer, touch the screen with 5 fingers at the same time, and you will get a message box about restarting.

Test your iiziApp live

After having created your iiziApp and configured the iiziServer – this will enable you to test your iiziApp in real-time and on any device to get a look and feel of the app.

    • Tap “Add Application”, then select ‘Server’ and tap ‘Add Server’.
    • Add your computer’s local IP or local network IP and type port 8080.
    • Click the blue ‘Save’ icon at the top.
    • Upon tapping ‘Application’, select your current iiziApp and click the blue “Save” icon.
    • Click on your iiziApp and select ‘Launch’.
    • Your iiziApp is ready to use!
  • Repeat the above process for any phone or tablet you wish to use for development and testing.
  
Adding a New Server, selecting Application, then the launched app, in this case ServerAdmin.

Again, use your 5 fingers and touch the display to restart iiziRun Developer if you wish to perform some other operation.

Create your iiziApp

Create your iiziApp

The iiziGo environment makes it possible to develop iiziApps from either the UI side-first, or the data provider-first, or Java code-first, or any combination of these techniques. Your iiziGo allows both mobile-first or desktop browser oriented development. UI designers and UX professionals can also use the iiziGo to create the user interface without programming expert skills.

Creating your first iiziApp

How to create iiziProfile wizard helps you to create the base for your first iiziApp.

 
The iiziGo project Quickstart followed by multi-language Text table for you project.
  • Enter your Project name.
  • Tick the device types you want: Phone, Tablet, Desktop.
  • If you wish to target multiple languages, leave the tick to ‘Create text tables with automatic translation’.
  • Choose the target languages by typing in the language code or by filtering the languages and click “Add”. The first language specified is the base language, i.e. the language you intend to use when you develop the application. When you use automatic translation, English (en) is recommended as Google Translate or Microsoft Azure Cognitive Service to translation gives the best result as it translates accurately.
  • Click “Finish” and you’re ready to go!

Creating a new iiziApp

  • Right click in Project Manager and choose ‘New > Project’.
  • Under ‘iizi’, choose to create a ‘New iizi Module Project’ in Quickstart mode.

Alternatively,

  • Choose in the main Eclipse Menu Bar ‘File > New’ or type Alt + f.
  • Select ‘New iizi Module Project’ in Quickstart mode.

After the New iizi Module Project Wizard is open, repeat the instructions as explained in the section above Creating your first iiziApp.

Module project and Project properties

Your new project is referred to as an iiziApp or/and iizi Module Project.

Your new iiziApp will appear in the iizi Explorer with the project’s folder structure already created for you.

Inside the VirtualSpaces folder you will find a default VirtualSpace named ‘mainVirtualSpace’.

The Panels package contains folders and a ‘mainPanel’ for each device: one for phone, tablet and desktop.

The iizi Explorer is used instead of the Eclipse Package Explorer because it is tailored for the iizi Platform. If you choose to enable additional connector plug-ins, there will be additional folders displayed in the iizi Explorer for the respective connector.

Application properties

By creating your new iiziApp through Quickstart, your project will have default initial-focus which indicates the Panel that will open first when your application launches.

  • Right-click your project and choose ‘Properties > iizi > App’ to find iiziApp Application Properties.
  • Further global application settings can be found at ‘Windows > Preferences > iizi’.
Social media & sharing icons powered by UltimatelySocial

By continuing to use the site, you agree to the use of cookies. more information

The cookie settings on this website are set to "allow cookies" to give you the best browsing experience possible. If you continue to use this website without changing your cookie settings or you click "Accept" below then you are consenting to this.

Close