Positron Web View
An Advanced Web View based Maui Project. This project was inspired from Cordova/Capacitor. However, building native plugins is very time consuming. Maui offers single language to write native plugins easy on any platform. So we decided to create Capacitor for Maui.
Get Started
- Create an empty folder
- Run
npm init - Run
npm install -s @positron-js/cli - Run
node ./node_modules/@positron-js/cli init - Run
npm installagain.
This will create a maui project inside maui folder. Along with build scripts to publish.
Publish
To publish the project, you must execute .jsx file with @neurospeech/jex as shown below.
node ./node_modules/@neurospeech/jex/index.js ./build-android.jsx
Jex is a new scripting engine that executes jsx files as a build script, and you can easily edit them and utilize JavaScript in the build script.
Access .NET Inside Browser
Positron exposes positron property on window object, with run method. Positron installs JavaScript engine (YantraJS in Android and JavaScriptCore in iOS), which integrates with CLR. So you can write JavaScript that access CLR objects directly.
Example Get DeviceToken
Lets assume that we have configured push messaging and we want to retrieve the device token. (For convenience, we have created Positron class that gives you deviceToken).
/** Although syntactically correct, this function
* will be executed inside Positron's JavaScript Engine.
* And the result will be available after successful execution.
*
* This function cannot contain any closer except `global`;
*/
/** Basically positron.run() will send script text and parameters (as json) to Positron's JavaScript engine*/
const deviceToken = await PositronInBrowser.run(function () {
// this runs inside App's Internal JavaScript Engine
const NSPositronAssembly = this.clr
.assembly("NeuroSpeech.Positron");
const Positron = NSPositronAssembly
// following is fully qualified name
.NeuroSpeech.Positron.Positron;
return Positron.deviceToken;
});
Example Open Url
await PositronInBrowser.run(function (url) {
const Essentials = this.clr.assembly("Microsoft.Maui.Essentials");
const Browser = Essentials.Microsoft.ApplicationModel.Browser;
Browser.default.openAsync(url);
}, "https://socialmail.me")
Create New Instance
Lets create a new instance of C# object and set it's properties.
await PositronInBrowser.run(function (url) {
const Essentials = this.clr.assembly("Microsoft.Maui.Essentials");
const Graphics = this.clr.assembly("Microsoft.Maui.Graphics");
const { Browser, BrowserLaunchOptions } = Essentials
.Microsoft.ApplicationModel;
const { Colors } = Graphics.Microsoft.Maui.Graphics;
const options = new BrowserLaunchOptions();
options.preferredToolbarColor = Colors.orange;
await Browser.openAsync(url, options);
}, "https://socialmail.me")
Naming Convention
Method and property names of CLR objects are converted to camel case.
Security
PositronWebView has property called ShouldInvokeScript, you can set it to a function that accepts string and returns true/false.
License
The project is licensed as GPLv3 as well as Commercial License. Commercial license is available for USD $100 per app per platform. This is lifetime license with unlimited free updates.
Please contact us at support at neurospeech dot com to get the license.