WaveMaker Docs

WaveMaker Docs

  • Get started
  • Widgets
  • How-to
  • Enterprise
  • Releases
  • Blog
  • Sign-in

›Mobile Installer

Getting started

  • Introduction
  • Walkthrough

Pages

  • Pages Overview
  • Creating a Page
  • Layout and Styles

    • Page Layout
    • Templates
    • Themes

    Page Configure

    • Page Artefacts
    • Page Cache
    • Partial Page
    • Page Parameters
    • Examples

    Page Actions

    • Navigation
    • Events

    Custom Development

    • Theme Editor
    • Manual Theme
    • Create Template

Databases

  • Database Services Overview
  • Database Tools
  • Database Designing

    • Working with Databases
    • Data Modelling
    • DataBase Schema Modes
    • Working with DB Schema
    • Database Views
    • Temporal Support

    Accessing Database

    • Accessing Database

    Queries and Procedures

    • Working with Queries
    • Working with Stored Procedures
    • Version Queries & Procedures
    • Blob Queries and Procedures
    • Queries & Procedures - Java Services

    Database Variables & API

    • Database CRUD
    • Database APIs
    • Database Service APIs

REST & SOAP

  • Web Services Overview
  • Restful

    • REST Services
    • Secure Server-side Properties
    • REST Services using OAuth 2.0

    SOAP

    • Working with SOAP Services
    • Imported SOAP APIs

    Websocket

    • Working with WebSockets

    APIs

    • API Designer
    • Swagger Import

    Variables

    • CRUD Variable
    • Service Variable
    • WebSocket Variable

Java Services

  • Java Service
  • Java Services

    • Java Integration Services
    • DB Service Integration
    • Variables for Invocation
    • Generated REST APIs (API Designer)

    Java Services Variables & API

    • Variable for Java Service
    • Java Service APIs

    Source Files

    • Resources and Third-party Libraries
    • Using 3rd party JavaScript files
    • Using 3rd party jar files

Variables & Actions

    Variables

    • Variables Overview
    • Model Variable
    • Device Variables

    Binding

    • Variable Binding
    • Custom Formatter

    Actions

    • Actions
    • Navigation Action
    • Login Action
    • Logout Action
    • Timer Action
    • Notification Action

    Events

    • Events
    • JavaScript Access

Security

    App Security

    • Overview
    • Authentication
    • Authorization
    • Access Levels & Permissions
    • Login Configuration
    • Session Persistence
    • SSL Encryption
    • XSS antisamy policy configuration
    • OWASP
    • Central Authentication System
    • Token Based Authentication
    • SAML Integration
    • Secure Connection for Deployed Apps

    Security Variable and API

    • Security Variables
    • Remember Me
    • Variable for Security Service
    • Security Service APIs

Developer options

  • Test and Run (Preview) Apps
  • Build Options
  • Inspection Framework
  • Debugging
  • WaveMaker Mobile Apps Automation
  • Developer Integration

    • Project User Management
    • Developer Collaboration
    • Extending the Application using IDEs
    • Import, Export & Update Apps
    • Project Shells

    Add-ons

    • Localization
    • Artifacts Repository

Deployment

  • Overview
  • Deployment Profile
  • One-click Deployment
  • WaveMaker CI/CD Pipeline

    • Overview
    • Configuration Profiles
    • Pipelines and Phases

    Pipeline Configuration

    • Default Pipelines in WMO
    • Configure Pipeline in WME

    Deploy to Cloud Providers

    • AWS
    • Azure
    • Google Cloud
    • DigitalOcean

    Pipeline Configuration cont.

    • Phase configurations
    • Webhooks Integration
    • Tests Integration

    Manage Deployed Apps

    • Manage Deployed Apps

    Integrate with your CI/CD Providers

    • Push Code to External repo
    • Integration with Custom VCS provider
    • Export WaveMaker Application
    • Building Project with Maven
    • Build with Docker
    • Jenkins Integration
    • Deploy using Docker Compose
    • Deployment to Heroku

    WaveMaker apps Interation with CDN

    • App Integration with AWS CDN
    • App Integration with Azure CDN

    Deployment to external web servers

    • Application Server Overview
    • Deploy to Tomcat
    • WebSphere
    • JBoss - WildFly
    • WebLogic Server

