xref: /aosp_15_r20/build/soong/apex/androidmk.go (revision 333d2b3687b3a337dbcca9d65000bca186795e39)
1// Copyright (C) 2019 The Android Open Source Project
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15package apex
16
17import (
18	"fmt"
19	"io"
20	"path/filepath"
21	"strings"
22
23	"android/soong/android"
24	"android/soong/cc"
25	"android/soong/java"
26	"android/soong/rust"
27)
28
29func (a *apexBundle) AndroidMk() android.AndroidMkData {
30	if a.properties.HideFromMake {
31		return android.AndroidMkData{
32			Disabled: true,
33		}
34	}
35	return a.androidMkForType()
36}
37
38// nameInMake converts apexFileClass into the corresponding class name in Make.
39func (class apexFileClass) nameInMake() string {
40	switch class {
41	case etc:
42		return "ETC"
43	case nativeSharedLib:
44		return "SHARED_LIBRARIES"
45	case nativeExecutable, shBinary:
46		return "EXECUTABLES"
47	case javaSharedLib:
48		return "JAVA_LIBRARIES"
49	case nativeTest:
50		return "NATIVE_TESTS"
51	case app, appSet:
52		// b/142537672 Why isn't this APP? We want to have full control over
53		// the paths and file names of the apk file under the flattend APEX.
54		// If this is set to APP, then the paths and file names are modified
55		// by the Make build system. For example, it is installed to
56		// /system/apex/<apexname>/app/<Appname>/<apexname>.<Appname>/ instead of
57		// /system/apex/<apexname>/app/<Appname> because the build system automatically
58		// appends module name (which is <apexname>.<Appname> to the path.
59		return "ETC"
60	default:
61		panic(fmt.Errorf("unknown class %d", class))
62	}
63}
64
65// Return the full module name for a dependency module, which appends the apex module name unless re-using a system lib.
66func (a *apexBundle) fullModuleName(apexBundleName string, linkToSystemLib bool, fi *apexFile) string {
67	if linkToSystemLib {
68		return fi.androidMkModuleName
69	}
70	return fi.androidMkModuleName + "." + apexBundleName
71}
72
73// androidMkForFiles generates Make definitions for the contents of an
74// apexBundle (apexBundle#filesInfo).  The filesInfo structure can either be
75// populated by Soong for unconverted APEXes, or Bazel in mixed mode. Use
76// apexFile#isBazelPrebuilt to differentiate.
77func (a *apexBundle) androidMkForFiles(w io.Writer, apexBundleName, moduleDir string,
78	apexAndroidMkData android.AndroidMkData) []string {
79
80	// apexBundleName comes from the 'name' property or soong module.
81	// apexName comes from 'name' property of apex_manifest.
82	// An apex is installed to /system/apex/<apexBundleName> and is activated at /apex/<apexName>
83	// In many cases, the two names are the same, but could be different in general.
84	// However, symbol files for apex files are installed under /apex/<apexBundleName> to avoid
85	// conflicts between two apexes with the same apexName.
86
87	moduleNames := []string{}
88
89	for _, fi := range a.filesInfo {
90		linkToSystemLib := a.linkToSystemLib && fi.transitiveDep && fi.availableToPlatform()
91		moduleName := a.fullModuleName(apexBundleName, linkToSystemLib, &fi)
92
93		// This name will be added to LOCAL_REQUIRED_MODULES of the APEX. We need to be
94		// arch-specific otherwise we will end up installing both ABIs even when only
95		// either of the ABI is requested.
96		aName := moduleName
97		switch fi.multilib {
98		case "lib32":
99			aName = aName + ":32"
100		case "lib64":
101			aName = aName + ":64"
102		}
103		if !android.InList(aName, moduleNames) {
104			moduleNames = append(moduleNames, aName)
105		}
106
107		if linkToSystemLib {
108			// No need to copy the file since it's linked to the system file
109			continue
110		}
111
112		fmt.Fprintln(w, "\ninclude $(CLEAR_VARS)  # apex.apexBundle.files")
113		if fi.moduleDir != "" {
114			fmt.Fprintln(w, "LOCAL_PATH :=", fi.moduleDir)
115		} else {
116			fmt.Fprintln(w, "LOCAL_PATH :=", moduleDir)
117		}
118		fmt.Fprintln(w, "LOCAL_MODULE :=", moduleName)
119
120		if fi.module != nil && fi.module.Owner() != "" {
121			fmt.Fprintln(w, "LOCAL_MODULE_OWNER :=", fi.module.Owner())
122		}
123		// /apex/<apexBundleName>/{lib|framework|...}
124		pathForSymbol := filepath.Join("$(PRODUCT_OUT)", "apex", apexBundleName, fi.installDir)
125		modulePath := pathForSymbol
126		fmt.Fprintln(w, "LOCAL_MODULE_PATH :=", modulePath)
127		// AconfigUpdateAndroidMkData may have added elements to Extra.  Process them here.
128		for _, extra := range apexAndroidMkData.Extra {
129			extra(w, fi.builtFile)
130		}
131
132		// For non-flattend APEXes, the merged notice file is attached to the APEX itself.
133		// We don't need to have notice file for the individual modules in it. Otherwise,
134		// we will have duplicated notice entries.
135		fmt.Fprintln(w, "LOCAL_NO_NOTICE_FILE := true")
136		fmt.Fprintln(w, "LOCAL_SOONG_INSTALLED_MODULE :=", filepath.Join(modulePath, fi.stem()))
137		fmt.Fprintln(w, "LOCAL_SOONG_INSTALL_PAIRS :=", fi.builtFile.String()+":"+filepath.Join(modulePath, fi.stem()))
138		fmt.Fprintln(w, "LOCAL_PREBUILT_MODULE_FILE :=", fi.builtFile.String())
139		if fi.checkbuildTarget != nil {
140			fmt.Fprintln(w, "LOCAL_CHECKED_MODULE :=", fi.checkbuildTarget.String())
141		} else {
142			fmt.Fprintln(w, "LOCAL_CHECKED_MODULE :=", fi.builtFile.String())
143		}
144		fmt.Fprintln(w, "LOCAL_MODULE_CLASS :=", fi.class.nameInMake())
145		if fi.module != nil {
146			// This apexFile's module comes from Soong
147			if fi.module.Target().Arch.ArchType != android.Common {
148				archStr := fi.module.Target().Arch.ArchType.String()
149				fmt.Fprintln(w, "LOCAL_MODULE_TARGET_ARCH :=", archStr)
150			}
151		}
152		if fi.jacocoReportClassesFile != nil {
153			fmt.Fprintln(w, "LOCAL_SOONG_JACOCO_REPORT_CLASSES_JAR :=", fi.jacocoReportClassesFile.String())
154		}
155		switch fi.class {
156		case javaSharedLib:
157			// soong_java_prebuilt.mk sets LOCAL_MODULE_SUFFIX := .jar  Therefore
158			// we need to remove the suffix from LOCAL_MODULE_STEM, otherwise
159			// we will have foo.jar.jar
160			fmt.Fprintln(w, "LOCAL_MODULE_STEM :=", strings.TrimSuffix(fi.stem(), ".jar"))
161			if javaModule, ok := fi.module.(java.ApexDependency); ok {
162				fmt.Fprintln(w, "LOCAL_SOONG_CLASSES_JAR :=", javaModule.ImplementationAndResourcesJars()[0].String())
163				fmt.Fprintln(w, "LOCAL_SOONG_HEADER_JAR :=", javaModule.HeaderJars()[0].String())
164			} else {
165				fmt.Fprintln(w, "LOCAL_SOONG_CLASSES_JAR :=", fi.builtFile.String())
166				fmt.Fprintln(w, "LOCAL_SOONG_HEADER_JAR :=", fi.builtFile.String())
167			}
168			fmt.Fprintln(w, "LOCAL_SOONG_DEX_JAR :=", fi.builtFile.String())
169			fmt.Fprintln(w, "LOCAL_DEX_PREOPT := false")
170			fmt.Fprintln(w, "include $(BUILD_SYSTEM)/soong_java_prebuilt.mk")
171		case app:
172			fmt.Fprintln(w, "LOCAL_CERTIFICATE :=", fi.certificate.AndroidMkString())
173			// soong_app_prebuilt.mk sets LOCAL_MODULE_SUFFIX := .apk  Therefore
174			// we need to remove the suffix from LOCAL_MODULE_STEM, otherwise
175			// we will have foo.apk.apk
176			fmt.Fprintln(w, "LOCAL_MODULE_STEM :=", strings.TrimSuffix(fi.stem(), ".apk"))
177			if app, ok := fi.module.(*java.AndroidApp); ok {
178				android.AndroidMkEmitAssignList(w, "LOCAL_PREBUILT_COVERAGE_ARCHIVE", app.JniCoverageOutputs().Strings())
179				if jniLibSymbols := app.JNISymbolsInstalls(modulePath); len(jniLibSymbols) > 0 {
180					fmt.Fprintln(w, "LOCAL_SOONG_JNI_LIBS_SYMBOLS :=", jniLibSymbols.String())
181				}
182			}
183			fmt.Fprintln(w, "include $(BUILD_SYSTEM)/soong_app_prebuilt.mk")
184		case appSet:
185			as, ok := fi.module.(*java.AndroidAppSet)
186			if !ok {
187				panic(fmt.Sprintf("Expected %s to be AndroidAppSet", fi.module))
188			}
189			fmt.Fprintln(w, "LOCAL_APK_SET_INSTALL_FILE :=", as.PackedAdditionalOutputs().String())
190			fmt.Fprintln(w, "LOCAL_APKCERTS_FILE :=", as.APKCertsFile().String())
191			fmt.Fprintln(w, "include $(BUILD_SYSTEM)/soong_android_app_set.mk")
192		case nativeSharedLib, nativeExecutable, nativeTest:
193			fmt.Fprintln(w, "LOCAL_MODULE_STEM :=", fi.stem())
194			if ccMod, ok := fi.module.(*cc.Module); ok {
195				if ccMod.UnstrippedOutputFile() != nil {
196					fmt.Fprintln(w, "LOCAL_SOONG_UNSTRIPPED_BINARY :=", ccMod.UnstrippedOutputFile().String())
197				}
198				ccMod.AndroidMkWriteAdditionalDependenciesForSourceAbiDiff(w)
199				if ccMod.CoverageOutputFile().Valid() {
200					fmt.Fprintln(w, "LOCAL_PREBUILT_COVERAGE_ARCHIVE :=", ccMod.CoverageOutputFile().String())
201				}
202			} else if rustMod, ok := fi.module.(*rust.Module); ok {
203				if rustMod.UnstrippedOutputFile() != nil {
204					fmt.Fprintln(w, "LOCAL_SOONG_UNSTRIPPED_BINARY :=", rustMod.UnstrippedOutputFile().String())
205				}
206			}
207			fmt.Fprintln(w, "include $(BUILD_SYSTEM)/soong_cc_rust_prebuilt.mk")
208		default:
209			fmt.Fprintln(w, "LOCAL_MODULE_STEM :=", fi.stem())
210			fmt.Fprintln(w, "include $(BUILD_PREBUILT)")
211		}
212
213		// m <module_name> will build <module_name>.<apex_name> as well.
214		if fi.androidMkModuleName != moduleName {
215			fmt.Fprintf(w, ".PHONY: %s\n", fi.androidMkModuleName)
216			fmt.Fprintf(w, "%s: %s\n", fi.androidMkModuleName, moduleName)
217		}
218	}
219	return moduleNames
220}
221
222func (a *apexBundle) writeRequiredModules(w io.Writer, moduleNames []string) {
223	var required []string
224	var targetRequired []string
225	var hostRequired []string
226	required = append(required, a.required...)
227	targetRequired = append(targetRequired, a.TargetRequiredModuleNames()...)
228	hostRequired = append(hostRequired, a.HostRequiredModuleNames()...)
229	for _, fi := range a.filesInfo {
230		required = append(required, fi.requiredModuleNames...)
231		targetRequired = append(targetRequired, fi.targetRequiredModuleNames...)
232		hostRequired = append(hostRequired, fi.hostRequiredModuleNames...)
233	}
234	android.AndroidMkEmitAssignList(w, "LOCAL_REQUIRED_MODULES", moduleNames, a.makeModulesToInstall, required)
235	android.AndroidMkEmitAssignList(w, "LOCAL_TARGET_REQUIRED_MODULES", targetRequired)
236	android.AndroidMkEmitAssignList(w, "LOCAL_HOST_REQUIRED_MODULES", hostRequired)
237}
238
239func (a *apexBundle) androidMkForType() android.AndroidMkData {
240	return android.AndroidMkData{
241		// While we do not provide a value for `Extra`, AconfigUpdateAndroidMkData may add some, which we must honor.
242		Custom: func(w io.Writer, name, prefix, moduleDir string, data android.AndroidMkData) {
243			moduleNames := []string{}
244			if a.installable() {
245				moduleNames = a.androidMkForFiles(w, name, moduleDir, data)
246			}
247
248			fmt.Fprintln(w, "\ninclude $(CLEAR_VARS)  # apex.apexBundle")
249			fmt.Fprintln(w, "LOCAL_PATH :=", moduleDir)
250			fmt.Fprintln(w, "LOCAL_MODULE :=", name)
251			fmt.Fprintln(w, "LOCAL_MODULE_CLASS := ETC") // do we need a new class?
252			fmt.Fprintln(w, "LOCAL_PREBUILT_MODULE_FILE :=", a.outputFile.String())
253			fmt.Fprintln(w, "LOCAL_MODULE_PATH :=", a.installDir.String())
254			stemSuffix := imageApexSuffix
255			if a.isCompressed {
256				stemSuffix = imageCapexSuffix
257			}
258			fmt.Fprintln(w, "LOCAL_MODULE_STEM :=", name+stemSuffix)
259			fmt.Fprintln(w, "LOCAL_UNINSTALLABLE_MODULE :=", !a.installable())
260			if a.installable() {
261				fmt.Fprintln(w, "LOCAL_SOONG_INSTALLED_MODULE :=", a.installedFile.String())
262				fmt.Fprintln(w, "LOCAL_SOONG_INSTALL_PAIRS :=", a.outputFile.String()+":"+a.installedFile.String())
263				fmt.Fprintln(w, "LOCAL_SOONG_INSTALL_SYMLINKS := ", strings.Join(a.compatSymlinks.Strings(), " "))
264			}
265			fmt.Fprintln(w, "LOCAL_APEX_KEY_PATH := ", a.apexKeysPath.String())
266
267			// Because apex writes .mk with Custom(), we need to write manually some common properties
268			// which are available via data.Entries
269			commonProperties := []string{
270				"LOCAL_FULL_INIT_RC", "LOCAL_FULL_VINTF_FRAGMENTS",
271				"LOCAL_PROPRIETARY_MODULE", "LOCAL_VENDOR_MODULE", "LOCAL_ODM_MODULE", "LOCAL_PRODUCT_MODULE", "LOCAL_SYSTEM_EXT_MODULE",
272				"LOCAL_MODULE_OWNER",
273			}
274			for _, name := range commonProperties {
275				if value, ok := data.Entries.EntryMap[name]; ok {
276					android.AndroidMkEmitAssignList(w, name, value)
277				}
278			}
279
280			android.AndroidMkEmitAssignList(w, "LOCAL_OVERRIDES_MODULES", a.overridableProperties.Overrides)
281			a.writeRequiredModules(w, moduleNames)
282			// AconfigUpdateAndroidMkData may have added elements to Extra.  Process them here.
283			for _, extra := range data.Extra {
284				extra(w, a.outputFile)
285			}
286
287			fmt.Fprintln(w, "include $(BUILD_PREBUILT)")
288			fmt.Fprintln(w, "ALL_MODULES.$(my_register_name).BUNDLE :=", a.bundleModuleFile.String())
289			android.AndroidMkEmitAssignList(w, "ALL_MODULES.$(my_register_name).LINT_REPORTS", a.lintReports.Strings())
290
291			if a.installedFilesFile != nil {
292				goal := "checkbuild"
293				distFile := name + "-installed-files.txt"
294				fmt.Fprintln(w, ".PHONY:", goal)
295				fmt.Fprintf(w, "$(call dist-for-goals,%s,%s:%s)\n",
296					goal, a.installedFilesFile.String(), distFile)
297				fmt.Fprintf(w, "$(call declare-0p-target,%s)\n", a.installedFilesFile.String())
298			}
299			for _, dist := range data.Entries.GetDistForGoals(a) {
300				fmt.Fprintln(w, dist)
301			}
302
303			distCoverageFiles(w, "ndk_apis_usedby_apex", a.nativeApisUsedByModuleFile.String())
304			distCoverageFiles(w, "ndk_apis_backedby_apex", a.nativeApisBackedByModuleFile.String())
305			distCoverageFiles(w, "java_apis_used_by_apex", a.javaApisUsedByModuleFile.String())
306		}}
307}
308
309func distCoverageFiles(w io.Writer, dir string, distfile string) {
310	if distfile != "" {
311		goal := "apps_only"
312		fmt.Fprintf(w, "ifneq (,$(filter $(my_register_name),$(TARGET_BUILD_APPS)))\n"+
313			" $(call dist-for-goals,%s,%s:%s/$(notdir %s))\n"+
314			"endif\n", goal, distfile, dir, distfile)
315	}
316}
317