Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 89fcdcb7 authored by Lukacs T. Berki's avatar Lukacs T. Berki
Browse files

Refactor the creation of soong_build calls. 

They were a bit repetitive.

In addition, make the environment checks more correct; they could
probably use an integration test or two to make sure that when the
environment changes, exactly those outputs are rebuilt that need to be,
but for now, this is an improvement already.

Test: Presubmits.
Change-Id: Idd79b81ca6975d57d00e5bf4699d266152505ff8
parent c6012f36

README.md

+0 −1
Original line number Diff line number Diff line
@@ -37,7 +37,6 @@ The list of valid module types and their properties can be generated by calling 
`m soong_docs`. It will be written to `$OUT_DIR/soong/docs/soong_build.html`.

This list for the current version of Soong can be found [here](https://ci.android.com/builds/latest/branches/aosp-build-tools/targets/linux/view/soong_build.html).





### File lists



Properties that take a list of files can also take glob patterns and output path

android/config.go

+7 −7
Original line number Diff line number Diff line
@@ -418,8 +418,8 @@ func TestArchConfig(buildDir string, env map[string]string, bp string, fs map[st 
// bootstrap run. Only per-run data is reset. Data which needs to persist across

// multiple runs in the same program execution is carried over (such as Bazel

// context or environment deps).

func ConfigForAdditionalRun(cmdlineArgs bootstrap.Args, c Config) (Config, error) {

	newConfig, err := NewConfig(cmdlineArgs, c.soongOutDir, c.env)

func ConfigForAdditionalRun(c Config) (Config, error) {

	newConfig, err := NewConfig(c.moduleListFile, c.runGoTests, c.outDir, c.soongOutDir, c.env)

	if err != nil {

		return Config{}, err

	}
@@ -430,20 +430,20 @@ func ConfigForAdditionalRun(cmdlineArgs bootstrap.Args, c Config) (Config, error 


// NewConfig creates a new Config object. The srcDir argument specifies the path

// to the root source directory. It also loads the config file, if found.

func NewConfig(cmdlineArgs bootstrap.Args, soongOutDir string, availableEnv map[string]string) (Config, error) {

func NewConfig(moduleListFile string, runGoTests bool, outDir, soongOutDir string, availableEnv map[string]string) (Config, error) {

	// Make a config with default options.

	config := &config{

		ProductVariablesFileName: filepath.Join(soongOutDir, productVariablesFileName),



		env: availableEnv,



		outDir:                   cmdlineArgs.OutDir,

		outDir:                   outDir,

		soongOutDir:              soongOutDir,

		runGoTests:               cmdlineArgs.RunGoTests,

		useValidationsForGoTests: cmdlineArgs.UseValidations,

		runGoTests:               runGoTests,

		useValidationsForGoTests: runGoTests,

		multilibConflicts:        make(map[ArchType]bool),



		moduleListFile: cmdlineArgs.ModuleListFile,

		moduleListFile: moduleListFile,

		fs:             pathtools.NewOsFs(absSrcDir),

	}

cmd/soong_build/main.go

+14 −16
Original line number Diff line number Diff line
@@ -35,10 +35,13 @@ import ( 


var (

	topDir           string

	outDir           string

	soongOutDir      string

	availableEnvFile string

	usedEnvFile      string



	runGoTests bool



	globFile    string

	globListDir string

	delveListen string
@@ -60,7 +63,7 @@ func init() { 
	flag.StringVar(&usedEnvFile, "used_env", "", "File containing used environment variables")

	flag.StringVar(&globFile, "globFile", "build-globs.ninja", "the Ninja file of globs to output")

	flag.StringVar(&globListDir, "globListDir", "", "the directory containing the glob list files")

	flag.StringVar(&cmdlineArgs.OutDir, "out", "", "the ninja builddir directory")

	flag.StringVar(&outDir, "out", "", "the ninja builddir directory")

	flag.StringVar(&cmdlineArgs.ModuleListFile, "l", "", "file that lists filepaths to parse")



	// Debug flags
@@ -81,8 +84,7 @@ func init() { 


	// Flags that probably shouldn't be flags of soong_build but we haven't found

	// the time to remove them yet

	flag.BoolVar(&cmdlineArgs.RunGoTests, "t", false, "build and run go tests during bootstrap")

	flag.BoolVar(&cmdlineArgs.UseValidations, "use-validations", false, "use validations to depend on go tests")

	flag.BoolVar(&runGoTests, "t", false, "build and run go tests during bootstrap")

}



func newNameResolver(config android.Config) *android.NameResolver {
@@ -109,8 +111,8 @@ func newContext(configuration android.Config) *android.Context { 
	return ctx

}



func newConfig(cmdlineArgs bootstrap.Args, outDir string, availableEnv map[string]string) android.Config {

	configuration, err := android.NewConfig(cmdlineArgs, outDir, availableEnv)

func newConfig(availableEnv map[string]string) android.Config {

	configuration, err := android.NewConfig(cmdlineArgs.ModuleListFile, runGoTests, outDir, soongOutDir, availableEnv)

	if err != nil {

		fmt.Fprintf(os.Stderr, "%s", err)

		os.Exit(1)
@@ -124,10 +126,7 @@ func newConfig(cmdlineArgs bootstrap.Args, outDir string, availableEnv map[strin 
// TODO(cparsons): Don't output any ninja file, as the second pass will overwrite

// the incorrect results from the first pass, and file I/O is expensive.

func runMixedModeBuild(configuration android.Config, firstCtx *android.Context, extraNinjaDeps []string) {

	var firstArgs, secondArgs bootstrap.Args



	firstArgs = cmdlineArgs

	bootstrap.RunBlueprint(firstArgs, bootstrap.StopBeforeWriteNinja, firstCtx.Context, configuration)

	bootstrap.RunBlueprint(cmdlineArgs, bootstrap.StopBeforeWriteNinja, firstCtx.Context, configuration)



	// Invoke bazel commands and save results for second pass.

	if err := configuration.BazelContext.InvokeBazel(); err != nil {
@@ -135,20 +134,19 @@ func runMixedModeBuild(configuration android.Config, firstCtx *android.Context, 
		os.Exit(1)

	}

	// Second pass: Full analysis, using the bazel command results. Output ninja file.

	secondArgs = cmdlineArgs

	secondConfig, err := android.ConfigForAdditionalRun(secondArgs, configuration)

	secondConfig, err := android.ConfigForAdditionalRun(configuration)

	if err != nil {

		fmt.Fprintf(os.Stderr, "%s", err)

		os.Exit(1)

	}

	secondCtx := newContext(secondConfig)

	ninjaDeps := bootstrap.RunBlueprint(secondArgs, bootstrap.DoEverything, secondCtx.Context, secondConfig)

	ninjaDeps := bootstrap.RunBlueprint(cmdlineArgs, bootstrap.DoEverything, secondCtx.Context, secondConfig)

	ninjaDeps = append(ninjaDeps, extraNinjaDeps...)



	globListFiles := writeBuildGlobsNinjaFile(secondCtx.SrcDir(), configuration.SoongOutDir(), secondCtx.Globs, configuration)

	ninjaDeps = append(ninjaDeps, globListFiles...)



	writeDepFile(secondArgs.OutFile, ninjaDeps)

	writeDepFile(cmdlineArgs.OutFile, ninjaDeps)

}



// Run the code-generation phase to convert BazelTargetModules to BUILD files.
@@ -306,7 +304,7 @@ func main() { 


	availableEnv := parseAvailableEnv()



	configuration := newConfig(cmdlineArgs, soongOutDir, availableEnv)

	configuration := newConfig(availableEnv)

	extraNinjaDeps := []string{

		configuration.ProductVariablesFileName,

		usedEnvFile,
@@ -500,8 +498,8 @@ func runBp2Build(configuration android.Config, extraNinjaDeps []string) { 
		"bazel-" + filepath.Base(topDir),

	}



	if cmdlineArgs.OutDir[0] != '/' {

		excludes = append(excludes, cmdlineArgs.OutDir)

	if outDir[0] != '/' {

		excludes = append(excludes, outDir)

	}



	existingBazelRelatedFiles, err := getExistingBazelRelatedFiles(topDir)

ui/build/config.go

+4 −3
Original line number Diff line number Diff line
@@ -111,9 +111,6 @@ const ( 
	// Don't use bazel at all.

	noBazel bazelBuildMode = iota



	// Only generate build files (in a subdirectory of the out directory) and exit.

	generateBuildFiles



	// Generate synthetic build files and incorporate these files into a build which

	// partially uses Bazel. Build metadata may come from Android.bp or BUILD files.

	mixedBuild
@@ -783,6 +780,10 @@ func (c *configImpl) HostToolDir() string { 
	return filepath.Join(c.SoongOutDir(), "host", c.PrebuiltOS(), "bin")

}



func (c *configImpl) NamedGlobFile(name string) string {

	return shared.JoinPath(c.SoongOutDir(), ".bootstrap/build-globs."+name+".ninja")

}



func (c *configImpl) MainNinjaFile() string {

	return shared.JoinPath(c.SoongOutDir(), "build.ninja")

}

ui/build/soong.go

+127 −132
Original line number Diff line number Diff line
@@ -37,6 +37,12 @@ import ( 
const (

	availableEnvFile = "soong.environment.available"

	usedEnvFile      = "soong.environment.used"



	soongBuildTag      = "build"

	bp2buildTag        = "bp2build"

	jsonModuleGraphTag = "modulegraph"

	queryviewTag       = "queryview"

	soongDocsTag       = "soong_docs"

)



func writeEnvironmentFile(ctx Context, envFile string, envDeps map[string]string) error {
@@ -116,7 +122,7 @@ func (c BlueprintConfig) PrimaryBuilderInvocations() []bootstrap.PrimaryBuilderI 
func environmentArgs(config Config, suffix string) []string {

	return []string{

		"--available_env", shared.JoinPath(config.SoongOutDir(), availableEnvFile),

		"--used_env", shared.JoinPath(config.SoongOutDir(), usedEnvFile+suffix),

		"--used_env", shared.JoinPath(config.SoongOutDir(), usedEnvFile+"."+suffix),

	}

}
@@ -134,139 +140,112 @@ func writeEmptyGlobFile(ctx Context, path string) { 
	}

}



func bootstrapBlueprint(ctx Context, config Config) {

	ctx.BeginTrace(metrics.RunSoong, "blueprint bootstrap")

	defer ctx.EndTrace()



	var args bootstrap.Args



	bootstrapGlobFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build-globs.ninja")

	bp2buildGlobFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build-globs.bp2build.ninja")

	queryviewGlobFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build-globs.queryview.ninja")

	soongDocsGlobFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build-globs.soong_docs.ninja")

	moduleGraphGlobFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build-globs.modulegraph.ninja")



	// The glob .ninja files are subninja'd. However, they are generated during

	// the build itself so we write an empty file so that the subninja doesn't

	// fail on clean builds

	writeEmptyGlobFile(ctx, bootstrapGlobFile)

	writeEmptyGlobFile(ctx, bp2buildGlobFile)

	writeEmptyGlobFile(ctx, queryviewGlobFile)

	writeEmptyGlobFile(ctx, soongDocsGlobFile)

	writeEmptyGlobFile(ctx, moduleGraphGlobFile)



	bootstrapDepFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build.ninja.d")



	args.RunGoTests = !config.skipSoongTests

	args.UseValidations = true // Use validations to depend on tests

	args.SoongOutDir = config.SoongOutDir()

	args.OutDir = config.OutDir()

	args.ModuleListFile = filepath.Join(config.FileListDir(), "Android.bp.list")

	args.OutFile = shared.JoinPath(config.SoongOutDir(), ".bootstrap/build.ninja")

	// The primary builder (aka soong_build) will use bootstrapGlobFile as the globFile to generate build.ninja(.d)

	// Building soong_build does not require a glob file

	// Using "" instead of "<soong_build_glob>.ninja" will ensure that an unused glob file is not written to out/soong/.bootstrap during StagePrimary

	args.Subninjas = []string{bootstrapGlobFile, bp2buildGlobFile, moduleGraphGlobFile, queryviewGlobFile, soongDocsGlobFile}

	args.EmptyNinjaFile = config.EmptyNinjaFile()

func primaryBuilderInvocation(config Config, name string, output string, specificArgs []string) bootstrap.PrimaryBuilderInvocation {

	commonArgs := make([]string, 0, 0)



	args.DelveListen = os.Getenv("SOONG_DELVE")

	if args.DelveListen != "" {

		args.DelvePath = shared.ResolveDelveBinary()

	if !config.skipSoongTests {

		commonArgs = append(commonArgs, "-t")

	}



	commonArgs := bootstrap.PrimaryBuilderExtraFlags(args, config.MainNinjaFile())

	mainSoongBuildInputs := []string{"Android.bp"}

	commonArgs = append(commonArgs, "-l", filepath.Join(config.FileListDir(), "Android.bp.list"))



	if config.bazelBuildMode() == mixedBuild {

		mainSoongBuildInputs = append(mainSoongBuildInputs, config.Bp2BuildMarkerFile())

	if os.Getenv("SOONG_DELVE") != "" {

		commonArgs = append(commonArgs, "--delve_listen", os.Getenv("SOONG_DELVE"))

		commonArgs = append(commonArgs, "--delve_path", shared.ResolveDelveBinary())

	}



	soongBuildArgs := []string{

		"--globListDir", "build",

		"--globFile", bootstrapGlobFile,

	}

	allArgs := make([]string, 0, 0)

	allArgs = append(allArgs, specificArgs...)

	allArgs = append(allArgs,

		"--globListDir", name,

		"--globFile", config.NamedGlobFile(name))



	soongBuildArgs = append(soongBuildArgs, commonArgs...)

	soongBuildArgs = append(soongBuildArgs, environmentArgs(config, "")...)

	soongBuildArgs = append(soongBuildArgs, "Android.bp")

	allArgs = append(allArgs, commonArgs...)

	allArgs = append(allArgs, environmentArgs(config, name)...)

	allArgs = append(allArgs, "Android.bp")



	mainSoongBuildInvocation := bootstrap.PrimaryBuilderInvocation{

		Inputs:  mainSoongBuildInputs,

		Outputs: []string{config.MainNinjaFile()},

		Args:    soongBuildArgs,

	return bootstrap.PrimaryBuilderInvocation{

		Inputs:  []string{"Android.bp"},

		Outputs: []string{output},

		Args:    allArgs,

	}



	bp2buildArgs := []string{

		"--bp2build_marker", config.Bp2BuildMarkerFile(),

		"--globListDir", "bp2build",

		"--globFile", bp2buildGlobFile,

}



	bp2buildArgs = append(bp2buildArgs, commonArgs...)

	bp2buildArgs = append(bp2buildArgs, environmentArgs(config, ".bp2build")...)

	bp2buildArgs = append(bp2buildArgs, "Android.bp")

func bootstrapBlueprint(ctx Context, config Config) {

	ctx.BeginTrace(metrics.RunSoong, "blueprint bootstrap")

	defer ctx.EndTrace()



	bp2buildInvocation := bootstrap.PrimaryBuilderInvocation{

		Inputs:  []string{"Android.bp"},

		Outputs: []string{config.Bp2BuildMarkerFile()},

		Args:    bp2buildArgs,

	mainSoongBuildExtraArgs := []string{"-o", config.MainNinjaFile()}

	if config.EmptyNinjaFile() {

		mainSoongBuildExtraArgs = append(mainSoongBuildExtraArgs, "--empty-ninja-file")

	}



	queryviewArgs := []string{

		"--bazel_queryview_dir", filepath.Join(config.SoongOutDir(), "queryview"),

		"--globListDir", "queryview",

		"--globFile", queryviewGlobFile,

	}

	mainSoongBuildInvocation := primaryBuilderInvocation(

		config,

		soongBuildTag,

		config.MainNinjaFile(),

		mainSoongBuildExtraArgs)



	queryviewArgs = append(queryviewArgs, commonArgs...)

	queryviewArgs = append(queryviewArgs, environmentArgs(config, ".queryview")...)

	queryviewArgs = append(queryviewArgs, "Android.bp")

	if config.bazelBuildMode() == mixedBuild {

		// Mixed builds call Bazel from soong_build and they therefore need the

		// Bazel workspace to be available. Make that so by adding a dependency on

		// the bp2build marker file to the action that invokes soong_build .

		mainSoongBuildInvocation.Inputs = append(mainSoongBuildInvocation.Inputs,

			config.Bp2BuildMarkerFile())

	}



	bp2buildInvocation := primaryBuilderInvocation(

		config,

		bp2buildTag,

		config.Bp2BuildMarkerFile(),

		[]string{

			"--bp2build_marker", config.Bp2BuildMarkerFile(),

		})



	queryviewInvocation := bootstrap.PrimaryBuilderInvocation{

		Inputs:  []string{"Android.bp"},

		Outputs: []string{config.QueryviewMarkerFile()},

		Args:    queryviewArgs,

	}

	jsonModuleGraphInvocation := primaryBuilderInvocation(

		config,

		jsonModuleGraphTag,

		config.ModuleGraphFile(),

		[]string{

			"--module_graph_file", config.ModuleGraphFile(),

		})



	soongDocsArgs := []string{

		"--soong_docs", config.SoongDocsHtml(),

		"--globListDir", "soong_docs",

		"--globFile", soongDocsGlobFile,

	}

	queryviewInvocation := primaryBuilderInvocation(

		config,

		queryviewTag,

		config.QueryviewMarkerFile(),

		[]string{

			"--bazel_queryview_dir", filepath.Join(config.SoongOutDir(), "queryview"),

		})



	soongDocsArgs = append(soongDocsArgs, commonArgs...)

	soongDocsArgs = append(soongDocsArgs, environmentArgs(config, ".soong_docs")...)

	soongDocsArgs = append(soongDocsArgs, "Android.bp")

	soongDocsInvocation := primaryBuilderInvocation(

		config,

		soongDocsTag,

		config.SoongDocsHtml(),

		[]string{

			"--soong_docs", config.SoongDocsHtml(),

		})



	soongDocsInvocation := bootstrap.PrimaryBuilderInvocation{

		Inputs:  []string{"Android.bp"},

		Outputs: []string{config.SoongDocsHtml()},

		Args:    soongDocsArgs,

	globFiles := []string{

		config.NamedGlobFile(soongBuildTag),

		config.NamedGlobFile(bp2buildTag),

		config.NamedGlobFile(jsonModuleGraphTag),

		config.NamedGlobFile(queryviewTag),

		config.NamedGlobFile(soongDocsTag),

	}



	moduleGraphArgs := []string{

		"--module_graph_file", config.ModuleGraphFile(),

		"--globListDir", "modulegraph",

		"--globFile", moduleGraphGlobFile,

	// The glob .ninja files are subninja'd. However, they are generated during

	// the build itself so we write an empty file if the file does not exist yet

	// so that the subninja doesn't fail on clean builds

	for _, globFile := range globFiles {

		writeEmptyGlobFile(ctx, globFile)

	}



	moduleGraphArgs = append(moduleGraphArgs, commonArgs...)

	moduleGraphArgs = append(moduleGraphArgs, environmentArgs(config, ".modulegraph")...)

	moduleGraphArgs = append(moduleGraphArgs, "Android.bp")

	var blueprintArgs bootstrap.Args



	moduleGraphInvocation := bootstrap.PrimaryBuilderInvocation{

		Inputs:  []string{"Android.bp"},

		Outputs: []string{config.ModuleGraphFile()},

		Args:    moduleGraphArgs,

	}



	args.PrimaryBuilderInvocations = []bootstrap.PrimaryBuilderInvocation{

		bp2buildInvocation,

		mainSoongBuildInvocation,

		moduleGraphInvocation,

		queryviewInvocation,

		soongDocsInvocation,

	}

	blueprintArgs.ModuleListFile = filepath.Join(config.FileListDir(), "Android.bp.list")

	blueprintArgs.OutFile = shared.JoinPath(config.SoongOutDir(), ".bootstrap/build.ninja")

	blueprintArgs.EmptyNinjaFile = false



	blueprintCtx := blueprint.NewContext()

	blueprintCtx.SetIgnoreUnknownModuleTypes(true)
@@ -275,15 +254,21 @@ func bootstrapBlueprint(ctx Context, config Config) { 
		toolDir:        config.HostToolDir(),

		outDir:         config.OutDir(),

		runGoTests:     !config.skipSoongTests,

		useValidations:            true,

		useValidations: !config.skipSoongTests,

		// If we want to debug soong_build, we need to compile it for debugging

		debugCompilation: os.Getenv("SOONG_DELVE") != "",

		subninjas:                 args.Subninjas,

		primaryBuilderInvocations: args.PrimaryBuilderInvocations,

		subninjas:        globFiles,

		primaryBuilderInvocations: []bootstrap.PrimaryBuilderInvocation{

			mainSoongBuildInvocation,

			bp2buildInvocation,

			jsonModuleGraphInvocation,

			queryviewInvocation,

			soongDocsInvocation},

	}



	args.EmptyNinjaFile = false

	bootstrapDeps := bootstrap.RunBlueprint(args, bootstrap.DoEverything, blueprintCtx, blueprintConfig)

	err := deptools.WriteDepFile(bootstrapDepFile, args.OutFile, bootstrapDeps)

	bootstrapDeps := bootstrap.RunBlueprint(blueprintArgs, bootstrap.DoEverything, blueprintCtx, blueprintConfig)

	bootstrapDepFile := shared.JoinPath(config.SoongOutDir(), ".bootstrap/build.ninja.d")

	err := deptools.WriteDepFile(bootstrapDepFile, blueprintArgs.OutFile, bootstrapDeps)

	if err != nil {

		ctx.Fatalf("Error writing depfile '%s': %s", bootstrapDepFile, err)

	}
@@ -343,12 +328,22 @@ func runSoong(ctx Context, config Config) { 
		ctx.BeginTrace(metrics.RunSoong, "environment check")

		defer ctx.EndTrace()



		soongBuildEnvFile := filepath.Join(config.SoongOutDir(), usedEnvFile)

		checkEnvironmentFile(soongBuildEnv, soongBuildEnvFile)

		checkEnvironmentFile(soongBuildEnv, filepath.Join(config.SoongOutDir(), usedEnvFile+".build"))



		if integratedBp2Build {

			bp2buildEnvFile := filepath.Join(config.SoongOutDir(), usedEnvFile+".bp2build")

			checkEnvironmentFile(soongBuildEnv, bp2buildEnvFile)

		if integratedBp2Build || config.Bp2Build() {

			checkEnvironmentFile(soongBuildEnv, filepath.Join(config.SoongOutDir(), usedEnvFile+".bp2build"))

		}



		if config.JsonModuleGraph() {

			checkEnvironmentFile(soongBuildEnv, filepath.Join(config.SoongOutDir(), usedEnvFile+".modulegraph"))

		}



		if config.Queryview() {

			checkEnvironmentFile(soongBuildEnv, filepath.Join(config.SoongOutDir(), usedEnvFile+".queryview"))

		}



		if config.SoongDocs() {

			checkEnvironmentFile(soongBuildEnv, filepath.Join(config.SoongOutDir(), usedEnvFile+".soong_docs"))

		}

	}()