aljaz/pear-docs
1
0
Fork 0
mirror of https://github.com/aljazceru/pear-docs.git synced 2025-12-17 14:34:19 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update bare lifecycle methods (#180)

Browse Source 
* Update bare API docs to 1.17.1

* Add Options section on Bare building configuration

* Update Bare module list to 1.17.1
This commit is contained in:
Sean Zellmer
2025-03-27 13:32:46 -05:00
committed by GitHub
parent c966f41503
commit 0d7fbfe0c3
3 changed files with 77 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
reference/bare/overview.md
View File

@@ -110,6 +110,18 @@ When completed, the `bare(.exe)` binary will be available in the `build/bin` dir
When linking against the static `libbare.(a|lib)` library, make sure to use whole archive linking as Bare relies on constructor functions for registering native addons. Without whole archive linking, the linker will remove the constructor functions as they aren't referenced by anything.
### Options
Bare provides a few compile options that can be configured to customize various aspects of the runtime. Compile options may be set by passing the `--define option=value` flag to the `bare-make generate` command when generating the build system.
> [!WARNING]
> The compile options are not covered by semantic versioning and are subject to change without warning.
| Option | Default | Description |
| :--------------- | :------------------------- | :------------------------------------------------------ |
| `BARE_ENGINE` | `github:holepunchto/libjs` | The JavaScript engine to use |
| `BARE_PREBUILDS` | `ON` | Enable prebuilds for supported third-party dependencies |
## Platform support
Bare uses a tiered support system to manage expectations for the platforms that it targets. Targets may move between tiers between minor releases and as such a change in tier will not be considered a breaking change.