Source code
Revision control
Copy as Markdown
Other Tools
This directory contains generated code for the UniFFI examples/fixtures and JS
unit tests for it.
This is only built if the `--enable-uniffi-fixtures` flag is present in
`mozconfig`. There's no benefit to including this in a release build.
To add additional examples/fixtures:
- For most of these steps, find the code for existing fixtures and use it as a template for the new code.
- Edit `toolkit/components/uniffi-bindgen-gecko-js/mach_commands.py`
- Add an entry to `FIXTURE_UDL_FILES`
- Edit `toolkit/library/rust/shared/Cargo.toml`
- Add an optional dependency for the fixture.
- Add the feature to the list of features enabled by `uniffi_fixtures`.
- Edit `toolkit/library/rust/shared/lib.rs`:
- Add an `extern crate [name]` to the `uniffi_fixtures` mod
- Note: [name] is the name from the `[lib]` section in the Cargo.toml
for the example/fixture crate. This does not always match the package
name for the crate.
- Add `[name]::reexport_uniffi_scaffolding` to the `uniffi_fixtures` mod
- Edit `toolkit/components/uniffi-bindgen-gecko-js/fixtures/moz.build` and add the fixture name to the `components`
list.
- Add a test module to the `toolkit/components/uniffi-bindgen-gecko-js/fixtures/tests/` directory and an entry for it
in `toolkit/components/uniffi-bindgen-gecko-js/fixtures/tests/xpcshell.ini`
- Run `mach vendor rust` to vendor in the Rust code.
- Run `mach uniffi generate` to generate the scaffolding code.
- Check in any new files
To run the tests:
- Make sure you have a `mozconfig` file containing the line `ac_add_options --enable-uniffi-fixtures`
- Run `mach uniffi generate` if:
- You've added or updated a fixture
- You've made changes to `uniffi-bindgen-gecko-js`
- Run `mach build`
- Run `mach xpcshell-test toolkit/components/uniffi-bindgen-gecko-js/fixtures/tests/`
- You can also use a path to specific test file
- For subsequent runs, if you only modify the test files, then you can re-run this step directly