Open topic with navigation

Kony Fabric console User Guide: Publish > Publish Life-Cycle

Publish Life-cycle

In the Publish tab, when you click the Publish button, the system starts to publish life-cycle of an app. The publish life-cycle has several app publish stages. During publish app, the system validates each of the stages. Each stage indicates with a tick mark after a successful publish of that stage.

Note:  If a service is not configured in an app during design time, the system skips that stage without errors while publishing the app.
However, a tick mark is attached to the stage that indicates publish is successful. While accessing the app in runtime, the system skips non configured services automatically.

While publishing an app, the system processes a set of stages for the configured services in the app. The stages such as validating services, cleaning unused (Integration Orchestration, and Sync) services, propagating changes to runtime, publishing Sync services, publishing app resources, publishing identity services, publishing reporting services, and publishing messaging services.

Important:  Ensure that you configure and validate services in the app are correct to avoid failures during publish life-cycle.

During publish life-cycle, the system fails to publish a stage due to wrong configurations in the app - such as, if a service is not configured, installed, or registered in the app, or an integration service has a broken reference of an identity service. An exclamation mark next to the failure message indicates that the stage was not successfully published.

For example, if message services have a wrong data configured in the app, the system does not publish this stage and throws the following error:

To view error details, in the Publishing dialog, click the Show Details link next that failed services.
Click OK to close the Publishing dialog.

A publish error has the following details:

Publish Failure Error Messages

The following publish failure errors indicate that you have not installed a service or registered a service as an environment.

Code Results of a Published App

The following information is available after you publish an app:

Sample Code

To view the sample code, follow these steps:

  1. Click </> below the name of the app.

    The Sample Code dialog appears.

  2. Select an environment from the Published to environment list.

  3. Select a platform to view the corresponding sample code.

    Note: You need to add this code in the initialization function of the respective platform SDK.

App Documentation

After you publish an app to an environment, Kony Fabric generates app documentation for your app. You can download app documentation from the Environments list in Publish page.

  1. To view the App documentation of a published app, click the Download app documentation button in the Published Environment box. The app documentation is downloaded in a zip folder to your local system.

  2. Unzip the app documentation folder.
    The app documentation .zip comprises multiple artifacts such as index.html file, service definition in Open API Initiative (OAI) format, services references in HTML and JSON format.

  3. Open the index.html in a browser to view the app details.

App Information

To view the App key and App Secret of a published app, click the App Key button in the Published Environment box.

The Primary Key/App Secret, Secondary Key/App Secret, and Service URL are used to initialize a client app to use Kony Fabric services.
For more information, refer to Separate App Key/App Secret for Native and Web Channels.

App Service Document, Object Services Metadata, and Sync Client Code

To view the App Service Document, Object Services Metadata, and Sync Client Code, follow these steps:

  1. Click Download button in the Published Environment box.

    Based on the configuration, the system displays links - for example:

    • App Service Document
    • Object Services Metadata
    • Sync Client Code:
      • Sync client code (PhoneGap)
      • Sync client code (Kony Studio)
      • Sync client code (Android)
      • Sync client code (iOS)
  2. Click App Service Document to view the code.

    Note: If an environment contains an alias hostname, the alias is used in the generated App Service Document. It is also used to make service calls from the client app.

  3. Click Sync client Code (PhoneGap) to download the Sync client code (PhoneGap) file.
  4. Click Sync client Code (Kony Studio) to download the Sync client code (Kony Studio) file.

Runtime Console

A published app provides link to the following services consoles:

Snapshots

Whenever you publish a Kony Fabric app, a snapshot of the published app is created automatically in the Publish life-cycle. It captures the services and other configurations of the app at the time of publish. If the app is republished multiple times with some changes during the development, you can revert back to the previous versions using snapshots. This feature helps you to revert back to a stable state if the current publish results in an error so that the runtime is not effected.

To view the snapshots of the published app, click Snapshots. The History and Rollback screen is displayed.

By default, you can view the last two snapshots of an app in this screen and the last published app will be marked as Active. Click Settingsto change the number of snapshots you can view.

You can do the following in the Settings screen:

You can perform the following activities from the contextual menu available for each snapshot in the History and Rollback screen:

 

Copyright © 2020 Kony, Inc. All rights reserved.

Open topic with navigation