Skip to content

App

Application generator (Beta)

Warning

Application generator is an experimental feature. Bear in mind that this feature is not stable yet. This means it might crash, or some features might not work properly

iotize app start <my-app-name> --tap-config <your-tap-config-file-path>

This command creates a working Ionic app. It installs dependencies for you and sets up your project.

The first argument is your app's name. The project id is generated from the application name unless explicitly specified.

--tap-config option is used to pass the IoTize studio configuration file path.

Running this command will prompt you additional information.

Once your app generated, go inside the newly created folder and run your app with one of the following commands:

# Go to generated directory
cd <my-app-name>
# Run on an Android device
npm run android
# Or run on iOS (You must be on a MAC)
npm run ios
# Or run in a browser
npm run webapp

The first time you run on android or iOS, it will take several minutes to install cordova project and its dependencies, be patient.

As generated project is based on ionic framwork, you can use ionic CLI.

Architecture

Generated application project is based on ionicframework v4 and angular. Ionic framework documentation can be found here.

Ionic Framework is an open source UI toolkit for building performant, high-quality mobile and desktop apps using web technologies (HTML, CSS, and JavaScript). Ionic Framework is focused on the frontend user experience, or UI interaction of an app (controls, interactions, gestures, animations). It’s easy to learn, and integrates nicely with other libraries or frameworks, such as Angular, or can be used standalone without a frontend framework using a simple script include.

Supported plaforms

According to the runtime platform/version of the generated app, some features may or may not work.

Here a non exhaustive list of supported platforms:

Mobile OS

Platform Supported Tested version Notes
Android YES Android >= 6.0 Android Platform Guide
iOS YES iOS 13 To test/run the generated app on iOS, you must use a MacOS device configured for iOS development. Start Developing iOS Apps (Swift)

Desktop browsers

Browser Supported Tested version Notes
Chrome YES Tested on version 76.0.3809.132 NFC not available
Safari YES Tested on version 12.1.2 BLE/NFC not available
Opera YES Tested on version 63.0.3368.71 BLE/NFC not available
Firefox YES None BLE/NFC not available
Edge YES Tested on version 42.17134.1.0 BLE/NFC not available
Internet Explorer NO

Mobile browsers

Browser Supported Tested version Notes
Chrome YES None
Opera YES None
Safari YES None

refresh (Beta)

Regenerate app according to configuration file. Must be run inside the project directory.

iotize app refresh