Mobile development

  • Building Hybrid Mobile Apps
  • Native Device Support
  • First Mobile App
  • Mobile Design

    • Mobile Page Design
    • Gesture Support
    • Mobile Tabbar
    • Mobile Navbar

    Mobile Installer

    • Test Run (Preview)
    • Debugging Mobile Apps
    • Testing Hybrid Mobile Apps using WaveLens
    • Mobile Build - Android
    • Generating iOS and Android Distribution Certificates
    • Export Cordova zip
    • Mobile Build - Manual
    • Mobile Build - AppChef

    Mobile Integrations

    • Mobile Integrations - Amazon Mobile Analytics
    • Mobile Integrations - Amazon SNS
    • Using Push Notifications in Mobile Device
    • Invoking Web App APIs in Mobile Apps

    Offline Features

    • Offline Data Support
    • Implementation
    • Switching between Offline and Online Mode

Connectors

  • Introduction
  • Architecture
  • Import Connectors
  • List of Connectors
  • Build a New Connector

Teams

  • Overview
  • Team Setup
  • Dashboard
  • Manage Users
  • Manage Projects
  • Manage Roles
  • Code Repository
  • Team Profile
  • Manage Subscription
  • FAQs
Edit

Mobile Build - AppChef


AppChef builds app installers including APK and IPA from a Cordova zip that can be exported from the WaveMaker Studio. Thus, generated APK or IPA, can be used for testing or can be uploaded to the Play Store and App Store for distribution.

Prerequisite to build using AppChef

To perform a Build using AppChef, you should have the application Cordova zip. WaveMaker provides an option to export your mobile application to a Cordova zip. For more information, see download cordova zip.

Using the Workspace Toolbar from Build task select Open AppChef. It will navigate you to the AppChef application.

mobile-build-appchef-studio-option.png

To login, click Login with WaveMaker

mobile-build-appchef-login-screen

If there are no builds, a dialog will be shown to choose between Read documentation or Create new build.

mobile-build-appchef-startup-dialog.png

Steps to build using AppChef

Build through AppChef is a three-step process, as described below.

  1. Upload Cordova zip
  2. Configure AppInfo
  3. Configure Build

Upload Cordova zip

Click on create new build option, drag and drop or browse your files to upload cordova zip.

mobile-build-appchef-upload-cordova-zip

Configure AppInfo

  1. After Successful upload, AppInfo will be pre-populated from your uploaded cordova zip. You have options to modify them to your choice.

  2. Click Next to configure the Build options.

mobile-build-appchef-appInfo

Configure Build

In this step, you can provide a distribution profile and choose certificates of the profile respectively.

mobile-build-appchef-buildconfig

OptionsDescription
CordovaThis is the cordova version that is required by the uploaded app. This cannot be modified.
Package TypeThere are two options, 1) Development and 2) Production. Choose ‘Development’ to create a debuggable app -- typically for testing. Choose ‘Production’ to create an apk or ipa to distribute on play store or app store.
Cordova IOSThis is the cordova-ios version that is required by the uploaded app. This cannot be modified.
IOS CertificateIn this option, either you have to choose already uploaded certificates or you can upload a new one. Choose the right certificate that supports ‘Package Type’ selected.
Cordova AndroidThis is the cordova-android version that is required by the uploaded app. This cannot be modified
Android CertificateIn this option, A default _DEBUG certificate is available to generate an android application. _DEBUG certificate can only support ‘Development’ package type. You can either choose already uploaded certificates or you can upload a new one. Choose the right certificate that supports ‘Package Type’ selected.

Provide the required options and click Save and Build to start building the application.

note

Uploaded certificates password will be cleared after every 24 hours, you need to provide password whenever prompted. To know more, click here

Manage or Upload Certificates

