// Copyright 2021 Google Inc. All rights reserved. // // 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. package android import ( "fmt" "io/ioutil" "path/filepath" "strings" "github.com/google/blueprint" "github.com/google/blueprint/proptools" ) type bazelModuleProperties struct { // The label of the Bazel target replacing this Soong module. When run in conversion mode, this // will import the handcrafted build target into the autogenerated file. Note: this may result in // a conflict due to duplicate targets if bp2build_available is also set. Label *string // If true, bp2build will generate the converted Bazel target for this module. Note: this may // cause a conflict due to the duplicate targets if label is also set. // // This is a bool pointer to support tristates: true, false, not set. // // To opt-in a module, set bazel_module: { bp2build_available: true } // To opt-out a module, set bazel_module: { bp2build_available: false } // To defer the default setting for the directory, do not set the value. Bp2build_available *bool } // Properties contains common module properties for Bazel migration purposes. type properties struct { // In USE_BAZEL_ANALYSIS=1 mode, this represents the Bazel target replacing // this Soong module. Bazel_module bazelModuleProperties } // BazelModuleBase contains the property structs with metadata for modules which can be converted to // Bazel. type BazelModuleBase struct { bazelProperties properties } // Bazelable is specifies the interface for modules that can be converted to Bazel. type Bazelable interface { bazelProps() *properties HasHandcraftedLabel() bool HandcraftedLabel() string GetBazelLabel(ctx BazelConversionPathContext, module blueprint.Module) string ConvertWithBp2build(ctx BazelConversionPathContext) bool GetBazelBuildFileContents(c Config, path, name string) (string, error) ConvertedToBazel(ctx BazelConversionPathContext) bool } // BazelModule is a lightweight wrapper interface around Module for Bazel-convertible modules. type BazelModule interface { Module Bazelable } // InitBazelModule is a wrapper function that decorates a BazelModule with Bazel-conversion // properties. func InitBazelModule(module BazelModule) { module.AddProperties(module.bazelProps()) } // bazelProps returns the Bazel properties for the given BazelModuleBase. func (b *BazelModuleBase) bazelProps() *properties { return &b.bazelProperties } // HasHandcraftedLabel returns whether this module has a handcrafted Bazel label. func (b *BazelModuleBase) HasHandcraftedLabel() bool { return b.bazelProperties.Bazel_module.Label != nil } // HandcraftedLabel returns the handcrafted label for this module, or empty string if there is none func (b *BazelModuleBase) HandcraftedLabel() string { return proptools.String(b.bazelProperties.Bazel_module.Label) } // GetBazelLabel returns the Bazel label for the given BazelModuleBase. func (b *BazelModuleBase) GetBazelLabel(ctx BazelConversionPathContext, module blueprint.Module) string { if b.HasHandcraftedLabel() { return b.HandcraftedLabel() } if b.ConvertWithBp2build(ctx) { return bp2buildModuleLabel(ctx, module) } return "" // no label for unconverted module } // Configuration to decide if modules in a directory should default to true/false for bp2build_available type Bp2BuildConfig map[string]BazelConversionConfigEntry type BazelConversionConfigEntry int const ( // A sentinel value to be used as a key in Bp2BuildConfig for modules with // no package path. This is also the module dir for top level Android.bp // modules. BP2BUILD_TOPLEVEL = "." // iota + 1 ensures that the int value is not 0 when used in the Bp2buildAllowlist map, // which can also mean that the key doesn't exist in a lookup. // all modules in this package and subpackages default to bp2build_available: true. // allows modules to opt-out. Bp2BuildDefaultTrueRecursively BazelConversionConfigEntry = iota + 1 // all modules in this package (not recursively) default to bp2build_available: false. // allows modules to opt-in. Bp2BuildDefaultFalse ) var ( // Do not write BUILD files for these directories // NOTE: this is not recursive bp2buildDoNotWriteBuildFileList = []string{ // Don't generate these BUILD files - because external BUILD files already exist "external/boringssl", "external/brotli", "external/dagger2", "external/flatbuffers", "external/gflags", "external/google-fruit", "external/grpc-grpc", "external/grpc-grpc/test/core/util", "external/grpc-grpc/test/cpp/common", "external/grpc-grpc/third_party/address_sorting", "external/nanopb-c", "external/nos/host/generic", "external/nos/host/generic/libnos", "external/nos/host/generic/libnos/generator", "external/nos/host/generic/libnos_datagram", "external/nos/host/generic/libnos_transport", "external/nos/host/generic/nugget/proto", "external/perfetto", "external/protobuf", "external/rust/cxx", "external/rust/cxx/demo", "external/ruy", "external/tensorflow", "external/tensorflow/tensorflow/lite", "external/tensorflow/tensorflow/lite/java", "external/tensorflow/tensorflow/lite/kernels", "external/tflite-support", "external/tinyalsa_new", "external/wycheproof", "external/libyuv", } // Configure modules in these directories to enable bp2build_available: true or false by default. bp2buildDefaultConfig = Bp2BuildConfig{ "bionic": Bp2BuildDefaultTrueRecursively, "external/gwp_asan": Bp2BuildDefaultTrueRecursively, "system/core/libcutils": Bp2BuildDefaultTrueRecursively, "system/logging/liblog": Bp2BuildDefaultTrueRecursively, } // Per-module denylist to always opt modules out of both bp2build and mixed builds. bp2buildModuleDoNotConvertList = []string{ "libBionicBenchmarksUtils", // ruperts@, cc_library_static, 'map' file not found "libbionic_spawn_benchmark", // ruperts@, cc_library_static, depends on //system/libbase "libc_jemalloc_wrapper", // ruperts@, cc_library_static, depends on //external/jemalloc_new "libc_bootstrap", // ruperts@, cc_library_static, 'private/bionic_auxv.h' file not found "libc_init_static", // ruperts@, cc_library_static, 'private/bionic_elf_tls.h' file not found "libc_init_dynamic", // ruperts@, cc_library_static, 'private/bionic_defs.h' file not found "libc_tzcode", // ruperts@, cc_library_static, error: expected expression "libc_netbsd", // ruperts@, cc_library_static, 'engine.c' file not found "libc_fortify", // ruperts@, cc_library_static, 'private/bionic_fortify.h' file not found "libc_bionic", // ruperts@, cc_library_static, 'private/bionic_asm.h' file not found "libc_bionic_ndk", // ruperts@, cc_library_static, depends on //bionic/libc/system_properties "libc_bionic_systrace", // ruperts@, cc_library_static, 'private/bionic_systrace.h' file not found "libc_pthread", // ruperts@, cc_library_static, 'private/bionic_defs.h' file not found "libc_syscalls", // eakammer@, cc_library_static, 'private/bionic_asm.h' file not found "libc_ndk", // ruperts@, cc_library_static, depends on //bionic/libm:libm "libc_nopthread", // ruperts@, cc_library_static, depends on //external/arm-optimized-routines "libc_common", // ruperts@, cc_library_static, depends on //bionic/libc:libc_nopthread "libc_common_static", // ruperts@, cc_library_static, depends on //bionic/libc:libc_common "libc_common_shared", // ruperts@, cc_library_static, depends on //bionic/libc:libc_common "libc_unwind_static", // ruperts@, cc_library_static, 'private/bionic_elf_tls.h' file not found "libc_nomalloc", // ruperts@, cc_library_static, depends on //bionic/libc:libc_common "libasync_safe", // ruperts@, cc_library_static, 'private/CachedProperty.h' file not found "libc_malloc_debug_backtrace", // ruperts@, cc_library_static, depends on //system/libbase "libsystemproperties", // ruperts@, cc_library_static, depends on //system/core/property_service/libpropertyinfoparser "libdl_static", // ruperts@, cc_library_static, 'private/CFIShadow.h' file not found "liblinker_main", // ruperts@, cc_library_static, depends on //system/libbase "liblinker_malloc", // ruperts@, cc_library_static, depends on //system/logging/liblog:liblog "liblinker_debuggerd_stub", // ruperts@, cc_library_static, depends on //system/libbase "libbionic_tests_headers_posix", // ruperts@, cc_library_static, 'complex.h' file not found "libc_dns", // ruperts@, cc_library_static, 'private/android_filesystem_config.h' file not found "libc_static_dispatch", // eakammer@, cc_library_static, 'private/bionic_asm.h' file not found "libc_dynamic_dispatch", // eakammer@, cc_library_static, 'private/bionic_ifuncs.h' file not found "note_memtag_heap_async", // jingwen@, cc_library_static, 'private/bionic_asm.h' file not found (arm64) "note_memtag_heap_sync", // jingwen@, cc_library_static, 'private/bionic_asm.h' file not found (arm64) // List of all full_cc_libraries in //bionic, with their immediate failures "libc", // jingwen@, cc_library, depends on //external/gwp_asan "libc_malloc_debug", // jingwen@, cc_library, fatal error: 'assert.h' file not found "libc_malloc_hooks", // jingwen@, cc_library, fatal error: 'errno.h' file not found "libdl", // jingwen@, cc_library, ld.lld: error: no input files "libm", // lberki@, cc_library, compiler error: "Unexpected token in argument list" "libseccomp_policy", // lberki@, cc_library, 'linux/filter.h' not found, caused by missing -isystem bionic/libc/kernel/uapi, dunno where it comes from in Soong "libstdc++", // jingwen@, cc_library, depends on //external/gwp_asan } // Per-module denylist to opt modules out of mixed builds. Such modules will // still be generated via bp2build. mixedBuildsDisabledList = []string{ "libc_gdtoa", // ruperts@, cc_library_static, OK for bp2build but undefined symbol: __strtorQ for mixed builds "libc_openbsd", // ruperts@, cc_library_static, OK for bp2build but error: duplicate symbol: strcpy for mixed builds } // Used for quicker lookups bp2buildDoNotWriteBuildFile = map[string]bool{} bp2buildModuleDoNotConvert = map[string]bool{} mixedBuildsDisabled = map[string]bool{} ) func init() { for _, moduleName := range bp2buildDoNotWriteBuildFileList { bp2buildDoNotWriteBuildFile[moduleName] = true } for _, moduleName := range bp2buildModuleDoNotConvertList { bp2buildModuleDoNotConvert[moduleName] = true } for _, moduleName := range mixedBuildsDisabledList { mixedBuildsDisabled[moduleName] = true } } func ShouldWriteBuildFileForDir(dir string) bool { if _, ok := bp2buildDoNotWriteBuildFile[dir]; ok { return false } else { return true } } // MixedBuildsEnabled checks that a module is ready to be replaced by a // converted or handcrafted Bazel target. func (b *BazelModuleBase) MixedBuildsEnabled(ctx BazelConversionPathContext) bool { if !ctx.Config().BazelContext.BazelEnabled() { return false } if len(b.GetBazelLabel(ctx, ctx.Module())) == 0 { return false } return !mixedBuildsDisabled[ctx.Module().Name()] } // ConvertWithBp2build returns whether the given BazelModuleBase should be converted with bp2build. func (b *BazelModuleBase) ConvertWithBp2build(ctx BazelConversionPathContext) bool { if bp2buildModuleDoNotConvert[ctx.Module().Name()] { return false } // Ensure that the module type of this module has a bp2build converter. This // prevents mixed builds from using auto-converted modules just by matching // the package dir; it also has to have a bp2build mutator as well. if ctx.Config().bp2buildModuleTypeConfig[ctx.ModuleType()] == false { return false } packagePath := ctx.ModuleDir() config := ctx.Config().bp2buildPackageConfig // This is a tristate value: true, false, or unset. propValue := b.bazelProperties.Bazel_module.Bp2build_available if bp2buildDefaultTrueRecursively(packagePath, config) { // Allow modules to explicitly opt-out. return proptools.BoolDefault(propValue, true) } // Allow modules to explicitly opt-in. return proptools.BoolDefault(propValue, false) } // bp2buildDefaultTrueRecursively checks that the package contains a prefix from the // set of package prefixes where all modules must be converted. That is, if the // package is x/y/z, and the list contains either x, x/y, or x/y/z, this function will // return true. // // However, if the package is x/y, and it matches a Bp2BuildDefaultFalse "x/y" entry // exactly, this module will return false early. // // This function will also return false if the package doesn't match anything in // the config. func bp2buildDefaultTrueRecursively(packagePath string, config Bp2BuildConfig) bool { ret := false // Return exact matches in the config. if config[packagePath] == Bp2BuildDefaultTrueRecursively { return true } if config[packagePath] == Bp2BuildDefaultFalse { return false } // If not, check for the config recursively. packagePrefix := "" // e.g. for x/y/z, iterate over x, x/y, then x/y/z, taking the final value from the allowlist. for _, part := range strings.Split(packagePath, "/") { packagePrefix += part if config[packagePrefix] == Bp2BuildDefaultTrueRecursively { // package contains this prefix and this prefix should convert all modules return true } // Continue to the next part of the package dir. packagePrefix += "/" } return ret } // GetBazelBuildFileContents returns the file contents of a hand-crafted BUILD file if available or // an error if there are errors reading the file. // TODO(b/181575318): currently we append the whole BUILD file, let's change that to do // something more targeted based on the rule type and target. func (b *BazelModuleBase) GetBazelBuildFileContents(c Config, path, name string) (string, error) { if !strings.Contains(b.HandcraftedLabel(), path) { return "", fmt.Errorf("%q not found in bazel_module.label %q", path, b.HandcraftedLabel()) } name = filepath.Join(path, name) f, err := c.fs.Open(name) if err != nil { return "", err } defer f.Close() data, err := ioutil.ReadAll(f) if err != nil { return "", err } return string(data[:]), nil } // ConvertedToBazel returns whether this module has been converted to Bazel, whether automatically // or manually func (b *BazelModuleBase) ConvertedToBazel(ctx BazelConversionPathContext) bool { return b.ConvertWithBp2build(ctx) || b.HasHandcraftedLabel() }