Category: Getting started

Installing iiziGo under Windows

Installing iiziGo under Windows

The Windows installation generally requires Administrator’s privileges on the machine.

If you have a Java JDK 8 Update 151 or better, you can download and install the iiziGoSetup-1.0.0.12345.exe executable Windows Installer, otherwise choose iiziGoSetupJDK-1.0.0.12345.exe (numbered with a version number followed by a build revision number). Please note that a Java JRE is not sufficient as some tools in the Java JDK are used by iiziGo.

Under Windows 10, Windows Smart Screen often blocks the installer executable. Press “More info” followed by “Run anyway”.

Follow the installer wizard. At the end, choose to “Launch iiziGo”.

When iiziGo starts and the built-in web server opens the port, Windows Firewall could prompt you to allow javaw.exe to communicate over the network.

Important information about Anti-Virus

During installation and launch of iiziGo, some anti-virus software blocks Java Development Kit executables that are vital to running iiziGo. The files are typically javaw.exe and java.exe, but can also be iiziGo.exe. If you encounter an anti-virus warning or error to e.g. quarantine or remove those files, please reply No or Add an exception for them depending on your anti/virus software. These files are the original files from 64-bit version of Oracle Java Development Kit version 8.

You might have to create exceptions for the executables “iiziGo.exe”, “java.exe” (used by iiziGo when running the app in the iiziServer) and “javaw.exe” (used by Eclipse).

Getting Started

When iiziGo starts the first time, you register with the iizi License System and iizi Reward kick-back program. You will also receive your unique Developer ID that is tied to your email address. You will also receive a Code Signing Certificate that is used to sign the iiziApp jar file you create when distributing an app. The signing seals your Developer ID in the jar file. iiziServer will not load apps that are unsigned or has been tampered with in order to attempt to replace or remove your Developer ID.

Enter your email and recovery email (optional, but strongly recommended).

Once filled in, your email will receive an email to verify your email address.

Fill in the validation code, press “Validate now”. Then fill in the passwords (strong passwords are required) and complete with “Sign Up”.

On the next page, you fill in required data used for the Code Signing Certificate. This information is also used to generate a self-signed SSL certificate in case you wish to use a secure connection. The Pin Code is used with Mindus Support and can also serve as verification in case you forget your password.

Creating a template app

If you left the checkbox “Create a template iiziApp” on the first wizard page selected, you will be asked for the name of the template project name and what device types you wish to create the template for. You can also use multiple languages when developing if Create text tables with automatic translation is turned on.

If text tables are used, the page below is filled in with the languages you wish to develop the app for. The first language will be the “base language”. The other text files will have their texts automatically translated from this base language text table. Google Translate or Azure Cognitive Service for text translation is used. Please note that there are limitations as to how much can be translated as the services in general are paid services. iizi comes with a demo account with about 1000 free translations. You may reconfigure one or both of them with your own keys for the service in question.

If you choose a language other than English as the base language, the template app text table will first be translated from English to the selected language. The other tables are then translated from that table. Please note that English often gives a better result in the automatic translations, although the services only keeps on getting better and better.

The screen capture below shows the text tables opened in parallel with the base language first.


← Back: Installation

→ Next: Create your iiziApp

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