Skip to content
This repository was archived by the owner on Oct 6, 2024. It is now read-only.

Latest commit

 

History

History
69 lines (42 loc) · 3.04 KB

CHANGELOG.md

File metadata and controls

69 lines (42 loc) · 3.04 KB

FuseJS

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

This software is early alpha release cycles

This means that there will be an effort to keep breaking changes in the 0.x version bumps, but there could be breaking changes in any release.

0.6.0 (UNRELEASED)

Breaking Changes

  • FuseContext will now construction parameters.
  • Is is no longer recommended to extend FuseContext. All overridable construction hooks have been removed.
  • FuseContextBuilder is now provided to build and configure a FuseContext. This is an asynchronous action as it requires calls to native now. The minimum needed to get your context is to do:
let builder: FuseContextBuilder = new FuseContextBuilder();
let context: FuseContext = await builder.build();

Which will build your fuse context with the default options, which should be sufficient for most apps.

  • Fuse Plugin APIs endpoints now requires a leading slash (/). This is to create recognizable consistency.
- this._exec("myAPICall", ...)
+ this._exec("/myAPICall", ...)

Features

FuseLogger

A new FuseLogger API has been created. Use FuseContext.getLogger() to use it.

Benefits of using FuseLogger:

  1. LogSeverity control
  2. Logs processed via FuseLogger will also be sent to the native environment to be logged in the native's syslog.

This is especially useful for iOS since Safari doesnt actually capture log events that occurs prior to the inspector being attached to the Webview.

To save on processing, bridging logs to the native environment by default is only done while the application is running in debug mode (e.g. an iOS/Android Debug build variant). This can be overridded by calling on FuseLogger.enableNativeBridge(true):

let context: FuseContext = getContext();
context.getLogger().enableNativeBridge(true);

FuseCallbackManager

A new FuseCallbackManager API has been added which is a singleton class to manage callbacks for native use.

This was actually part of the FusePlugin implementation before but it now abstracted out so that it can be used more generically.

Register a callback context id using FuseCallbackManager.getInstance().createCallback(callback) and pass the ID to the native environment, which can use native APIs with the provided callback ID to respond back to the webview environment.

Use FuseCallbackManager.getInstance().releaseCallback(id) to destroy the listener on the webview and free up resources.

Note that using the callback API uses the traditional data transfer mechanisms which only accepts strings and is not very efficient in transfering large data payloads. When possible, prefer to use the Plugin API approach. The callback API is however useful for creating watch/subscriber APIs where the native must be able to continuously or periodically callback to the webview with small data packets.