// 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 java // This file contains the module types for compiling Java for Android, and converts the properties // into the flags and filenames necessary to pass to the compiler. The final creation of the rules // is handled in builder.go import ( "fmt" "path/filepath" "strings" "github.com/google/blueprint" "github.com/google/blueprint/pathtools" "android/soong/common" "android/soong/genrule" ) // TODO: // Autogenerated files: // Proto // Renderscript // Post-jar passes: // Proguard // Emma // Jarjar // Dex // Rmtypedefs // Jack // DroidDoc // Findbugs // javaBase contains the properties and members used by all java module types, and implements // the blueprint.Module interface. type javaBase struct { common.AndroidModuleBase module JavaModuleType properties struct { // srcs: list of source files used to compile the Java module. May be .java, .logtags, .proto, // or .aidl files. Srcs []string `android:"arch_variant,arch_subtract"` // java_resource_dirs: list of directories containing Java resources Java_resource_dirs []string `android:"arch_variant"` // no_standard_libraries: don't build against the default libraries (core-libart, core-junit, // ext, and framework for device targets) No_standard_libraries bool // javacflags: list of module-specific flags that will be used for javac compiles Javacflags []string `android:"arch_variant"` // jack_flags: list of module-specific flags that will be used for jack compiles Jack_flags []string `android:"arch_variant"` // dxflags: list of module-specific flags that will be used for dex compiles Dxflags []string `android:"arch_variant"` // java_libs: list of of java libraries that will be in the classpath Java_libs []string `android:"arch_variant"` // java_static_libs: list of java libraries that will be compiled into the resulting jar Java_static_libs []string `android:"arch_variant"` // manifest: manifest file to be included in resulting jar Manifest string // sdk_version: if not blank, set to the version of the sdk to compile against Sdk_version string // Set for device java libraries, and for host versions of device java libraries // built for testing Dex bool `blueprint:"mutated"` // jarjar_rules: if not blank, run jarjar using the specified rules file Jarjar_rules string // aidl_includes: directories to pass to aidl tool Aidl_includes []string // aidl_export_include_dirs: directories that should be added as include directories // for any aidl sources of modules that depend on this module Export_aidl_include_dirs []string } // output file suitable for inserting into the classpath of another compile classpathFile string // output file suitable for installing or running outputFile string // jarSpecs suitable for inserting classes from a static library into another jar classJarSpecs []jarSpec // jarSpecs suitable for inserting resources from a static library into another jar resourceJarSpecs []jarSpec exportAidlIncludeDirs []string logtagsSrcs []string // filelists of extra source files that should be included in the javac command line, // for example R.java generated by aapt for android apps ExtraSrcLists []string // installed file for binary dependency installFile string } type JavaModuleType interface { GenerateJavaBuildActions(ctx common.AndroidModuleContext) JavaDynamicDependencies(ctx common.AndroidDynamicDependerModuleContext) []string } type JavaDependency interface { ClasspathFile() string ClassJarSpecs() []jarSpec ResourceJarSpecs() []jarSpec AidlIncludeDirs() []string } func NewJavaBase(base *javaBase, module JavaModuleType, hod common.HostOrDeviceSupported, props ...interface{}) (blueprint.Module, []interface{}) { base.module = module props = append(props, &base.properties) return common.InitAndroidArchModule(base, hod, common.MultilibCommon, props...) } func (j *javaBase) BootClasspath(ctx common.AndroidBaseContext) string { if ctx.Device() { if j.properties.Sdk_version == "" { return "core-libart" } else if j.properties.Sdk_version == "current" { // TODO: !TARGET_BUILD_APPS // TODO: export preprocessed framework.aidl from android_stubs_current return "android_stubs_current" } else if j.properties.Sdk_version == "system_current" { return "android_system_stubs_current" } else { return "sdk_v" + j.properties.Sdk_version } } else { if j.properties.Dex { return "core-libart" } else { return "" } } } var defaultJavaLibraries = []string{"core-libart", "core-junit", "ext", "framework"} func (j *javaBase) AndroidDynamicDependencies(ctx common.AndroidDynamicDependerModuleContext) []string { return j.module.JavaDynamicDependencies(ctx) } func (j *javaBase) JavaDynamicDependencies(ctx common.AndroidDynamicDependerModuleContext) []string { var deps []string if !j.properties.No_standard_libraries { bootClasspath := j.BootClasspath(ctx) if bootClasspath != "" { deps = append(deps, bootClasspath) } if ctx.Device() && j.properties.Sdk_version == "" { deps = append(deps, defaultJavaLibraries...) } } deps = append(deps, j.properties.Java_libs...) deps = append(deps, j.properties.Java_static_libs...) return deps } func (j *javaBase) aidlFlags(ctx common.AndroidModuleContext, aidlPreprocess string, aidlIncludeDirs []string) []string { localAidlIncludes := pathtools.PrefixPaths(j.properties.Aidl_includes, common.ModuleSrcDir(ctx)) var flags []string if aidlPreprocess != "" { flags = append(flags, "-p"+aidlPreprocess) } else { flags = append(flags, common.JoinWithPrefix(aidlIncludeDirs, "-I")) } flags = append(flags, common.JoinWithPrefix(j.exportAidlIncludeDirs, "-I")) flags = append(flags, common.JoinWithPrefix(localAidlIncludes, "-I")) flags = append(flags, "-I"+common.ModuleSrcDir(ctx)) flags = append(flags, "-I"+filepath.Join(common.ModuleSrcDir(ctx), "src")) return flags } func (j *javaBase) collectDeps(ctx common.AndroidModuleContext) (classpath []string, bootClasspath string, classJarSpecs, resourceJarSpecs []jarSpec, aidlPreprocess string, aidlIncludeDirs []string, srcFileLists []string) { ctx.VisitDirectDeps(func(module blueprint.Module) { otherName := ctx.OtherModuleName(module) if javaDep, ok := module.(JavaDependency); ok { if otherName == j.BootClasspath(ctx) { bootClasspath = javaDep.ClasspathFile() } else if inList(otherName, defaultJavaLibraries) { classpath = append(classpath, javaDep.ClasspathFile()) } else if inList(otherName, j.properties.Java_libs) { classpath = append(classpath, javaDep.ClasspathFile()) } else if inList(otherName, j.properties.Java_static_libs) { classpath = append(classpath, javaDep.ClasspathFile()) classJarSpecs = append(classJarSpecs, javaDep.ClassJarSpecs()...) resourceJarSpecs = append(resourceJarSpecs, javaDep.ResourceJarSpecs()...) } else if otherName == "framework-res" { if ctx.ModuleName() == "framework" { // framework.jar has a one-off dependency on the R.java and Manifest.java files // generated by framework-res.apk srcFileLists = append(srcFileLists, module.(*javaBase).module.(*AndroidApp).aaptJavaFileList) } } else { panic(fmt.Errorf("unknown dependency %q for %q", otherName, ctx.ModuleName())) } aidlIncludeDirs = append(aidlIncludeDirs, javaDep.AidlIncludeDirs()...) if sdkDep, ok := module.(sdkDependency); ok { if sdkDep.AidlPreprocessed() != "" { if aidlPreprocess != "" { ctx.ModuleErrorf("multiple dependencies with preprocessed aidls:\n %q\n %q", aidlPreprocess, sdkDep.AidlPreprocessed()) } else { aidlPreprocess = sdkDep.AidlPreprocessed() } } } } }) return classpath, bootClasspath, classJarSpecs, resourceJarSpecs, aidlPreprocess, aidlIncludeDirs, srcFileLists } func (j *javaBase) GenerateAndroidBuildActions(ctx common.AndroidModuleContext) { j.module.GenerateJavaBuildActions(ctx) } func (j *javaBase) GenerateJavaBuildActions(ctx common.AndroidModuleContext) { j.exportAidlIncludeDirs = pathtools.PrefixPaths(j.properties.Export_aidl_include_dirs, common.ModuleSrcDir(ctx)) classpath, bootClasspath, classJarSpecs, resourceJarSpecs, aidlPreprocess, aidlIncludeDirs, srcFileLists := j.collectDeps(ctx) var flags javaBuilderFlags javacFlags := j.properties.Javacflags if len(javacFlags) > 0 { ctx.Variable(pctx, "javacFlags", strings.Join(javacFlags, " ")) flags.javacFlags = "$javacFlags" } aidlFlags := j.aidlFlags(ctx, aidlPreprocess, aidlIncludeDirs) if len(aidlFlags) > 0 { ctx.Variable(pctx, "aidlFlags", strings.Join(aidlFlags, " ")) flags.aidlFlags = "$aidlFlags" } var javacDeps []string if bootClasspath != "" { flags.bootClasspath = "-bootclasspath " + bootClasspath javacDeps = append(javacDeps, bootClasspath) } if len(classpath) > 0 { flags.classpath = "-classpath " + strings.Join(classpath, ":") javacDeps = append(javacDeps, classpath...) } srcFiles := ctx.ExpandSources(j.properties.Srcs) srcFiles = j.genSources(ctx, srcFiles, flags) ctx.VisitDirectDeps(func(module blueprint.Module) { if gen, ok := module.(genrule.SourceFileGenerator); ok { srcFiles = append(srcFiles, gen.GeneratedSourceFiles()...) } }) srcFileLists = append(srcFileLists, j.ExtraSrcLists...) if len(srcFiles) > 0 { // Compile java sources into .class files classes := TransformJavaToClasses(ctx, srcFiles, srcFileLists, flags, javacDeps) if ctx.Failed() { return } classJarSpecs = append([]jarSpec{classes}, classJarSpecs...) } resourceJarSpecs = append(ResourceDirsToJarSpecs(ctx, j.properties.Java_resource_dirs), resourceJarSpecs...) manifest := j.properties.Manifest if manifest != "" { manifest = filepath.Join(common.ModuleSrcDir(ctx), manifest) } allJarSpecs := append([]jarSpec(nil), classJarSpecs...) allJarSpecs = append(allJarSpecs, resourceJarSpecs...) // Combine classes + resources into classes-full-debug.jar outputFile := TransformClassesToJar(ctx, allJarSpecs, manifest) if ctx.Failed() { return } if j.properties.Jarjar_rules != "" { jarjar_rules := filepath.Join(common.ModuleSrcDir(ctx), j.properties.Jarjar_rules) // Transform classes-full-debug.jar into classes-jarjar.jar outputFile = TransformJarJar(ctx, outputFile, jarjar_rules) if ctx.Failed() { return } classes, _ := TransformPrebuiltJarToClasses(ctx, outputFile) classJarSpecs = []jarSpec{classes} } j.resourceJarSpecs = resourceJarSpecs j.classJarSpecs = classJarSpecs j.classpathFile = outputFile if j.properties.Dex && len(srcFiles) > 0 { dxFlags := j.properties.Dxflags if false /* emma enabled */ { // If you instrument class files that have local variable debug information in // them emma does not correctly maintain the local variable table. // This will cause an error when you try to convert the class files for Android. // The workaround here is to build different dex file here based on emma switch // then later copy into classes.dex. When emma is on, dx is run with --no-locals // option to remove local variable information dxFlags = append(dxFlags, "--no-locals") } if ctx.AConfig().Getenv("NO_OPTIMIZE_DX") != "" { dxFlags = append(dxFlags, "--no-optimize") } if ctx.AConfig().Getenv("GENERATE_DEX_DEBUG") != "" { dxFlags = append(dxFlags, "--debug", "--verbose", "--dump-to="+filepath.Join(common.ModuleOutDir(ctx), "classes.lst"), "--dump-width=1000") } flags.dxFlags = strings.Join(dxFlags, " ") // Compile classes.jar into classes.dex dexJarSpec := TransformClassesJarToDex(ctx, outputFile, flags) if ctx.Failed() { return } // Combine classes.dex + resources into javalib.jar outputFile = TransformDexToJavaLib(ctx, resourceJarSpecs, dexJarSpec) } ctx.CheckbuildFile(outputFile) j.outputFile = outputFile } var _ JavaDependency = (*JavaLibrary)(nil) func (j *javaBase) ClasspathFile() string { return j.classpathFile } func (j *javaBase) ClassJarSpecs() []jarSpec { return j.classJarSpecs } func (j *javaBase) ResourceJarSpecs() []jarSpec { return j.resourceJarSpecs } func (j *javaBase) AidlIncludeDirs() []string { return j.exportAidlIncludeDirs } var _ logtagsProducer = (*javaBase)(nil) func (j *javaBase) logtags() []string { return j.logtagsSrcs } // // Java libraries (.jar file) // type JavaLibrary struct { javaBase } func (j *JavaLibrary) GenerateJavaBuildActions(ctx common.AndroidModuleContext) { j.javaBase.GenerateJavaBuildActions(ctx) j.installFile = ctx.InstallFileName("framework", ctx.ModuleName()+".jar", j.outputFile) } func JavaLibraryFactory() (blueprint.Module, []interface{}) { module := &JavaLibrary{} module.properties.Dex = true return NewJavaBase(&module.javaBase, module, common.HostAndDeviceSupported) } func JavaLibraryHostFactory() (blueprint.Module, []interface{}) { module := &JavaLibrary{} return NewJavaBase(&module.javaBase, module, common.HostSupported) } // // Java Binaries (.jar file plus wrapper script) // type JavaBinary struct { JavaLibrary binaryProperties struct { // wrapper: installable script to execute the resulting jar Wrapper string } } func (j *JavaBinary) GenerateJavaBuildActions(ctx common.AndroidModuleContext) { j.JavaLibrary.GenerateJavaBuildActions(ctx) // Depend on the installed jar (j.installFile) so that the wrapper doesn't get executed by // another build rule before the jar has been installed. ctx.InstallFile("bin", filepath.Join(common.ModuleSrcDir(ctx), j.binaryProperties.Wrapper), j.installFile) } func JavaBinaryFactory() (blueprint.Module, []interface{}) { module := &JavaBinary{} module.properties.Dex = true return NewJavaBase(&module.javaBase, module, common.HostAndDeviceSupported, &module.binaryProperties) } func JavaBinaryHostFactory() (blueprint.Module, []interface{}) { module := &JavaBinary{} return NewJavaBase(&module.javaBase, module, common.HostSupported, &module.binaryProperties) } // // Java prebuilts // type JavaPrebuilt struct { common.AndroidModuleBase properties struct { Srcs []string } classpathFile string classJarSpecs, resourceJarSpecs []jarSpec } func (j *JavaPrebuilt) GenerateAndroidBuildActions(ctx common.AndroidModuleContext) { if len(j.properties.Srcs) != 1 { ctx.ModuleErrorf("expected exactly one jar in srcs") return } prebuilt := filepath.Join(common.ModuleSrcDir(ctx), j.properties.Srcs[0]) classJarSpec, resourceJarSpec := TransformPrebuiltJarToClasses(ctx, prebuilt) j.classpathFile = prebuilt j.classJarSpecs = []jarSpec{classJarSpec} j.resourceJarSpecs = []jarSpec{resourceJarSpec} ctx.InstallFileName("framework", ctx.ModuleName()+".jar", j.classpathFile) } var _ JavaDependency = (*JavaPrebuilt)(nil) func (j *JavaPrebuilt) ClasspathFile() string { return j.classpathFile } func (j *JavaPrebuilt) ClassJarSpecs() []jarSpec { return j.classJarSpecs } func (j *JavaPrebuilt) ResourceJarSpecs() []jarSpec { return j.resourceJarSpecs } func (j *JavaPrebuilt) AidlIncludeDirs() []string { return nil } func JavaPrebuiltFactory() (blueprint.Module, []interface{}) { module := &JavaPrebuilt{} return common.InitAndroidArchModule(module, common.HostAndDeviceSupported, common.MultilibCommon, &module.properties) } // // SDK java prebuilts (.jar containing resources plus framework.aidl) // type sdkDependency interface { JavaDependency AidlPreprocessed() string } var _ sdkDependency = (*sdkPrebuilt)(nil) type sdkPrebuilt struct { JavaPrebuilt sdkProperties struct { Aidl_preprocessed string } aidlPreprocessed string } func (j *sdkPrebuilt) GenerateAndroidBuildActions(ctx common.AndroidModuleContext) { j.JavaPrebuilt.GenerateAndroidBuildActions(ctx) if j.sdkProperties.Aidl_preprocessed != "" { j.aidlPreprocessed = filepath.Join(common.ModuleSrcDir(ctx), j.sdkProperties.Aidl_preprocessed) } } func (j *sdkPrebuilt) AidlPreprocessed() string { return j.aidlPreprocessed } func SdkPrebuiltFactory() (blueprint.Module, []interface{}) { module := &sdkPrebuilt{} return common.InitAndroidArchModule(module, common.HostAndDeviceSupported, common.MultilibCommon, &module.properties, &module.sdkProperties) } func inList(s string, l []string) bool { for _, e := range l { if e == s { return true } } return false }