commit | 602ecad33fcf18aa13391f1b3a1c4bb136067115 | [log] [tgz] |
---|---|---|
author | Kyo Lee <kyol@google.com> | Tue Jan 16 18:35:28 2024 +0000 |
committer | Kyo Lee <kyol@google.com> | Tue Jan 16 18:35:28 2024 +0000 |
tree | 7dc667acfbaabd6b08c54cff0538b80020890ab8 | |
parent | 8877151f262c3a33b5d0df9f4c743cd1b9389db6 [diff] |
[docs] Add instructions to `README.md` on how to set up and bootstrap this `getting-started` SDK repo. Source: [Walkthrough of workflows using the Fuchsia SDK](https://fuchsia.dev/fuchsia-src/get-started/sdk?env=terminal) Change-Id: I65c96b45377c83fe768a08c21e59230702cc7b3f Reviewed-on: https://fuchsia-review.googlesource.com/c/sdk-samples/getting-started/+/973034 Reviewed-by: Jiaming Li <lijiaming@google.com>
This repository contains instructions and source code to build, package and run Fuchsia samples using only the Fuchsia SDK.
Clone this SDK samples repository on your host machine. This repository contains the Bazel-based Fuchsia SDK and sample components.
The tasks include:
ffx
commands.Do the following:
Open a terminal.
In the terminal, change to your home directory:
cd
Clone the Fuchsia samples repository:
git clone https://fuchsia.googlesource.com/sdk-samples/getting-started fuchsia-getting-started --recurse-submodules
This git clone
command creates a new directory named fuchsia-getting-started
and clones the content of the SDK samples repository{:.external}.
Go to the new directory:
cd fuchsia-getting-started
Run the bootstrap script to install Bazel and other required dependencies:
scripts/bootstrap.sh
Download the SDK toolchain:
tools/bazel build @fuchsia_sdk//:fuchsia_toolchain_sdk
This command may take a few minutes to download all the tools and dependencies, such as Clang{:.external} and Fuchsia IDK (which includes the ffx
tool).
When finished successfully, it prints output similar to the following:
$ tools/bazel build @fuchsia_sdk//:fuchsia_toolchain_sdk ... INFO: Elapsed time: 25.063s, Critical Path: 0.03s INFO: 1 process: 1 internal. INFO: Build completed successfully, 1 total action
To verify that you can use the ffx
tool in your environment, run the following command:
tools/ffx sdk version
This command prints output similar to the following:
$ tools/ffx sdk version 11.20230109.3.1
At this point, you only need to confirm that you can run ffx
commands without error.
Note: The output above shows the version 11.20230109.3.1
, which indicates that this SDK was built and published on January 9, 2023.