Google Git
Sign in
fuchsia / sdk-samples / getting-started / b5fe47c0bf66d60f861cb6ea18c432ffbef2e723
commitb5fe47c0bf66d60f861cb6ea18c432ffbef2e723[log] [tgz]
authorDave Smith <smithdave@google.com>Mon Nov 28 17:12:34 2022 +0000
committerDave Smith <smithdave@google.com>Mon Nov 28 17:12:34 2022 +0000
treede4b66152ede65ce709c88105f832100752a64a6
parent8d94fd13989f08e101028724a846d4529af5b8a6 [diff]
[samples] Align header guard format.

Update all header guards to align with Google C++ style.

Bug: 109595
Change-Id: I4f2e8235aeb38cae7d3e8c5cb5b46f1e6fd3f789
Reviewed-on: https://fuchsia-review.googlesource.com/c/sdk-samples/getting-started/+/765503
Reviewed-by: Chris Holguin <cholguin@google.com>
1 file changed
tree: de4b66152ede65ce709c88105f832100752a64a6
  1. scripts/
  2. src/
  3. third_party/
  4. tools/
  5. .bazelrc
  6. .gitignore
  7. .gitmodules
  8. AUTHORS
  9. CONTRIBUTING.md
  10. getting-started.code-workspace
  11. LICENSE
  12. OWNERS
  13. PATENTS
  14. README.md
  15. WORKSPACE.bazel
README.md

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