Note: Rust is not yet supported in the Fuchsia SDK.
This repository contains instructions and source code to build, package and run an example rust component which runs on Fuchsia using only the Fuchsia SDK.
Make sure this repository has the required submodules:
git submodule update --recursive --init
Run the bootstrap script that downloads the appropriate Bazel binary:
scripts/bootstrap.sh
Ensure that there are Fuchsia SSH keys in your host machine. You will need them for running the Fuchsia emulator.
[[ -f "${HOME}/.ssh/fuchsia_ed25519" ]] || ssh-keygen -P "" -t ed25519 -f "${HOME}/.ssh/fuchsia_ed25519" -C "${USER}@$(hostname -f) Shared SSH Key for Fuchsia" [[ -f "${HOME}/.ssh/fuchsia_authorized_keys" ]] || ssh-keygen -y -f "${HOME}/.ssh/fuchsia_ed25519" > "${HOME}/.ssh/fuchsia_authorized_keys"
Now the repository is ready to build the samples.
Fetch the system images
tools/ffx product-bundle get workstation_eng.qemu-x64 --repository workstation-repo
Note: if the product-bundle command above fails with an error message that states that there are multiple product bundles with the same name, you can either specify the fully qualified URL as printed in the error message that corresponds to your SDK version (use
tools/ffx sdk version
if needed), or you can wipe out old and unused product bundles in the pbms storage, which should be located in ~/.local/share/Fuchsia/ffx/pbms on Linux, or ~/Library/Fuchsia/ffx/pbms on MacOS.
Start the emulator
tools/ffx emu start workstation_eng.qemu-x64 --headless
The product bundle comes with on-demand packages in a separate repository. Use the following command to register it with the emulator:
tools/ffx target repository register -r workstation-repo --alias fuchsia.com
watch the device log in a separate window
tools/ffx log --filter core/ffx-laboratory:hello_rust
Run the hello world component
tools/bazel run //src/hello_rust:pkg.component
Watch in the log that the message “Hello, Rust!” is printed. Modify the Hello world message in src/hello_rust/src/main.rs, repeat this step and see that the log shows the new message.