Clone this repo:

Branches

  1. ed8280d Add platform selection to .bazelrc based on --config by Renato Mangini Dias · 28 hours ago main
  2. b5fe47c [samples] Align header guard format. by Dave Smith · 4 days ago
  3. 8d94fd1 [routing] Add server with inspect tracking. by Dave Smith · 11 days ago
  4. 505ed64 [vscode] Update workspace settings. by Dave Smith · 11 days ago
  5. cd8e18b [fidl] Remove HLCPP from routing sample. by Dave Smith · 12 days ago

Fuchsia samples using the Fuchsia SDK

This repository contains instructions and source code to build, package and run Fuchsia samples using only the Fuchsia SDK.

Requirements

  1. Make sure this repository has the required submodules:

    git submodule update --recursive --init
    
  2. Run the bootstrap script that downloads the appropriate Bazel binary:

    scripts/bootstrap.sh
    
  3. 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"
    

Build, run and test the samples

Now the repository is ready to build the samples.

  1. Fetch the system images

    tools/ffx product-bundle get workstation_eng.qemu-x64 --repository workstation-packages
    

    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.

  2. Start the emulator

    tools/ffx emu start workstation_eng.qemu-x64 --headless
    
  3. 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-packages --alias fuchsia.com --alias chromium.org
    
  4. (optional) watch the device log in a separate window

    tools/ffx log
    
  5. Run a hello world component

    tools/bazel run --config=fuchsia_x64 src/hello_world:pkg.component
    

    Watch in the log that the message “Hello, World!” is printed. Modify the Hello world message in src/hello_world/hello_world.cc, repeat this step and see that the log shows the new message.

  6. Run the echo sample

    tools/bazel run --config=fuchsia_x64 src/echo:pkg.component
    

    Watch the message “Hello, Alice, Bob, Spot!” in the log. Modify the FAVORITE_ANIMAL environment variable in src/echo/meta/echo.cml, repeat this step and see that the log shows the new message.

  7. Run unit tests for samples

    tools/bazel test --config=fuchsia_x64 src/hello_world:test_pkg
    tools/bazel test --config=fuchsia_x64 src/echo:test_pkg