Skip to content

Latest commit

 

History

History
94 lines (68 loc) · 3.62 KB

CONTRIBUTING.md

File metadata and controls

94 lines (68 loc) · 3.62 KB
Raw

Contributing Guidelines

BP Studio is developed using VS Code, and the project folder is already configured for it. As you open the project with it, it will also hint you the recommended extensions to install.

Contributing new languages

Please refer to the readme of the Locale section.

Environment and build instructions

To build BP Studio, first you need the following:

  1. Install or upgrade Node.js to v20+.
  2. BP Studio had migrated from NPM to PNPM for package managing, so install PNPM by the command npm install -g pnpm.
  3. Use the command pnpm install under the project root folder to install all dependencies.

And then you can simply press F5 in VS Code to build and launch the app automatically. This is the preferred way to launch as it allows debugging in the IDE.

Alternatively, run pnpm build to build the entire project manually, and then run pnpm start to launch the local server on debug build.

Note: one should always run BP Studio through a server, as some of the features would not work in files:// protocol.

Typically the default build task is sufficient for developing purpose, and you won't need to execute individual Gulp subtasks, as all subtasks will skip themselves if the source files are not changed. If something goes wrong, you can run pnpm build clean to cleanup built files and then rebuild everything.

Browser compatibility

BP Studio have tried to support as much browser versions as possible, but there are some essential barriers that cannot be compromised. First of all, IE is obviously not supported as there're way too many modern features that cannot be used, plus it's REALLY dead by now. And then:

  • Firefox < 78 and Safari < 11.1 (or iOS < 11.3) does not support the s flag of regular expressions. See caniuse.
  • Chrome < 66 and Opera < 53 does not support Array.prototype.values. See caniuse.

Both these features are used in Vue 3, which is a critical dependency of BP Studio. The second issue could be polyfilled, but I see less point in doing so as those versions are old enough already, while the first issue is impossible to polyfill.

Note that the targeted version almost coincide with the support for optional catch binding, with Firefox being the only exception.

There's currently no plans for officially supporting browsers other than Chrome, Edge, Safari, Firefox, Opera, and Samsung Internet. Not that I don't want to, but that I don't have the resource to do so.

Unit testing

Refer to the README of tests.

Code styling

This project use ESLint for both linting and formatting (using @stylistic/eslint-plugin). If one opens it with VS Code plus the recommended extensions, all files will go through auto formatting as one saves them.

About the source code organization

BP Studio consists mainly of three parts: the App, the Client, and the Core. Their relations can be roughly depicted as follows:

graph LR
	a("App\n(user interface)")
	b("Client\n(workspace)")
	c("Core\n(worker thread)")
	a -->|controls| b
	b -->|data| a
	b -->|manipulates| c
	c -->|graphics| b
Loading

Refer to the README of each of them through the links above for more details.

All comments are now in English! Feel free to contact me in any part of the code is unclear to you.