During the build process, i.e., in the last step of the build, there is an Add icon to upload certificates for Android and iOS . Dialog will be shown specific to store android and iOS certificates.

mobile-build-appchef-upload-certificate-option

These are the options that are shown when you want to add an IOS certificate

mobile-build-appchef-upload-ios-certificate

These are the options that are shown when you want to add an Android certificate

/learn/assets/mobile-build-appchef-upload-android-certificate

tip

You always have an option to check the uploaded certificates where you can add a new one, lock or unlock the certificate and delete the existing ones by opening the options from the application menu which is located at the right top corner.

mobile-build-appchef-application-menu

mobile-build-appchef-manage-certificates

Securing certificates

To secure the uploaded certificates, passwords will be saved in encrypted format. A Certificate with password is in unlocked state and builds can only be triggered with unlocked certificates. Certificates will get automatically locked after 24 hours of unlocking, To unlock the certificate you have to provide password again.

A dialog will be shown to unlock certificate in two cases,

  1. In configure build step, while uploading cordova zip

    For iOS, you need to enter certificate password

    /learn/assets/mobile-build-appchef-unlock-ios-certificate

    For android, you need to enter Key password and Store password

    /learn/assets/mobile-build-appchef-unlock-android-certificate

  2. While re-queuing the build in an existing application.

    /learn/assets/mobile-build-appchef-unlock-ios-certificate-in-requeue.png

    /learn/assets/mobile-build-appchef-unlock-android-certificate-in-requeue.png

Checking status of the submitted build request

Once you click on save and build for an application, the build will be available in MyApps section. Open the application card and check the build info and status related to it. You can also delete the application card if it is not required.

note

Only a maximum of 25 applications can be built using AppChef. You can delete the applications that are not necessary.

mobile-build-appchef-myapps-dashboard

These are the details that are shown for the submitted application.

mobile-build-appchef-check-build-status-info

Application build stages

Application build status has following stages

  1. Queued - Server is waiting for the worker to pick up the job.
  2. Processing - Once a worker picks the job, status will be changed to processing.
  3. Success - If build is successful from the server, status will be changed to success.
  4. Failed - If build is failed from the server, status will be changed to failed.
  5. Timed-out - If build time is more, status will be changed to timed-out and it is a failed job.
  6. Cancelled - If build is cancelled using cancel option, status will be changed to cancelled.

Application Build Actions

Every build has five actions. i.e.,

  1. Download the build log - Build log is available for a failed and as well as for a successful job.
  2. Download artifact - It has APK/IPA file, this option is available only for successful jobs
  3. Queue the build - You can rebuild the application. this option is available for a successful or a failed job
  4. Cancel build - Cancel build will cancel the job which is in progress, this option is available only for the job whose Queued or Processing.
  5. Delete build - Delete the build, this option is available in all the stages of the build.

Manage the existing application

To perform builds for the latest cordova zip of the existing application, you have an option to upload cordova zip and build info of the application will be shown in the application itself.

mobile-build-appchef-submitted-build-options

note

Only the last 10 builds are shown under the Builds section. If build requests exceeds 10, a message will be shown to delete the existing builds.

After the successful build, you can install the application in Android or iOS devices by scanning the QRcode which is located at the right corner as shown below.

learn/assets/mobile-build-appchef-build-qrcodes

or, you can click on the platform (IOS, Android) under the build info to scan a particular build QRCode.

/learn/assets/mobile-build-appchef-build-specific-qrcode

Last updated on 12/8/2020 by Anitha
← Mobile Build - ManualMobile Integrations - Amazon Mobile Analytics →
  • Prerequisite to build using AppChef
  • Steps to build using AppChef
    • Upload Cordova zip
    • Configure AppInfo
    • Configure Build
  • Manage or Upload Certificates
    • Securing certificates
  • Checking status of the submitted build request
    • Application build stages
    • Application Build Actions
    • Manage the existing application
WaveMaker
  • PRICING
  • PARTNERS
  • CUSTOMERS
  • ABOUT US
  • CONTACT US
Terms of Use | Copyright © 2013-2021 WaveMaker, Inc. All rights reserved.