// Copyright 2015 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 ( "github.com/google/blueprint" ) // Phases: // run Pre-arch mutators // run archMutator // run Pre-deps mutators // run depsMutator // run PostDeps mutators // continue on to GenerateAndroidBuildActions func registerMutatorsToContext(ctx *blueprint.Context, mutators []*mutator) { for _, t := range mutators { var handle blueprint.MutatorHandle if t.bottomUpMutator != nil { handle = ctx.RegisterBottomUpMutator(t.name, t.bottomUpMutator) } else if t.topDownMutator != nil { handle = ctx.RegisterTopDownMutator(t.name, t.topDownMutator) } if t.parallel { handle.Parallel() } } } func registerMutators(ctx *blueprint.Context, preArch, preDeps, postDeps []RegisterMutatorFunc) { mctx := ®isterMutatorsContext{} register := func(funcs []RegisterMutatorFunc) { for _, f := range funcs { f(mctx) } } register(preArch) register(preDeps) mctx.BottomUp("deps", depsMutator).Parallel() register(postDeps) registerMutatorsToContext(ctx, mctx.mutators) } type registerMutatorsContext struct { mutators []*mutator } type RegisterMutatorsContext interface { TopDown(name string, m AndroidTopDownMutator) MutatorHandle BottomUp(name string, m AndroidBottomUpMutator) MutatorHandle } type RegisterMutatorFunc func(RegisterMutatorsContext) var preArch = []RegisterMutatorFunc{ func(ctx RegisterMutatorsContext) { ctx.TopDown("load_hooks", loadHookMutator).Parallel() }, RegisterPrebuiltsPreArchMutators, RegisterDefaultsPreArchMutators, } func registerArchMutator(ctx RegisterMutatorsContext) { ctx.BottomUp("arch", archMutator).Parallel() ctx.TopDown("arch_hooks", archHookMutator).Parallel() } var preDeps = []RegisterMutatorFunc{ registerArchMutator, } var postDeps = []RegisterMutatorFunc{ RegisterPrebuiltsPostDepsMutators, } func PreArchMutators(f RegisterMutatorFunc) { preArch = append(preArch, f) } func PreDepsMutators(f RegisterMutatorFunc) { preDeps = append(preDeps, f) } func PostDepsMutators(f RegisterMutatorFunc) { postDeps = append(postDeps, f) } type AndroidTopDownMutator func(TopDownMutatorContext) type TopDownMutatorContext interface { blueprint.BaseModuleContext androidBaseContext OtherModuleExists(name string) bool Rename(name string) Module() blueprint.Module OtherModuleName(m blueprint.Module) string OtherModuleErrorf(m blueprint.Module, fmt string, args ...interface{}) OtherModuleDependencyTag(m blueprint.Module) blueprint.DependencyTag CreateModule(blueprint.ModuleFactory, ...interface{}) GetDirectDepWithTag(name string, tag blueprint.DependencyTag) blueprint.Module GetDirectDep(name string) (blueprint.Module, blueprint.DependencyTag) VisitDirectDeps(visit func(Module)) VisitDirectDepsIf(pred func(Module) bool, visit func(Module)) VisitDepsDepthFirst(visit func(Module)) VisitDepsDepthFirstIf(pred func(Module) bool, visit func(Module)) WalkDeps(visit func(Module, Module) bool) } type androidTopDownMutatorContext struct { blueprint.TopDownMutatorContext androidBaseContextImpl } type AndroidBottomUpMutator func(BottomUpMutatorContext) type BottomUpMutatorContext interface { blueprint.BottomUpMutatorContext androidBaseContext } type androidBottomUpMutatorContext struct { blueprint.BottomUpMutatorContext androidBaseContextImpl } func (x *registerMutatorsContext) BottomUp(name string, m AndroidBottomUpMutator) MutatorHandle { f := func(ctx blueprint.BottomUpMutatorContext) { if a, ok := ctx.Module().(Module); ok { actx := &androidBottomUpMutatorContext{ BottomUpMutatorContext: ctx, androidBaseContextImpl: a.base().androidBaseContextFactory(ctx), } m(actx) } } mutator := &mutator{name: name, bottomUpMutator: f} x.mutators = append(x.mutators, mutator) return mutator } func (x *registerMutatorsContext) TopDown(name string, m AndroidTopDownMutator) MutatorHandle { f := func(ctx blueprint.TopDownMutatorContext) { if a, ok := ctx.Module().(Module); ok { actx := &androidTopDownMutatorContext{ TopDownMutatorContext: ctx, androidBaseContextImpl: a.base().androidBaseContextFactory(ctx), } m(actx) } } mutator := &mutator{name: name, topDownMutator: f} x.mutators = append(x.mutators, mutator) return mutator } type MutatorHandle interface { Parallel() MutatorHandle } func (mutator *mutator) Parallel() MutatorHandle { mutator.parallel = true return mutator } func depsMutator(ctx BottomUpMutatorContext) { if m, ok := ctx.Module().(Module); ok { m.DepsMutator(ctx) } } func (a *androidTopDownMutatorContext) VisitDirectDeps(visit func(Module)) { a.TopDownMutatorContext.VisitDirectDeps(func(module blueprint.Module) { if aModule, _ := module.(Module); aModule != nil { visit(aModule) } }) } func (a *androidTopDownMutatorContext) VisitDirectDepsIf(pred func(Module) bool, visit func(Module)) { a.TopDownMutatorContext.VisitDirectDepsIf( // pred func(module blueprint.Module) bool { if aModule, _ := module.(Module); aModule != nil { return pred(aModule) } else { return false } }, // visit func(module blueprint.Module) { visit(module.(Module)) }) } func (a *androidTopDownMutatorContext) VisitDepsDepthFirst(visit func(Module)) { a.TopDownMutatorContext.VisitDepsDepthFirst(func(module blueprint.Module) { if aModule, _ := module.(Module); aModule != nil { visit(aModule) } }) } func (a *androidTopDownMutatorContext) VisitDepsDepthFirstIf(pred func(Module) bool, visit func(Module)) { a.TopDownMutatorContext.VisitDepsDepthFirstIf( // pred func(module blueprint.Module) bool { if aModule, _ := module.(Module); aModule != nil { return pred(aModule) } else { return false } }, // visit func(module blueprint.Module) { visit(module.(Module)) }) } func (a *androidTopDownMutatorContext) WalkDeps(visit func(Module, Module) bool) { a.TopDownMutatorContext.WalkDeps(func(child, parent blueprint.Module) bool { childAndroidModule, _ := child.(Module) parentAndroidModule, _ := parent.(Module) if childAndroidModule != nil && parentAndroidModule != nil { return visit(childAndroidModule, parentAndroidModule) } else { return false } }) }