aboutsummaryrefslogtreecommitdiffstats
path: root/dexpreopt
diff options
context:
space:
mode:
authorColin Cross <ccross@android.com>2018-11-12 10:13:39 -0800
committerColin Cross <ccross@android.com>2018-12-15 19:07:54 -0800
commit43f08db29e874ec5f5eb56de6972ef7ed0321809 (patch)
tree172846f9da39b8c54157d8ec77d4dfc5363ac681 /dexpreopt
parentdf76efe5244766fed2940a80003de9b772005bc1 (diff)
downloadbuild_soong-43f08db29e874ec5f5eb56de6972ef7ed0321809.tar.gz
build_soong-43f08db29e874ec5f5eb56de6972ef7ed0321809.tar.bz2
build_soong-43f08db29e874ec5f5eb56de6972ef7ed0321809.zip
Dexpreopt soong modules inside soong
Port the dexpreopt logic from Make to the dexpreopt package in Soong, and use it to dexpreopt Soong modules. The same package is also compiled into the dexpreopt_gen binary to generate dexpreopt scripts for Make modules. This relands Ib67e2febf9ed921f06e8a86b9ec945c80dff35eb and I462182638bd57b1367b5bfb0718e975c11ae66f7, along with multiple fixes to depsfile generation in dexpreopt_gen that caused .odex files for modules in defined make to be missing dependencies on boot.art, and a fix to not dexpreopt and strip tests. Bug: 119412419 Bug: 120273280 Test: no differences to dexpreopt outputs on aosp_sailfish system/, only expected changes to dexpreopt outputs on system_other (.vdex files for privileged Soong modules no longer incorrectly contain .dex contents). Test: OUT_DIR=$PWD/out m Test: NINJA_ARGS="-t deps out/target/product/sailfish/obj/APPS/Contacts_intermediates/dexpreopt.zip" m Change-Id: I6bb2c971cee65d2338839753aa0d84939f335b1b
Diffstat (limited to 'dexpreopt')
-rw-r--r--dexpreopt/Android.bp15
-rw-r--r--dexpreopt/config.go141
-rw-r--r--dexpreopt/dexpreopt.go541
-rw-r--r--dexpreopt/dexpreopt_gen/Android.bp11
-rw-r--r--dexpreopt/dexpreopt_gen/dexpreopt_gen.go190
-rw-r--r--dexpreopt/dexpreopt_test.go208
-rw-r--r--dexpreopt/script.go173
7 files changed, 1279 insertions, 0 deletions
diff --git a/dexpreopt/Android.bp b/dexpreopt/Android.bp
new file mode 100644
index 00000000..b8325298
--- /dev/null
+++ b/dexpreopt/Android.bp
@@ -0,0 +1,15 @@
+bootstrap_go_package {
+ name: "soong-dexpreopt",
+ pkgPath: "android/soong/dexpreopt",
+ srcs: [
+ "config.go",
+ "dexpreopt.go",
+ "script.go",
+ ],
+ testSrcs: [
+ "dexpreopt_test.go",
+ ],
+ deps: [
+ "blueprint-pathtools",
+ ],
+} \ No newline at end of file
diff --git a/dexpreopt/config.go b/dexpreopt/config.go
new file mode 100644
index 00000000..6a4fd4a0
--- /dev/null
+++ b/dexpreopt/config.go
@@ -0,0 +1,141 @@
+// Copyright 2018 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 dexpreopt
+
+import (
+ "encoding/json"
+ "io/ioutil"
+)
+
+// GlobalConfig stores the configuration for dex preopting set by the product
+type GlobalConfig struct {
+ DefaultNoStripping bool // don't strip dex files by default
+
+ DisablePreoptModules []string // modules with preopt disabled by product-specific config
+
+ OnlyPreoptBootImageAndSystemServer bool // only preopt jars in the boot image or system server
+
+ HasSystemOther bool // store odex files that match PatternsOnSystemOther on the system_other partition
+ PatternsOnSystemOther []string // patterns (using '%' to denote a prefix match) to put odex on the system_other partition
+
+ DisableGenerateProfile bool // don't generate profiles
+
+ BootJars []string // jars that form the boot image
+ SystemServerJars []string // jars that form the system server
+ SystemServerApps []string // apps that are loaded into system server
+ SpeedApps []string // apps that should be speed optimized
+
+ PreoptFlags []string // global dex2oat flags that should be used if no module-specific dex2oat flags are specified
+
+ DefaultCompilerFilter string // default compiler filter to pass to dex2oat, overridden by --compiler-filter= in module-specific dex2oat flags
+ SystemServerCompilerFilter string // default compiler filter to pass to dex2oat for system server jars
+
+ GenerateDMFiles bool // generate Dex Metadata files
+
+ NoDebugInfo bool // don't generate debug info by default
+ AlwaysSystemServerDebugInfo bool // always generate mini debug info for system server modules (overrides NoDebugInfo=true)
+ NeverSystemServerDebugInfo bool // never generate mini debug info for system server modules (overrides NoDebugInfo=false)
+ AlwaysOtherDebugInfo bool // always generate mini debug info for non-system server modules (overrides NoDebugInfo=true)
+ NeverOtherDebugInfo bool // never generate mini debug info for non-system server modules (overrides NoDebugInfo=true)
+
+ MissingUsesLibraries []string // libraries that may be listed in OptionalUsesLibraries but will not be installed by the product
+
+ IsEng bool // build is a eng variant
+ SanitizeLite bool // build is the second phase of a SANITIZE_LITE build
+
+ DefaultAppImages bool // build app images (TODO: .art files?) by default
+
+ Dex2oatXmx string // max heap size
+ Dex2oatXms string // initial heap size
+
+ EmptyDirectory string // path to an empty directory
+
+ DefaultDexPreoptImageLocation map[string]string // default boot image location for each architecture
+ CpuVariant map[string]string // cpu variant for each architecture
+ InstructionSetFeatures map[string]string // instruction set for each architecture
+
+ Tools Tools // paths to tools possibly used by the generated commands
+}
+
+// Tools contains paths to tools possibly used by the generated commands. If you add a new tool here you MUST add it
+// to the order-only dependency list in DEXPREOPT_GEN_DEPS.
+type Tools struct {
+ Profman string
+ Dex2oat string
+ Aapt string
+ SoongZip string
+ Zip2zip string
+
+ VerifyUsesLibraries string
+ ConstructContext string
+}
+
+type ModuleConfig struct {
+ Name string
+ DexLocation string // dex location on device
+ BuildPath string
+ DexPath string
+ PreferIntegrity bool
+ UncompressedDex bool
+ HasApkLibraries bool
+ PreoptFlags []string
+
+ ProfileClassListing string
+ ProfileIsTextListing bool
+
+ EnforceUsesLibraries bool
+ OptionalUsesLibraries []string
+ UsesLibraries []string
+ LibraryPaths map[string]string
+
+ Archs []string
+ DexPreoptImageLocation string
+
+ PreoptExtractedApk bool // Overrides OnlyPreoptModules
+
+ NoCreateAppImage bool
+ ForceCreateAppImage bool
+
+ PresignedPrebuilt bool
+
+ StripInputPath string
+ StripOutputPath string
+}
+
+func LoadGlobalConfig(path string) (GlobalConfig, error) {
+ config := GlobalConfig{}
+ err := loadConfig(path, &config)
+ return config, err
+}
+
+func LoadModuleConfig(path string) (ModuleConfig, error) {
+ config := ModuleConfig{}
+ err := loadConfig(path, &config)
+ return config, err
+}
+
+func loadConfig(path string, config interface{}) error {
+ data, err := ioutil.ReadFile(path)
+ if err != nil {
+ return err
+ }
+
+ err = json.Unmarshal(data, config)
+ if err != nil {
+ return err
+ }
+
+ return nil
+}
diff --git a/dexpreopt/dexpreopt.go b/dexpreopt/dexpreopt.go
new file mode 100644
index 00000000..0c2df6e5
--- /dev/null
+++ b/dexpreopt/dexpreopt.go
@@ -0,0 +1,541 @@
+// Copyright 2018 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.
+
+// The dexpreopt package converts a global dexpreopt config and a module dexpreopt config into rules to perform
+// dexpreopting and to strip the dex files from the APK or JAR.
+//
+// It is used in two places; in the dexpeopt_gen binary for modules defined in Make, and directly linked into Soong.
+//
+// For Make modules it is built into the dexpreopt_gen binary, which is executed as a Make rule using global config and
+// module config specified in JSON files. The binary writes out two shell scripts, only updating them if they have
+// changed. One script takes an APK or JAR as an input and produces a zip file containing any outputs of preopting,
+// in the location they should be on the device. The Make build rules will unzip the zip file into $(PRODUCT_OUT) when
+// installing the APK, which will install the preopt outputs into $(PRODUCT_OUT)/system or $(PRODUCT_OUT)/system_other
+// as necessary. The zip file may be empty if preopting was disabled for any reason. The second script takes an APK or
+// JAR as an input and strips the dex files in it as necessary.
+//
+// The intermediate shell scripts allow changes to this package or to the global config to regenerate the shell scripts
+// but only require re-executing preopting if the script has changed.
+//
+// For Soong modules this package is linked directly into Soong and run from the java package. It generates the same
+// commands as for make, using athe same global config JSON file used by make, but using a module config structure
+// provided by Soong. The generated commands are then converted into Soong rule and written directly to the ninja file,
+// with no extra shell scripts involved.
+package dexpreopt
+
+import (
+ "fmt"
+ "path/filepath"
+ "strings"
+
+ "github.com/google/blueprint/pathtools"
+)
+
+const SystemPartition = "/system/"
+const SystemOtherPartition = "/system_other/"
+
+// GenerateStripRule generates a set of commands that will take an APK or JAR as an input and strip the dex files if
+// they are no longer necessary after preopting.
+func GenerateStripRule(global GlobalConfig, module ModuleConfig) (rule *Rule, err error) {
+ defer func() {
+ if r := recover(); r != nil {
+ if e, ok := r.(error); ok {
+ err = e
+ rule = nil
+ } else {
+ panic(r)
+ }
+ }
+ }()
+
+ tools := global.Tools
+
+ rule = &Rule{}
+
+ strip := shouldStripDex(module, global)
+
+ if strip {
+ // Only strips if the dex files are not already uncompressed
+ rule.Command().
+ Textf(`if (zipinfo %s '*.dex' 2>/dev/null | grep -v ' stor ' >/dev/null) ; then`, module.StripInputPath).
+ Tool(tools.Zip2zip).FlagWithInput("-i ", module.StripInputPath).FlagWithOutput("-o ", module.StripOutputPath).
+ FlagWithArg("-x ", `"classes*.dex"`).
+ Textf(`; else cp -f %s %s; fi`, module.StripInputPath, module.StripOutputPath)
+ } else {
+ rule.Command().Text("cp -f").Input(module.StripInputPath).Output(module.StripOutputPath)
+ }
+
+ return rule, nil
+}
+
+// GenerateDexpreoptRule generates a set of commands that will preopt a module based on a GlobalConfig and a
+// ModuleConfig. The produced files and their install locations will be available through rule.Installs().
+func GenerateDexpreoptRule(global GlobalConfig, module ModuleConfig) (rule *Rule, err error) {
+ defer func() {
+ if r := recover(); r != nil {
+ if e, ok := r.(error); ok {
+ err = e
+ rule = nil
+ } else {
+ panic(r)
+ }
+ }
+ }()
+
+ rule = &Rule{}
+
+ dexpreoptDisabled := contains(global.DisablePreoptModules, module.Name)
+
+ if contains(global.BootJars, module.Name) {
+ // Don't preopt individual boot jars, they will be preopted together
+ dexpreoptDisabled = true
+ }
+
+ // If OnlyPreoptBootImageAndSystemServer=true and module is not in boot class path skip
+ // Also preopt system server jars since selinux prevents system server from loading anything from
+ // /data. If we don't do this they will need to be extracted which is not favorable for RAM usage
+ // or performance. If PreoptExtractedApk is true, we ignore the only preopt boot image options.
+ if global.OnlyPreoptBootImageAndSystemServer && !contains(global.BootJars, module.Name) &&
+ !contains(global.SystemServerJars, module.Name) && !module.PreoptExtractedApk {
+ dexpreoptDisabled = true
+ }
+
+ generateProfile := module.ProfileClassListing != "" && !global.DisableGenerateProfile
+
+ var profile string
+ if generateProfile {
+ profile = profileCommand(global, module, rule)
+ }
+
+ if !dexpreoptDisabled {
+ appImage := (generateProfile || module.ForceCreateAppImage || global.DefaultAppImages) &&
+ !module.NoCreateAppImage
+
+ generateDM := shouldGenerateDM(module, global)
+
+ for _, arch := range module.Archs {
+ imageLocation := module.DexPreoptImageLocation
+ if imageLocation == "" {
+ imageLocation = global.DefaultDexPreoptImageLocation[arch]
+ }
+ dexpreoptCommand(global, module, rule, profile, arch, imageLocation, appImage, generateDM)
+ }
+ }
+
+ return rule, nil
+}
+
+func profileCommand(global GlobalConfig, module ModuleConfig, rule *Rule) string {
+ profilePath := filepath.Join(filepath.Dir(module.BuildPath), "profile.prof")
+ profileInstalledPath := module.DexLocation + ".prof"
+
+ if !module.ProfileIsTextListing {
+ rule.Command().FlagWithOutput("touch ", profilePath)
+ }
+
+ cmd := rule.Command().
+ Text(`ANDROID_LOG_TAGS="*:e"`).
+ Tool(global.Tools.Profman)
+
+ if module.ProfileIsTextListing {
+ // The profile is a test listing of classes (used for framework jars).
+ // We need to generate the actual binary profile before being able to compile.
+ cmd.FlagWithInput("--create-profile-from=", module.ProfileClassListing)
+ } else {
+ // The profile is binary profile (used for apps). Run it through profman to
+ // ensure the profile keys match the apk.
+ cmd.
+ Flag("--copy-and-update-profile-key").
+ FlagWithInput("--profile-file=", module.ProfileClassListing)
+ }
+
+ cmd.
+ FlagWithInput("--apk=", module.DexPath).
+ Flag("--dex-location="+module.DexLocation).
+ FlagWithOutput("--reference-profile-file=", profilePath)
+
+ if !module.ProfileIsTextListing {
+ cmd.Text(fmt.Sprintf(`|| echo "Profile out of date for %s"`, module.DexPath))
+ }
+ rule.Install(profilePath, profileInstalledPath)
+
+ return profilePath
+}
+
+func dexpreoptCommand(global GlobalConfig, module ModuleConfig, rule *Rule, profile, arch, bootImageLocation string,
+ appImage, generateDM bool) {
+
+ // HACK: make soname in Soong-generated .odex files match Make.
+ base := filepath.Base(module.DexLocation)
+ if filepath.Ext(base) == ".jar" {
+ base = "javalib.jar"
+ } else if filepath.Ext(base) == ".apk" {
+ base = "package.apk"
+ }
+
+ toOdexPath := func(path string) string {
+ return filepath.Join(
+ filepath.Dir(path),
+ "oat",
+ arch,
+ pathtools.ReplaceExtension(filepath.Base(path), "odex"))
+ }
+
+ odexPath := toOdexPath(filepath.Join(filepath.Dir(module.BuildPath), base))
+ odexInstallPath := toOdexPath(module.DexLocation)
+ if odexOnSystemOther(module, global) {
+ odexInstallPath = strings.Replace(odexInstallPath, SystemPartition, SystemOtherPartition, 1)
+ }
+
+ vdexPath := pathtools.ReplaceExtension(odexPath, "vdex")
+ vdexInstallPath := pathtools.ReplaceExtension(odexInstallPath, "vdex")
+
+ // bootImageLocation is $OUT/dex_bootjars/system/framework/boot.art, but dex2oat actually reads
+ // $OUT/dex_bootjars/system/framework/arm64/boot.art
+ var bootImagePath string
+ if bootImageLocation != "" {
+ bootImagePath = filepath.Join(filepath.Dir(bootImageLocation), arch, filepath.Base(bootImageLocation))
+ }
+
+ // Lists of used and optional libraries from the build config to be verified against the manifest in the APK
+ var verifyUsesLibs []string
+ var verifyOptionalUsesLibs []string
+
+ // Lists of used and optional libraries from the build config, with optional libraries that are known to not
+ // be present in the current product removed.
+ var filteredUsesLibs []string
+ var filteredOptionalUsesLibs []string
+
+ // The class loader context using paths in the build
+ var classLoaderContextHost []string
+
+ // The class loader context using paths as they will be on the device
+ var classLoaderContextTarget []string
+
+ // Extra paths that will be appended to the class loader if the APK manifest has targetSdkVersion < 28
+ var conditionalClassLoaderContextHost []string
+ var conditionalClassLoaderContextTarget []string
+
+ if module.EnforceUsesLibraries {
+ verifyUsesLibs = copyOf(module.UsesLibraries)
+ verifyOptionalUsesLibs = copyOf(module.OptionalUsesLibraries)
+
+ filteredOptionalUsesLibs = filterOut(global.MissingUsesLibraries, module.OptionalUsesLibraries)
+ filteredUsesLibs = append(copyOf(module.UsesLibraries), filteredOptionalUsesLibs...)
+
+ // Create class loader context for dex2oat from uses libraries and filtered optional libraries
+ for _, l := range filteredUsesLibs {
+
+ classLoaderContextHost = append(classLoaderContextHost,
+ pathForLibrary(module, l))
+ classLoaderContextTarget = append(classLoaderContextTarget,
+ filepath.Join("/system/framework", l+".jar"))
+ }
+
+ const httpLegacy = "org.apache.http.legacy"
+ const httpLegacyImpl = "org.apache.http.legacy.impl"
+
+ // Fix up org.apache.http.legacy.impl since it should be org.apache.http.legacy in the manifest.
+ replace(verifyUsesLibs, httpLegacyImpl, httpLegacy)
+ replace(verifyOptionalUsesLibs, httpLegacyImpl, httpLegacy)
+
+ if !contains(verifyUsesLibs, httpLegacy) && !contains(verifyOptionalUsesLibs, httpLegacy) {
+ conditionalClassLoaderContextHost = append(conditionalClassLoaderContextHost,
+ pathForLibrary(module, httpLegacyImpl))
+ conditionalClassLoaderContextTarget = append(conditionalClassLoaderContextTarget,
+ filepath.Join("/system/framework", httpLegacyImpl+".jar"))
+ }
+ } else {
+ // Pass special class loader context to skip the classpath and collision check.
+ // This will get removed once LOCAL_USES_LIBRARIES is enforced.
+ // Right now LOCAL_USES_LIBRARIES is opt in, for the case where it's not specified we still default
+ // to the &.
+ classLoaderContextHost = []string{`\&`}
+ }
+
+ rule.Command().FlagWithArg("mkdir -p ", filepath.Dir(odexPath))
+ rule.Command().FlagWithOutput("rm -f ", odexPath)
+ // Set values in the environment of the rule. These may be modified by construct_context.sh.
+ rule.Command().FlagWithArg("class_loader_context_arg=--class-loader-context=",
+ strings.Join(classLoaderContextHost, ":"))
+ rule.Command().Text(`stored_class_loader_context_arg=""`)
+
+ if module.EnforceUsesLibraries {
+ rule.Command().FlagWithList("stored_class_loader_context_libs=", classLoaderContextTarget, ":")
+ rule.Command().FlagWithInputList("class_loader_context=", classLoaderContextHost, ":")
+ rule.Command().Textf(`uses_library_names="%s"`, strings.Join(verifyUsesLibs, " "))
+ rule.Command().Textf(`optional_uses_library_names="%s"`, strings.Join(verifyOptionalUsesLibs, " "))
+ rule.Command().Textf(`aapt_binary="%s"`, global.Tools.Aapt)
+ rule.Command().Text("source").Tool(global.Tools.VerifyUsesLibraries).Input(module.DexPath)
+ rule.Command().Text("source").Tool(global.Tools.ConstructContext).
+ Textf(`"%s"`, strings.Join(conditionalClassLoaderContextHost, ":")).
+ Textf(`"%s"`, strings.Join(conditionalClassLoaderContextTarget, ":"))
+ }
+
+ cmd := rule.Command().
+ Text(`ANDROID_LOG_TAGS="*:e"`).
+ Tool(global.Tools.Dex2oat).
+ Flag("--avoid-storing-invocation").
+ Flag("--runtime-arg").FlagWithArg("-Xms", global.Dex2oatXms).
+ Flag("--runtime-arg").FlagWithArg("-Xmx", global.Dex2oatXmx).
+ Flag("${class_loader_context_arg}").
+ Flag("${stored_class_loader_context_arg}").
+ FlagWithArg("--boot-image=", bootImageLocation).Implicit(bootImagePath).
+ FlagWithInput("--dex-file=", module.DexPath).
+ FlagWithArg("--dex-location=", module.DexLocation).
+ FlagWithOutput("--oat-file=", odexPath).ImplicitOutput(vdexPath).
+ // Pass an empty directory, dex2oat shouldn't be reading arbitrary files
+ FlagWithArg("--android-root=", global.EmptyDirectory).
+ FlagWithArg("--instruction-set=", arch).
+ FlagWithArg("--instruction-set-variant=", global.CpuVariant[arch]).
+ FlagWithArg("--instruction-set-features=", global.InstructionSetFeatures[arch]).
+ Flag("--no-generate-debug-info").
+ Flag("--generate-build-id").
+ Flag("--abort-on-hard-verifier-error").
+ Flag("--force-determinism").
+ FlagWithArg("--no-inline-from=", "core-oj.jar")
+
+ var preoptFlags []string
+ if len(module.PreoptFlags) > 0 {
+ preoptFlags = module.PreoptFlags
+ } else if len(global.PreoptFlags) > 0 {
+ preoptFlags = global.PreoptFlags
+ }
+
+ if len(preoptFlags) > 0 {
+ cmd.Text(strings.Join(preoptFlags, " "))
+ }
+
+ if module.UncompressedDex {
+ cmd.FlagWithArg("--copy-dex-files=", "false")
+ }
+
+ if !anyHavePrefix(preoptFlags, "--compiler-filter=") {
+ var compilerFilter string
+ if contains(global.SystemServerJars, module.Name) {
+ // Jars of system server, use the product option if it is set, speed otherwise.
+ if global.SystemServerCompilerFilter != "" {
+ compilerFilter = global.SystemServerCompilerFilter
+ } else {
+ compilerFilter = "speed"
+ }
+ } else if contains(global.SpeedApps, module.Name) || contains(global.SystemServerApps, module.Name) {
+ // Apps loaded into system server, and apps the product default to being compiled with the
+ // 'speed' compiler filter.
+ compilerFilter = "speed"
+ } else if profile != "" {
+ // For non system server jars, use speed-profile when we have a profile.
+ compilerFilter = "speed-profile"
+ } else if global.DefaultCompilerFilter != "" {
+ compilerFilter = global.DefaultCompilerFilter
+ } else {
+ compilerFilter = "quicken"
+ }
+ cmd.FlagWithArg("--compiler-filter=", compilerFilter)
+ }
+
+ if generateDM {
+ cmd.FlagWithArg("--copy-dex-files=", "false")
+ dmPath := filepath.Join(filepath.Dir(module.BuildPath), "generated.dm")
+ dmInstalledPath := pathtools.ReplaceExtension(module.DexLocation, "dm")
+ tmpPath := filepath.Join(filepath.Dir(module.BuildPath), "primary.vdex")
+ rule.Command().Text("cp -f").Input(vdexPath).Output(tmpPath)
+ rule.Command().Tool(global.Tools.SoongZip).
+ FlagWithArg("-L", "9").
+ FlagWithOutput("-o", dmPath).
+ Flag("-j").
+ Input(tmpPath)
+ rule.Install(dmPath, dmInstalledPath)
+ }
+
+ // By default, emit debug info.
+ debugInfo := true
+ if global.NoDebugInfo {
+ // If the global setting suppresses mini-debug-info, disable it.
+ debugInfo = false
+ }
+
+ // PRODUCT_SYSTEM_SERVER_DEBUG_INFO overrides WITH_DEXPREOPT_DEBUG_INFO.
+ // PRODUCT_OTHER_JAVA_DEBUG_INFO overrides WITH_DEXPREOPT_DEBUG_INFO.
+ if contains(global.SystemServerJars, module.Name) {
+ if global.AlwaysSystemServerDebugInfo {
+ debugInfo = true
+ } else if global.NeverSystemServerDebugInfo {
+ debugInfo = false
+ }
+ } else {
+ if global.AlwaysOtherDebugInfo {
+ debugInfo = true
+ } else if global.NeverOtherDebugInfo {
+ debugInfo = false
+ }
+ }
+
+ // Never enable on eng.
+ if global.IsEng {
+ debugInfo = false
+ }
+
+ if debugInfo {
+ cmd.Flag("--generate-mini-debug-info")
+ } else {
+ cmd.Flag("--no-generate-mini-debug-info")
+ }
+
+ // Set the compiler reason to 'prebuilt' to identify the oat files produced
+ // during the build, as opposed to compiled on the device.
+ cmd.FlagWithArg("--compilation-reason=", "prebuilt")
+
+ if appImage {
+ appImagePath := pathtools.ReplaceExtension(odexPath, "art")
+ appImageInstallPath := pathtools.ReplaceExtension(odexInstallPath, "art")
+ cmd.FlagWithOutput("--app-image-file=", appImagePath).
+ FlagWithArg("--image-format=", "lz4")
+ rule.Install(appImagePath, appImageInstallPath)
+ }
+
+ if profile != "" {
+ cmd.FlagWithArg("--profile-file=", profile)
+ }
+
+ rule.Install(odexPath, odexInstallPath)
+ rule.Install(vdexPath, vdexInstallPath)
+}
+
+// Return if the dex file in the APK should be stripped. If an APK is found to contain uncompressed dex files at
+// dex2oat time it will not be stripped even if strip=true.
+func shouldStripDex(module ModuleConfig, global GlobalConfig) bool {
+ strip := !global.DefaultNoStripping
+
+ // Don't strip modules that are not on the system partition in case the oat/vdex version in system ROM
+ // doesn't match the one in other partitions. It needs to be able to fall back to the APK for that case.
+ if !strings.HasPrefix(module.DexLocation, SystemPartition) {
+ strip = false
+ }
+
+ // system_other isn't there for an OTA, so don't strip if module is on system, and odex is on system_other.
+ if odexOnSystemOther(module, global) {
+ strip = false
+ }
+
+ if module.HasApkLibraries {
+ strip = false
+ }
+
+ // Don't strip with dex files we explicitly uncompress (dexopt will not store the dex code).
+ if module.UncompressedDex {
+ strip = false
+ }
+
+ if shouldGenerateDM(module, global) {
+ strip = false
+ }
+
+ if module.PresignedPrebuilt {
+ // Only strip out files if we can re-sign the package.
+ strip = false
+ }
+
+ return strip
+}
+
+func shouldGenerateDM(module ModuleConfig, global GlobalConfig) bool {
+ // Generating DM files only makes sense for verify, avoid doing for non verify compiler filter APKs.
+ // No reason to use a dm file if the dex is already uncompressed.
+ return global.GenerateDMFiles && !module.UncompressedDex &&
+ contains(module.PreoptFlags, "--compiler-filter=verify")
+}
+
+func odexOnSystemOther(module ModuleConfig, global GlobalConfig) bool {
+ if !global.HasSystemOther {
+ return false
+ }
+
+ if global.SanitizeLite {
+ return false
+ }
+
+ if contains(global.SpeedApps, module.Name) || contains(global.SystemServerApps, module.Name) {
+ return false
+ }
+
+ for _, f := range global.PatternsOnSystemOther {
+ if makefileMatch(filepath.Join(SystemPartition, f), module.DexLocation) {
+ return true
+ }
+ }
+
+ return false
+}
+
+func pathForLibrary(module ModuleConfig, lib string) string {
+ path := module.LibraryPaths[lib]
+ if path == "" {
+ panic(fmt.Errorf("unknown library path for %q", lib))
+ }
+ return path
+}
+
+func makefileMatch(pattern, s string) bool {
+ percent := strings.IndexByte(pattern, '%')
+ switch percent {
+ case -1:
+ return pattern == s
+ case len(pattern) - 1:
+ return strings.HasPrefix(s, pattern[:len(pattern)-1])
+ default:
+ panic(fmt.Errorf("unsupported makefile pattern %q", pattern))
+ }
+}
+
+func contains(l []string, s string) bool {
+ for _, e := range l {
+ if e == s {
+ return true
+ }
+ }
+ return false
+}
+
+// remove all elements in a from b, returning a new slice
+func filterOut(a []string, b []string) []string {
+ var ret []string
+ for _, x := range b {
+ if !contains(a, x) {
+ ret = append(ret, x)
+ }
+ }
+ return ret
+}
+
+func replace(l []string, from, to string) {
+ for i := range l {
+ if l[i] == from {
+ l[i] = to
+ }
+ }
+}
+
+func copyOf(l []string) []string {
+ return append([]string(nil), l...)
+}
+
+func anyHavePrefix(l []string, prefix string) bool {
+ for _, x := range l {
+ if strings.HasPrefix(x, prefix) {
+ return true
+ }
+ }
+ return false
+}
diff --git a/dexpreopt/dexpreopt_gen/Android.bp b/dexpreopt/dexpreopt_gen/Android.bp
new file mode 100644
index 00000000..07903910
--- /dev/null
+++ b/dexpreopt/dexpreopt_gen/Android.bp
@@ -0,0 +1,11 @@
+blueprint_go_binary {
+ name: "dexpreopt_gen",
+ srcs: [
+ "dexpreopt_gen.go",
+ ],
+ deps: [
+ "soong-dexpreopt",
+ "blueprint-pathtools",
+ "blueprint-proptools",
+ ],
+} \ No newline at end of file
diff --git a/dexpreopt/dexpreopt_gen/dexpreopt_gen.go b/dexpreopt/dexpreopt_gen/dexpreopt_gen.go
new file mode 100644
index 00000000..c010056a
--- /dev/null
+++ b/dexpreopt/dexpreopt_gen/dexpreopt_gen.go
@@ -0,0 +1,190 @@
+// Copyright 2018 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 main
+
+import (
+ "bytes"
+ "flag"
+ "fmt"
+ "os"
+ "path/filepath"
+ "runtime"
+
+ "android/soong/dexpreopt"
+
+ "github.com/google/blueprint/pathtools"
+)
+
+var (
+ dexpreoptScriptPath = flag.String("dexpreopt_script", "", "path to output dexpreopt script")
+ stripScriptPath = flag.String("strip_script", "", "path to output strip script")
+ globalConfigPath = flag.String("global", "", "path to global configuration file")
+ moduleConfigPath = flag.String("module", "", "path to module configuration file")
+)
+
+func main() {
+ flag.Parse()
+
+ usage := func(err string) {
+ if err != "" {
+ fmt.Println(err)
+ flag.Usage()
+ os.Exit(1)
+ }
+ }
+
+ if flag.NArg() > 0 {
+ usage("unrecognized argument " + flag.Arg(0))
+ }
+
+ if *dexpreoptScriptPath == "" {
+ usage("path to output dexpreopt script is required")
+ }
+
+ if *stripScriptPath == "" {
+ usage("path to output strip script is required")
+ }
+
+ if *globalConfigPath == "" {
+ usage("path to global configuration file is required")
+ }
+
+ if *moduleConfigPath == "" {
+ usage("path to module configuration file is required")
+ }
+
+ globalConfig, err := dexpreopt.LoadGlobalConfig(*globalConfigPath)
+ if err != nil {
+ fmt.Fprintf(os.Stderr, "error loading global config %q: %s\n", *globalConfigPath, err)
+ os.Exit(2)
+ }
+
+ moduleConfig, err := dexpreopt.LoadModuleConfig(*moduleConfigPath)
+ if err != nil {
+ fmt.Fprintf(os.Stderr, "error loading module config %q: %s\n", *moduleConfigPath, err)
+ os.Exit(2)
+ }
+
+ defer func() {
+ if r := recover(); r != nil {
+ switch x := r.(type) {
+ case runtime.Error:
+ panic(x)
+ case error:
+ fmt.Fprintln(os.Stderr, "error:", r)
+ os.Exit(3)
+ default:
+ panic(x)
+ }
+ }
+ }()
+
+ writeScripts(globalConfig, moduleConfig, *dexpreoptScriptPath, *stripScriptPath)
+}
+
+func writeScripts(global dexpreopt.GlobalConfig, module dexpreopt.ModuleConfig,
+ dexpreoptScriptPath, stripScriptPath string) {
+ dexpreoptRule, err := dexpreopt.GenerateDexpreoptRule(global, module)
+ if err != nil {
+ panic(err)
+ }
+
+ installDir := filepath.Join(filepath.Dir(module.BuildPath), "dexpreopt_install")
+
+ dexpreoptRule.Command().FlagWithArg("rm -rf ", installDir)
+
+ for _, install := range dexpreoptRule.Installs() {
+ installPath := filepath.Join(installDir, install.To)
+ dexpreoptRule.Command().Text("mkdir -p").Flag(filepath.Dir(installPath))
+ dexpreoptRule.Command().Text("cp -f").Input(install.From).Output(installPath)
+ }
+ dexpreoptRule.Command().Tool(global.Tools.SoongZip).
+ FlagWithOutput("-o ", "$2").
+ FlagWithArg("-C ", installDir).
+ FlagWithArg("-D ", installDir)
+
+ stripRule, err := dexpreopt.GenerateStripRule(global, module)
+ if err != nil {
+ panic(err)
+ }
+
+ write := func(rule *dexpreopt.Rule, file string) {
+ script := &bytes.Buffer{}
+ script.WriteString(scriptHeader)
+ for _, c := range rule.Commands() {
+ script.WriteString(c)
+ script.WriteString("\n\n")
+ }
+
+ depFile := &bytes.Buffer{}
+
+ fmt.Fprint(depFile, `: \`+"\n")
+ for _, tool := range dexpreoptRule.Tools() {
+ fmt.Fprintf(depFile, ` %s \`+"\n", tool)
+ }
+ for _, input := range dexpreoptRule.Inputs() {
+ // Assume the rule that ran the script already has a dependency on the input file passed on the
+ // command line.
+ if input != "$1" {
+ fmt.Fprintf(depFile, ` %s \`+"\n", input)
+ }
+ }
+ depFile.WriteString("\n")
+
+ fmt.Fprintln(script, "rm -f $2.d")
+ // Write the output path unescaped so the $2 gets expanded
+ fmt.Fprintln(script, `echo -n $2 > $2.d`)
+ // Write the rest of the depsfile using cat <<'EOF', which will not do any shell expansion on
+ // the contents to preserve backslashes and special characters in filenames.
+ fmt.Fprintf(script, "cat >> $2.d <<'EOF'\n%sEOF\n", depFile.String())
+
+ err := pathtools.WriteFileIfChanged(file, script.Bytes(), 0755)
+ if err != nil {
+ panic(err)
+ }
+ }
+
+ // The written scripts will assume the input is $1 and the output is $2
+ if module.DexPath != "$1" {
+ panic(fmt.Errorf("module.DexPath must be '$1', was %q", module.DexPath))
+ }
+ if module.StripInputPath != "$1" {
+ panic(fmt.Errorf("module.StripInputPath must be '$1', was %q", module.StripInputPath))
+ }
+ if module.StripOutputPath != "$2" {
+ panic(fmt.Errorf("module.StripOutputPath must be '$2', was %q", module.StripOutputPath))
+ }
+
+ write(dexpreoptRule, dexpreoptScriptPath)
+ write(stripRule, stripScriptPath)
+}
+
+const scriptHeader = `#!/bin/bash
+
+err() {
+ errno=$?
+ echo "error: $0:$1 exited with status $errno" >&2
+ echo "error in command:" >&2
+ sed -n -e "$1p" $0 >&2
+ if [ "$errno" -ne 0 ]; then
+ exit $errno
+ else
+ exit 1
+ fi
+}
+
+trap 'err $LINENO' ERR
+
+`
diff --git a/dexpreopt/dexpreopt_test.go b/dexpreopt/dexpreopt_test.go
new file mode 100644
index 00000000..52652481
--- /dev/null
+++ b/dexpreopt/dexpreopt_test.go
@@ -0,0 +1,208 @@
+// Copyright 2018 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 dexpreopt
+
+import (
+ "reflect"
+ "strings"
+ "testing"
+)
+
+var testGlobalConfig = GlobalConfig{
+ DefaultNoStripping: false,
+ DisablePreoptModules: nil,
+ OnlyPreoptBootImageAndSystemServer: false,
+ HasSystemOther: false,
+ PatternsOnSystemOther: nil,
+ DisableGenerateProfile: false,
+ BootJars: nil,
+ SystemServerJars: nil,
+ SystemServerApps: nil,
+ SpeedApps: nil,
+ PreoptFlags: nil,
+ DefaultCompilerFilter: "",
+ SystemServerCompilerFilter: "",
+ GenerateDMFiles: false,
+ NoDebugInfo: false,
+ AlwaysSystemServerDebugInfo: false,
+ NeverSystemServerDebugInfo: false,
+ AlwaysOtherDebugInfo: false,
+ NeverOtherDebugInfo: false,
+ MissingUsesLibraries: nil,
+ IsEng: false,
+ SanitizeLite: false,
+ DefaultAppImages: false,
+ Dex2oatXmx: "",
+ Dex2oatXms: "",
+ EmptyDirectory: "",
+ DefaultDexPreoptImageLocation: nil,
+ CpuVariant: nil,
+ InstructionSetFeatures: nil,
+ Tools: Tools{
+ Profman: "profman",
+ Dex2oat: "dex2oat",
+ Aapt: "aapt",
+ SoongZip: "soong_zip",
+ Zip2zip: "zip2zip",
+ VerifyUsesLibraries: "verify_uses_libraries.sh",
+ ConstructContext: "construct_context.sh",
+ },
+}
+
+var testModuleConfig = ModuleConfig{
+ Name: "",
+ DexLocation: "",
+ BuildPath: "",
+ DexPath: "",
+ PreferIntegrity: false,
+ UncompressedDex: false,
+ HasApkLibraries: false,
+ PreoptFlags: nil,
+ ProfileClassListing: "",
+ ProfileIsTextListing: false,
+ EnforceUsesLibraries: false,
+ OptionalUsesLibraries: nil,
+ UsesLibraries: nil,
+ LibraryPaths: nil,
+ Archs: nil,
+ DexPreoptImageLocation: "",
+ PreoptExtractedApk: false,
+ NoCreateAppImage: false,
+ ForceCreateAppImage: false,
+ PresignedPrebuilt: false,
+ StripInputPath: "",
+ StripOutputPath: "",
+}
+
+func TestDexPreopt(t *testing.T) {
+ global, module := testGlobalConfig, testModuleConfig
+
+ module.Name = "test"
+ module.DexLocation = "/system/app/test/test.apk"
+ module.BuildPath = "out/test/test.apk"
+ module.Archs = []string{"arm"}
+
+ rule, err := GenerateDexpreoptRule(global, module)
+ if err != nil {
+ t.Error(err)
+ }
+
+ wantInstalls := []Install{
+ {"out/test/oat/arm/package.odex", "/system/app/test/oat/arm/test.odex"},
+ {"out/test/oat/arm/package.vdex", "/system/app/test/oat/arm/test.vdex"},
+ }
+
+ if !reflect.DeepEqual(rule.Installs(), wantInstalls) {
+ t.Errorf("\nwant installs:\n %v\ngot:\n %v", wantInstalls, rule.Installs())
+ }
+}
+
+func TestDexPreoptSystemOther(t *testing.T) {
+ global, module := testGlobalConfig, testModuleConfig
+
+ global.HasSystemOther = true
+ global.PatternsOnSystemOther = []string{"app/%"}
+
+ module.Name = "test"
+ module.DexLocation = "/system/app/test/test.apk"
+ module.BuildPath = "out/test/test.apk"
+ module.Archs = []string{"arm"}
+
+ rule, err := GenerateDexpreoptRule(global, module)
+ if err != nil {
+ t.Error(err)
+ }
+
+ wantInstalls := []Install{
+ {"out/test/oat/arm/package.odex", "/system_other/app/test/oat/arm/test.odex"},
+ {"out/test/oat/arm/package.vdex", "/system_other/app/test/oat/arm/test.vdex"},
+ }
+
+ if !reflect.DeepEqual(rule.Installs(), wantInstalls) {
+ t.Errorf("\nwant installs:\n %v\ngot:\n %v", wantInstalls, rule.Installs())
+ }
+}
+
+func TestDexPreoptProfile(t *testing.T) {
+ global, module := testGlobalConfig, testModuleConfig
+
+ module.Name = "test"
+ module.DexLocation = "/system/app/test/test.apk"
+ module.BuildPath = "out/test/test.apk"
+ module.ProfileClassListing = "profile"
+ module.Archs = []string{"arm"}
+
+ rule, err := GenerateDexpreoptRule(global, module)
+ if err != nil {
+ t.Error(err)
+ }
+
+ wantInstalls := []Install{
+ {"out/test/profile.prof", "/system/app/test/test.apk.prof"},
+ {"out/test/oat/arm/package.art", "/system/app/test/oat/arm/test.art"},
+ {"out/test/oat/arm/package.odex", "/system/app/test/oat/arm/test.odex"},
+ {"out/test/oat/arm/package.vdex", "/system/app/test/oat/arm/test.vdex"},
+ }
+
+ if !reflect.DeepEqual(rule.Installs(), wantInstalls) {
+ t.Errorf("\nwant installs:\n %v\ngot:\n %v", wantInstalls, rule.Installs())
+ }
+}
+
+func TestStripDex(t *testing.T) {
+ global, module := testGlobalConfig, testModuleConfig
+
+ module.Name = "test"
+ module.DexLocation = "/system/app/test/test.apk"
+ module.BuildPath = "out/test/test.apk"
+ module.Archs = []string{"arm"}
+ module.StripInputPath = "$1"
+ module.StripOutputPath = "$2"
+
+ rule, err := GenerateStripRule(global, module)
+ if err != nil {
+ t.Error(err)
+ }
+
+ want := `zip2zip -i $1 -o $2 -x "classes*.dex"`
+ if len(rule.Commands()) < 1 || !strings.Contains(rule.Commands()[0], want) {
+ t.Errorf("\nwant commands[0] to have:\n %v\ngot:\n %v", want, rule.Commands()[0])
+ }
+}
+
+func TestNoStripDex(t *testing.T) {
+ global, module := testGlobalConfig, testModuleConfig
+
+ global.DefaultNoStripping = true
+
+ module.Name = "test"
+ module.DexLocation = "/system/app/test/test.apk"
+ module.BuildPath = "out/test/test.apk"
+ module.Archs = []string{"arm"}
+ module.StripInputPath = "$1"
+ module.StripOutputPath = "$2"
+
+ rule, err := GenerateStripRule(global, module)
+ if err != nil {
+ t.Error(err)
+ }
+
+ wantCommands := []string{
+ "cp -f $1 $2",
+ }
+ if !reflect.DeepEqual(rule.Commands(), wantCommands) {
+ t.Errorf("\nwant commands:\n %v\ngot:\n %v", wantCommands, rule.Commands())
+ }
+}
diff --git a/dexpreopt/script.go b/dexpreopt/script.go
new file mode 100644
index 00000000..fd4cf823
--- /dev/null
+++ b/dexpreopt/script.go
@@ -0,0 +1,173 @@
+// Copyright 2018 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 dexpreopt
+
+import (
+ "fmt"
+ "sort"
+ "strings"
+)
+
+type Install struct {
+ From, To string
+}
+
+type Rule struct {
+ commands []*Command
+ installs []Install
+}
+
+func (r *Rule) Install(from, to string) {
+ r.installs = append(r.installs, Install{from, to})
+}
+
+func (r *Rule) Command() *Command {
+ command := &Command{}
+ r.commands = append(r.commands, command)
+ return command
+}
+
+func (r *Rule) Inputs() []string {
+ outputs := r.outputSet()
+
+ inputs := make(map[string]bool)
+ for _, c := range r.commands {
+ for _, input := range c.inputs {
+ if !outputs[input] {
+ inputs[input] = true
+ }
+ }
+ }
+
+ var inputList []string
+ for input := range inputs {
+ inputList = append(inputList, input)
+ }
+ sort.Strings(inputList)
+
+ return inputList
+}
+
+func (r *Rule) outputSet() map[string]bool {
+ outputs := make(map[string]bool)
+ for _, c := range r.commands {
+ for _, output := range c.outputs {
+ outputs[output] = true
+ }
+ }
+ return outputs
+}
+
+func (r *Rule) Outputs() []string {
+ outputs := r.outputSet()
+
+ var outputList []string
+ for output := range outputs {
+ outputList = append(outputList, output)
+ }
+ sort.Strings(outputList)
+ return outputList
+}
+
+func (r *Rule) Installs() []Install {
+ return append([]Install(nil), r.installs...)
+}
+
+func (r *Rule) Tools() []string {
+ var tools []string
+ for _, c := range r.commands {
+ tools = append(tools, c.tools...)
+ }
+ return tools
+}
+
+func (r *Rule) Commands() []string {
+ var commands []string
+ for _, c := range r.commands {
+ commands = append(commands, string(c.buf))
+ }
+ return commands
+}
+
+type Command struct {
+ buf []byte
+ inputs []string
+ outputs []string
+ tools []string
+}
+
+func (c *Command) Text(text string) *Command {
+ if len(c.buf) > 0 {
+ c.buf = append(c.buf, ' ')
+ }
+ c.buf = append(c.buf, text...)
+ return c
+}
+
+func (c *Command) Textf(format string, a ...interface{}) *Command {
+ return c.Text(fmt.Sprintf(format, a...))
+}
+
+func (c *Command) Flag(flag string) *Command {
+ return c.Text(flag)
+}
+
+func (c *Command) FlagWithArg(flag, arg string) *Command {
+ return c.Text(flag + arg)
+}
+
+func (c *Command) FlagWithList(flag string, list []string, sep string) *Command {
+ return c.Text(flag + strings.Join(list, sep))
+}
+
+func (c *Command) Tool(path string) *Command {
+ c.tools = append(c.tools, path)
+ return c.Text(path)
+}
+
+func (c *Command) Input(path string) *Command {
+ c.inputs = append(c.inputs, path)
+ return c.Text(path)
+}
+
+func (c *Command) Implicit(path string) *Command {
+ c.inputs = append(c.inputs, path)
+ return c
+}
+
+func (c *Command) Output(path string) *Command {
+ c.outputs = append(c.outputs, path)
+ return c.Text(path)
+}
+
+func (c *Command) ImplicitOutput(path string) *Command {
+ c.outputs = append(c.outputs, path)
+ return c
+}
+
+func (c *Command) FlagWithInput(flag, path string) *Command {
+ c.inputs = append(c.inputs, path)
+ return c.Text(flag + path)
+}
+
+func (c *Command) FlagWithInputList(flag string, paths []string, sep string) *Command {
+ c.inputs = append(c.inputs, paths...)
+ return c.FlagWithList(flag, paths, sep)
+}
+
+func (c *Command) FlagWithOutput(flag, path string) *Command {
+ c.outputs = append(c.outputs, path)
+ return c.Text(flag + path)
+}