crosvm/libcras_stub/README.md

# Stub crate for libcras

libcras is used by ChromeOS to play audio through the cras server.

In ChromeOS builds, the `audio_cras` cargo feature is enabled and this crate is
replaced with the actual [libcras] implementation.

On other platforms, the feature flag will remain disabled and this crate is used
to satisfy cargo dependencies on libcras.

[libcras]:
    https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/third_party/adhd/cras/client/libcras/
Integrate audio_streams into crosvm, add stub libcras implementation The `# ignored by ebuild` tag will remove the path to libcras_stub and allows crosvm to be built with the actual libcras implementation. This allows all other platforms to build without depending on `third_party/adhd/cras/client/libcras`, which is a prerequisite for externalizing crosvm. An empty libcras_stub crate is provided to keep cargo happy in external builds. To build with cargo against libcras, the setup_cros_cargo.sh script can be used. BUG=b:191511078 TEST=Tests in crosvm and cros_sdk both pass: $ ./test_all $ cros_run_unit_tests --package=crosvm Cq-Depend: chromium:2993483 Change-Id: I86aad23a86c78e580c1724fb311f870b25d6b09e Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/crosvm/+/2988154 Tested-by: kokoro <noreply+kokoro@google.com> Commit-Queue: Dennis Kempin <denniskempin@google.com> Reviewed-by: Chih-Yang Hsia <paulhsia@chromium.org> 2021-06-23 18:34:31 +00:00			`# Stub crate for libcras`

			`libcras is used by ChromeOS to play audio through the cras server.`

			In ChromeOS builds, the `audio_cras` cargo feature is enabled and this crate is
			`replaced with the actual [libcras] implementation.`

			`On other platforms, the feature flag will remain disabled and this crate is used`
			`to satisfy cargo dependencies on libcras.`

			`[libcras]:`
			`https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/third_party/adhd/cras/client/libcras/`