summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Maennich <maennich@google.com>2024-05-08 15:50:09 +0000
committerMatthias Männich <maennich@google.com>2024-05-08 23:05:26 +0000
commit6725d1566cb246bf7b3f1eb1257ee7938bc01830 (patch)
tree054633f05fc37d0d1a7b1dd01c4199ddf975eb1b
parent14ac1c98d4a280c1f2e239c24f9c1ff3a7688791 (diff)
downloadbuild-6725d1566cb246bf7b3f1eb1257ee7938bc01830.tar.gz
Kleaf: add --config=canary configuration for early adopters
When building with --config=canary, users can opt-in to enable future features of Kleaf and the DDK. Think of it as beta version where the Kleaf team enables features for early adopters that _should be ok_ to use, but not yet for production. Bug: 339377804 Change-Id: I271d104d6c7eaf0509339d2eb5972213e956222a Signed-off-by: Matthias Maennich <maennich@google.com>
-rw-r--r--kleaf/bazelrc/canary.bazelrc22
-rw-r--r--kleaf/docs/canary.md13
2 files changed, 35 insertions, 0 deletions
diff --git a/kleaf/bazelrc/canary.bazelrc b/kleaf/bazelrc/canary.bazelrc
new file mode 100644
index 0000000..afa8455
--- /dev/null
+++ b/kleaf/bazelrc/canary.bazelrc
@@ -0,0 +1,22 @@
+# Copyright (C) 2024 The Android Open Source Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# --config=canary: Enable future features for Kleaf.
+#
+# Some of the features are experimental, most of them will be default in future
+# releases and some of them might get discontinued.
+
+# Enable building the toolchain from sources.
+build:canary --//build/kernel/kleaf:toolchain_from_sources
+
diff --git a/kleaf/docs/canary.md b/kleaf/docs/canary.md
new file mode 100644
index 0000000..624df94
--- /dev/null
+++ b/kleaf/docs/canary.md
@@ -0,0 +1,13 @@
+# Kleaf Canary
+
+Setting `--config=canary` opts into future features of Kleaf and the DDK. Think
+of it as beta version where the Kleaf team enables features for early adopters
+that _should be ok_ to use, but not yet for production.
+
+Some of the features are experimental, most of them will be default in future
+releases and some of them might get discontinued.
+
+As of now, `--config=canary` enables:
+ - `--toolchain_from_sources`: Build (some) build time dependencies from
+ sources, like `toybox`.
+