xGUI Pro

xGUI Pro is a modern, cross-platform, and advanced HVML renderer which is based on tailored WebKit.

Table of Contents

• Introduction
• Dependencies
• Building xGUI Pro
• Current Status
• TODO List
• Copying
  • Commercial License
  • Special Statement
• Tradmarks

Introduction

This software is a part of HVML project.

During the development of HybridOS, Vincent Wei proposed a new-style, general-purpose, and easy-to-learn programming language called HVML.

HVML provides a totally different framework for GUI applications other than C/C++, Java, C#, or Swift. In a complete HVML-based application framework, a standalone GUI renderer is usually included.

xGUI Pro is an open source implementation of the standalone GUI renderer for HVML programs. It licensed under GPLv3, and it is free for commercial use if you follow the conditions and terms of GPLv3.

xGUI Pro is based on the mature browser engine - WebKit. By using xGUI Pro, the developers can use HTML/SVG/MathML and CSS to describe the GUI contents in their HVML programs. We reserve the JavaScript engine of WebKit, so it is possible to use some popular front-end framwork such as Bootstrap to help xGUI Pro to render contents in your user interfaces.

For documents and other open source software around HVML, you can visit the following URLs:

• https://github.com/HVML, or
• https://hvml.fmsoft.cn

Dependencies

xGUI Pro depends on the following software:

• Tailored WebKit Engine: to support two HVML-specific attributes hvml-handle and hvml-events.
• PurC: the HVML interpreter for C language.
• DOM Ruler: a library to maintain a DOM tree, lay out and stylize the DOM elements by using CSS.

Currently, xGUI Pro only runs on Linux system. It is possible to run it on macOS, but we did not test it yet.

Please download of fetch the souce code of the above software, build, and install them by following the instructions included the software.

To build the tailored WebKit engine, you can visit the following URL for a detailed instruction:

https://trac.webkit.org/wiki/BuildingGtk

Please make sure that the cmake configuration option ENABLE_HVML_ATTRS is enabled when you configuring the tailored WebKit.

We encourage everyone to port xGUI Pro to other platforms, such as Windows, Android, iOS, etc.

Building and Running xGUI Pro

After building and installing the dependency libraries, you can change to the root directory of the source tree of xGUI Pro and run the following commands:

$ rm -rf build && cmake -DCMAKE_BUILD_TYPE=Debug -DPORT=GTK -B build && cmake --build build

You can run the following commands to install xGUI Pro to your system in the build/ directory:

$ cd build/
$ sudo make install

You can also run xGUI Pro in build/ directory without installing it to the system. However, you need to specify the enviornment variable WEBKIT_WEBEXT_DIR as follow:

$ WEBKIT_WEBEXT_DIR=</path/to/your/xgui-pro/build/lib/webext> bin/xguipro

In the above command lines, the enviornment variable WEBKIT_WEBEXT_DIR is used to specify the directory in which the HVML extension module locates. The building scripts will copy the HVML extension module for WebKit to the build/ directory, so that you can start xGUI Pro without installing it to your system.

By default, if you do not define this enviornment variable, xGUI Pro will try to find the extension module in the sub directory called xguipro/ in the library installation directory. Generally, it is /usr/local/lib/xguipro on Linux by default.

You can also pass the following options to your command line when running xGUI Pro:

  --pcmc-nowebsocket       Without support for WebSocket
  --pcmc-accesslog         Logging the verbose socket access information
  --pcmc-unixsocket=PATH   The path of the Unix-domain socket to listen on
  --pcmc-addr              The IPv4 address to bind to for WebSocket
  --pcmc-port              The port to bind to for WebSocket
  --pcmc-origin=FQDN       The origin to ensure clients send the specified origin header upon the WebSocket handshake
  --pcmc-sslcert=FILE      The path to SSL certificate
  --pcmc-sslkey=FILE       The path to SSL private key
  --pcmc-maxfrmsize=BYTES  The maximum size of a socket frame
  --pcmc-backlog=NUMBER    The maximum length to which the queue of pending connections.

After you start xGUI Pro, run purc from another terminal to execute an HVML program. For example, in the build/ directory of PurC, run the following command to start the arbitrary precision calculator:

$ cd <path/to/directory/to/build/purc>
$ Source/Tools/purc/purc -p purcmc hvml/calculator-bc.hvml

Debugging xGUI Pro

For security reasons, the core dump is disabled by default on some Linux systems. The above command lines specify the core pattern, which will be used when dumping the core of an aborted process by the kernel.

$ sudo su
# echo "/tmp/core-pid_%p.dump" > /proc/sys/kernel/core_pattern
# exit
$ ulimit -c unlimited

If encounter core dumps, use gdb:

$ gdb bin/xguipro -c /tmp/core-pid_xxxx.dump

Note that, gdb might take several minutes to load the symbols of xGUI Pro and WebKit. So please wait patiently.

Current Status

• July 2022: Version 0.6.0.

Authors and Contributors

• Vincent Wei

Copying

Copyright (C) 2022 FMSoft Technologies

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Tradmarks

1. HVML is a registered tradmark of FMSoft Technologies in China and other contries or regions.

2. 呼噜猫 is a registered tradmark of FMSoft Technologies in China and other contries or regions.

3. Purring Cat is a tradmark of FMSoft Technologies in China and other contries or regions.

4. PurC is a tradmark of FMSoft Technologies in China and other contries or regions.

5. xGUI is a tradmark of FMSoft Technologies in China and other contries or regions.