blob: d0b82f2e64feea1b4d41b5081f420a07491f7143 [file] [log] [blame]
Patrick Rohr92d74122022-10-21 15:50:52 -07001#!/usr/bin/env python3
2# Copyright (C) 2022 The Android Open Source Project
3#
4# Licensed under the Apache License, Version 2.0 (the "License");
5# you may not use this file except in compliance with the License.
6# You may obtain a copy of the License at
7#
8# http://www.apache.org/licenses/LICENSE-2.0
9#
10# Unless required by applicable law or agreed to in writing, software
11# distributed under the License is distributed on an "AS IS" BASIS,
12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13# See the License for the specific language governing permissions and
14# limitations under the License.
15
16# This tool translates a collection of BUILD.gn files into a mostly equivalent
17# Android.bp file for the Android Soong build system. The input to the tool is a
18# JSON description of the GN build definition generated with the following
19# command:
20#
21# gn desc out --format=json --all-toolchains "//*" > desc.json
22#
23# The tool is then given a list of GN labels for which to generate Android.bp
24# build rules. The dependencies for the GN labels are squashed to the generated
25# Android.bp target, except for actions which get their own genrule. Some
26# libraries are also mapped to their Android equivalents -- see |builtin_deps|.
27
28import argparse
29import collections
30import json
Patrick Rohr16228942022-10-26 14:00:26 -070031import logging as log
Patrick Rohr3a2c3dd2022-11-29 22:29:36 -080032import operator
Patrick Rohr92d74122022-10-21 15:50:52 -070033import os
34import re
35import sys
Motomu Utsumic6277d92022-11-07 15:15:17 +090036import copy
Mohannad Farrag9c2cee12022-12-06 17:11:25 +000037from pathlib import Path
Patrick Rohr92d74122022-10-21 15:50:52 -070038
39import gn_utils
40
Patrick Rohr92d74122022-10-21 15:50:52 -070041ROOT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
42
Patrick Rohr06296362022-11-10 21:37:33 -080043# Default targets to translate to the blueprint file.
44default_targets = [
45 '//components/cronet/android:cronet',
Motomu Utsumiabbfdc32022-11-25 12:19:23 +090046 '//components/cronet:cronet_package',
Patrick Rohr06296362022-11-10 21:37:33 -080047]
48
Patrick Rohr92d74122022-10-21 15:50:52 -070049# Defines a custom init_rc argument to be applied to the corresponding output
50# blueprint target.
51target_initrc = {
Patrick Rohrc36ef422022-10-25 10:38:05 -070052 # TODO: this can probably be removed.
Patrick Rohr92d74122022-10-21 15:50:52 -070053}
54
55target_host_supported = [
Patrick Rohrdc383942022-10-25 10:45:29 -070056 # TODO: remove if this is not useful for the cronet build.
Patrick Rohr92d74122022-10-21 15:50:52 -070057]
58
Patrick Rohr92d74122022-10-21 15:50:52 -070059# Proto target groups which will be made public.
60proto_groups = {
Patrick Rohr95212a22022-10-25 09:53:13 -070061 # TODO: remove if this is not used for the cronet build.
Patrick Rohr92d74122022-10-21 15:50:52 -070062}
63
64# All module names are prefixed with this string to avoid collisions.
Patrick Rohr61b2bad2022-10-25 10:49:20 -070065module_prefix = 'cronet_aml_'
Patrick Rohr92d74122022-10-21 15:50:52 -070066
67# Shared libraries which are directly translated to Android system equivalents.
68shared_library_allowlist = [
69 'android',
70 'android.hardware.atrace@1.0',
71 'android.hardware.health@2.0',
72 'android.hardware.health-V1-ndk',
73 'android.hardware.power.stats@1.0',
74 "android.hardware.power.stats-V1-cpp",
75 'base',
76 'binder',
77 'binder_ndk',
78 'cutils',
79 'hidlbase',
80 'hidltransport',
81 'hwbinder',
82 'incident',
83 'log',
84 'services',
85 'statssocket',
86 "tracingproxy",
87 'utils',
88]
89
90# Static libraries which are directly translated to Android system equivalents.
91static_library_allowlist = [
92 'statslog_perfetto',
93]
94
Patrick Rohrd9dd3b92022-11-09 16:15:30 -080095# Include directories that will be removed from all targets.
96local_include_dirs_denylist = [
Patrick Rohrd9dd3b92022-11-09 16:15:30 -080097]
98
Patrick Rohr92d74122022-10-21 15:50:52 -070099# Name of the module which settings such as compiler flags for all other
100# modules.
101defaults_module = module_prefix + 'defaults'
102
103# Location of the project in the Android source tree.
Patrick Rohr76ceeb52022-11-07 14:18:58 -0800104tree_path = 'external/chromium_org'
Patrick Rohr92d74122022-10-21 15:50:52 -0700105
106# Path for the protobuf sources in the standalone build.
107buildtools_protobuf_src = '//buildtools/protobuf/src'
108
109# Location of the protobuf src dir in the Android source tree.
110android_protobuf_src = 'external/protobuf/src'
111
Mohannad Farragc739dda2022-12-02 15:43:46 +0000112# put all args on a new line for better diffs.
113NEWLINE = ' " +\n "'
Mohannad Farrag00ecfb52022-12-02 14:44:15 +0000114
Patrick Rohr92d74122022-10-21 15:50:52 -0700115# Compiler flags which are passed through to the blueprint.
Motomu Utsumic8b7bea2022-11-16 18:12:44 +0900116cflag_allowlist = [
Motomu Utsumicf68d732022-11-16 18:15:21 +0900117 # needed for zlib:zlib
118 "-mpclmul",
119 # needed for zlib:zlib
120 "-mssse3",
Mohannad Farrag7f29d832022-11-23 19:52:41 +0000121 # needed for zlib:zlib
122 "-msse3",
123 # needed for zlib:zlib
124 "-msse4.2",
Motomu Utsumic8b7bea2022-11-16 18:12:44 +0900125]
Patrick Rohr92d74122022-10-21 15:50:52 -0700126
Patrick Rohr92d74122022-10-21 15:50:52 -0700127# Additional arguments to apply to Android.bp rules.
128additional_args = {
Patrick Rohr2267a0a2022-11-08 18:59:34 -0800129 # TODO: remove if not needed.
Patrick Rohrd90025f2022-11-11 14:18:35 -0800130 'cronet_aml_components_cronet_android_cronet': [
131 ('linker_scripts', {
132 'base/android/library_loader/anchor_functions.lds',
133 }),
134 ],
Patrick Rohrbb0956e2022-11-09 15:37:16 -0800135 'cronet_aml_net_net': [
Patrick Rohr9f4d3e32022-11-09 16:37:31 -0800136 ('export_static_lib_headers', {
137 'cronet_aml_net_third_party_quiche_quiche',
138 'cronet_aml_crypto_crypto',
139 }),
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000140 ],
Patrick Rohr92d74122022-10-21 15:50:52 -0700141}
142
Patrick Rohr92d74122022-10-21 15:50:52 -0700143# Android equivalents for third-party libraries that the upstream project
144# depends on.
145builtin_deps = {
Patrick Rohr14ee0932022-11-15 12:10:27 -0800146 '//net/tools/root_store_tool:root_store_tool':
147 lambda x: None,
Patrick Rohr92d74122022-10-21 15:50:52 -0700148}
149
Motomu Utsumi8ca12412022-11-30 16:27:30 +0900150# Name of tethering apex module
151tethering_apex = "com.android.tethering"
152
Patrick Rohr92d74122022-10-21 15:50:52 -0700153# ----------------------------------------------------------------------------
154# End of configuration.
155# ----------------------------------------------------------------------------
156
157
158class Error(Exception):
159 pass
160
161
162class ThrowingArgumentParser(argparse.ArgumentParser):
163
164 def __init__(self, context):
165 super(ThrowingArgumentParser, self).__init__()
166 self.context = context
167
168 def error(self, message):
169 raise Error('%s: %s' % (self.context, message))
170
171
172def write_blueprint_key_value(output, name, value, sort=True):
173 """Writes a Blueprint key-value pair to the output"""
174
175 if isinstance(value, bool):
176 if value:
177 output.append(' %s: true,' % name)
178 else:
179 output.append(' %s: false,' % name)
180 return
181 if not value:
182 return
183 if isinstance(value, set):
184 value = sorted(value)
185 if isinstance(value, list):
186 output.append(' %s: [' % name)
187 for item in sorted(value) if sort else value:
188 output.append(' "%s",' % item)
189 output.append(' ],')
190 return
191 if isinstance(value, Target):
192 value.to_string(output)
193 return
194 if isinstance(value, dict):
195 kv_output = []
196 for k, v in value.items():
197 write_blueprint_key_value(kv_output, k, v)
198
199 output.append(' %s: {' % name)
200 for line in kv_output:
201 output.append(' %s' % line)
202 output.append(' },')
203 return
204 output.append(' %s: "%s",' % (name, value))
205
206
207class Target(object):
208 """A target-scoped part of a module"""
209
210 def __init__(self, name):
211 self.name = name
Patrick Rohr5d399b32022-11-16 10:19:55 -0800212 self.srcs = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700213 self.shared_libs = set()
214 self.static_libs = set()
215 self.whole_static_libs = set()
Patrick Rohrc03f1bb2022-11-18 16:13:17 -0800216 self.header_libs = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700217 self.cflags = set()
218 self.dist = dict()
219 self.strip = dict()
220 self.stl = None
Motomu Utsumi50ad2172022-11-17 22:29:53 +0900221 self.cppflags = set()
Patrick Rohr3cd5ffb2022-11-18 17:40:55 -0800222 self.local_include_dirs = set()
Patrick Rohr81435162022-11-17 19:34:32 -0800223 self.export_system_include_dirs = set()
Mohannad Farrag631443e2022-11-21 16:17:01 +0000224 self.generated_headers = set()
225 self.export_generated_headers = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700226
227 def to_string(self, output):
228 nested_out = []
Patrick Rohr5d399b32022-11-16 10:19:55 -0800229 self._output_field(nested_out, 'srcs')
Patrick Rohr92d74122022-10-21 15:50:52 -0700230 self._output_field(nested_out, 'shared_libs')
231 self._output_field(nested_out, 'static_libs')
232 self._output_field(nested_out, 'whole_static_libs')
Patrick Rohrc03f1bb2022-11-18 16:13:17 -0800233 self._output_field(nested_out, 'header_libs')
Patrick Rohr92d74122022-10-21 15:50:52 -0700234 self._output_field(nested_out, 'cflags')
235 self._output_field(nested_out, 'stl')
236 self._output_field(nested_out, 'dist')
237 self._output_field(nested_out, 'strip')
Motomu Utsumi50ad2172022-11-17 22:29:53 +0900238 self._output_field(nested_out, 'cppflags')
239 self._output_field(nested_out, 'local_include_dirs')
Patrick Rohr81435162022-11-17 19:34:32 -0800240 self._output_field(nested_out, 'export_system_include_dirs')
Mohannad Farrag631443e2022-11-21 16:17:01 +0000241 self._output_field(nested_out, 'generated_headers')
242 self._output_field(nested_out, 'export_generated_headers')
Patrick Rohr92d74122022-10-21 15:50:52 -0700243
244 if nested_out:
245 output.append(' %s: {' % self.name)
246 for line in nested_out:
247 output.append(' %s' % line)
248 output.append(' },')
249
250 def _output_field(self, output, name, sort=True):
251 value = getattr(self, name)
252 return write_blueprint_key_value(output, name, value, sort)
253
254
255class Module(object):
256 """A single module (e.g., cc_binary, cc_test) in a blueprint."""
257
258 def __init__(self, mod_type, name, gn_target):
259 self.type = mod_type
260 self.gn_target = gn_target
261 self.name = name
262 self.srcs = set()
Patrick Rohr07876662022-11-15 22:55:23 -0800263 self.comment = 'GN: ' + gn_target
Patrick Rohr92d74122022-10-21 15:50:52 -0700264 self.shared_libs = set()
265 self.static_libs = set()
266 self.whole_static_libs = set()
267 self.runtime_libs = set()
268 self.tools = set()
269 self.cmd = None
270 self.host_supported = False
Patrick Rohrcdda6322022-11-15 22:44:16 -0800271 self.device_supported = True
Patrick Rohr92d74122022-10-21 15:50:52 -0700272 self.vendor_available = False
273 self.init_rc = set()
274 self.out = set()
275 self.export_include_dirs = set()
276 self.generated_headers = set()
277 self.export_generated_headers = set()
Patrick Rohrbb0956e2022-11-09 15:37:16 -0800278 self.export_static_lib_headers = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700279 self.defaults = set()
280 self.cflags = set()
281 self.include_dirs = set()
Patrick Rohr3cd5ffb2022-11-18 17:40:55 -0800282 self.local_include_dirs = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700283 self.header_libs = set()
284 self.required = set()
Patrick Rohr3d8c7282022-10-27 13:36:31 -0700285 self.tool_files = set()
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800286 # target contains a dict of Targets indexed by os_arch.
287 # example: { 'android_x86': Target('android_x86')
288 self.target = dict()
289 self.target['android'] = Target('android')
Patrick Rohr82e40742022-11-16 10:20:39 -0800290 self.target['android_x86'] = Target('android_x86')
291 self.target['android_x86_64'] = Target('android_x86_64')
292 self.target['android_arm'] = Target('android_arm')
293 self.target['android_arm64'] = Target('android_arm64')
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800294 self.target['host'] = Target('host')
Patrick Rohr92d74122022-10-21 15:50:52 -0700295 self.stl = None
Patrick Rohrb8f830a2022-10-31 11:18:57 -0700296 self.cpp_std = None
Patrick Rohr92d74122022-10-21 15:50:52 -0700297 self.dist = dict()
298 self.strip = dict()
299 self.data = set()
300 self.apex_available = set()
301 self.min_sdk_version = None
302 self.proto = dict()
Patrick Rohrd90025f2022-11-11 14:18:35 -0800303 self.linker_scripts = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700304 # The genrule_XXX below are properties that must to be propagated back
305 # on the module(s) that depend on the genrule.
306 self.genrule_headers = set()
307 self.genrule_srcs = set()
308 self.genrule_shared_libs = set()
Patrick Rohra1a27872022-10-31 11:57:14 -0700309 self.genrule_header_libs = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700310 self.version_script = None
311 self.test_suites = set()
312 self.test_config = None
313 self.stubs = {}
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000314 self.cppflags = set()
315 self.rtti = False
Motomu Utsumiee47af62022-11-30 16:41:15 +0900316 # Name of the output. Used for setting .so file name for libcronet
Mohannad Farrage815d862022-12-06 17:51:43 +0000317 self.libs = set()
Motomu Utsumiee47af62022-11-30 16:41:15 +0900318 self.stem = None
Motomu Utsumi81bb8342022-12-08 11:47:42 +0900319 self.compile_multilib = None
Mohannad Farragb30d3712022-12-06 17:27:04 +0000320 self.aidl = dict()
Mohannad Farrag3d3d6132022-12-06 18:11:48 +0000321 self.plugins = set()
Mohannad Farrag89f38e42022-12-06 18:54:46 +0000322 self.processor_class = None
Patrick Rohr92d74122022-10-21 15:50:52 -0700323
324 def to_string(self, output):
325 if self.comment:
326 output.append('// %s' % self.comment)
327 output.append('%s {' % self.type)
328 self._output_field(output, 'name')
329 self._output_field(output, 'srcs')
330 self._output_field(output, 'shared_libs')
331 self._output_field(output, 'static_libs')
332 self._output_field(output, 'whole_static_libs')
333 self._output_field(output, 'runtime_libs')
334 self._output_field(output, 'tools')
335 self._output_field(output, 'cmd', sort=False)
336 if self.host_supported:
337 self._output_field(output, 'host_supported')
Patrick Rohrcdda6322022-11-15 22:44:16 -0800338 if not self.device_supported:
339 self._output_field(output, 'device_supported')
Patrick Rohr92d74122022-10-21 15:50:52 -0700340 if self.vendor_available:
341 self._output_field(output, 'vendor_available')
342 self._output_field(output, 'init_rc')
343 self._output_field(output, 'out')
344 self._output_field(output, 'export_include_dirs')
345 self._output_field(output, 'generated_headers')
346 self._output_field(output, 'export_generated_headers')
Patrick Rohrbb0956e2022-11-09 15:37:16 -0800347 self._output_field(output, 'export_static_lib_headers')
Patrick Rohr92d74122022-10-21 15:50:52 -0700348 self._output_field(output, 'defaults')
349 self._output_field(output, 'cflags')
350 self._output_field(output, 'include_dirs')
Patrick Rohr3cd5ffb2022-11-18 17:40:55 -0800351 self._output_field(output, 'local_include_dirs')
Patrick Rohr92d74122022-10-21 15:50:52 -0700352 self._output_field(output, 'header_libs')
353 self._output_field(output, 'required')
354 self._output_field(output, 'dist')
355 self._output_field(output, 'strip')
356 self._output_field(output, 'tool_files')
357 self._output_field(output, 'data')
358 self._output_field(output, 'stl')
Patrick Rohrb8f830a2022-10-31 11:18:57 -0700359 self._output_field(output, 'cpp_std')
Patrick Rohr92d74122022-10-21 15:50:52 -0700360 self._output_field(output, 'apex_available')
361 self._output_field(output, 'min_sdk_version')
362 self._output_field(output, 'version_script')
363 self._output_field(output, 'test_suites')
364 self._output_field(output, 'test_config')
365 self._output_field(output, 'stubs')
366 self._output_field(output, 'proto')
Patrick Rohrd90025f2022-11-11 14:18:35 -0800367 self._output_field(output, 'linker_scripts')
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000368 self._output_field(output, 'cppflags')
Mohannad Farrage815d862022-12-06 17:51:43 +0000369 self._output_field(output, 'libs')
Motomu Utsumiee47af62022-11-30 16:41:15 +0900370 self._output_field(output, 'stem')
Motomu Utsumi81bb8342022-12-08 11:47:42 +0900371 self._output_field(output, 'compile_multilib')
Mohannad Farragb30d3712022-12-06 17:27:04 +0000372 self._output_field(output, 'aidl')
Mohannad Farrag3d3d6132022-12-06 18:11:48 +0000373 self._output_field(output, 'plugins')
Mohannad Farrag89f38e42022-12-06 18:54:46 +0000374 self._output_field(output, 'processor_class')
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000375 if self.rtti:
376 self._output_field(output, 'rtti')
Patrick Rohr92d74122022-10-21 15:50:52 -0700377
378 target_out = []
Patrick Rohr09ee70e2022-11-16 15:20:03 -0800379 for arch, target in sorted(self.target.items()):
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800380 # _output_field calls getattr(self, arch).
381 setattr(self, arch, target)
382 self._output_field(target_out, arch)
383
Patrick Rohr92d74122022-10-21 15:50:52 -0700384 if target_out:
385 output.append(' target: {')
386 for line in target_out:
387 output.append(' %s' % line)
388 output.append(' },')
389
Patrick Rohr92d74122022-10-21 15:50:52 -0700390 output.append('}')
391 output.append('')
392
393 def add_android_static_lib(self, lib):
394 if self.type == 'cc_binary_host':
395 raise Exception('Adding Android static lib for host tool is unsupported')
396 elif self.host_supported:
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800397 self.target['android'].static_libs.add(lib)
Patrick Rohr92d74122022-10-21 15:50:52 -0700398 else:
399 self.static_libs.add(lib)
400
401 def add_android_shared_lib(self, lib):
402 if self.type == 'cc_binary_host':
403 raise Exception('Adding Android shared lib for host tool is unsupported')
404 elif self.host_supported:
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800405 self.target['android'].shared_libs.add(lib)
Patrick Rohr92d74122022-10-21 15:50:52 -0700406 else:
407 self.shared_libs.add(lib)
408
409 def _output_field(self, output, name, sort=True):
410 value = getattr(self, name)
411 return write_blueprint_key_value(output, name, value, sort)
412
Patrick Rohra6ce0232022-11-16 22:09:01 -0800413 def is_compiled(self):
Mohannad Farrag7ff99912022-11-29 17:16:00 +0000414 return self.type not in ('cc_genrule', 'filegroup', 'java_genrule')
Mohannad Farrag1de6cb12022-11-28 12:27:26 +0000415
416 def is_genrule(self):
417 return self.type == "cc_genrule"
Patrick Rohra6ce0232022-11-16 22:09:01 -0800418
Mohannad Farrag7f29d832022-11-23 19:52:41 +0000419 def has_input_files(self):
Mohannad Farrag7f29d832022-11-23 19:52:41 +0000420 return len(self.srcs) > 0 or any([len(target.srcs) > 0 for target in self.target.values()])
421
Mohannad Farragf2391cc2022-11-29 13:26:32 +0000422 def merge_attribute(self, key, source_module, allowed_archs, source_key = None):
423 """
424 Merges the value of the attribute `source_key` for the `dep_module` with
425 the value of the attribute `key` for this module. If the value of the
426 `source_key` is equal to None. Then `key` is used for both modules.
427
428 This merges the attribute for both non-arch and archs
429 specified in `allowed_archs`.
430 :param key: The attribute used for merging in the calling module. Also
431 used for `dep_module` if the `source_key` is None.
432 :param source_module: The module where data is propagated from.
433 :param allowed_archs: A list of archs to merge the attribute on.
434 :param source_key: if the attribute merged from the `dep_module`
435 is different from the `key`
436 """
437 if not source_key:
438 source_key = key
439 self.__dict__[key].update(source_module.__dict__[source_key])
440 for arch_name in source_module.target.keys():
441 if arch_name in allowed_archs:
442 self.target[arch_name].__dict__[key].update(
443 source_module.target[arch_name].__dict__[source_key])
Patrick Rohr92d74122022-10-21 15:50:52 -0700444
445class Blueprint(object):
446 """In-memory representation of an Android.bp file."""
447
448 def __init__(self):
449 self.modules = {}
450
451 def add_module(self, module):
452 """Adds a new module to the blueprint, replacing any existing module
453 with the same name.
454
455 Args:
456 module: Module instance.
457 """
458 self.modules[module.name] = module
459
460 def to_string(self, output):
Patrick Rohr23f26192022-10-25 09:45:22 -0700461 for m in sorted(self.modules.values(), key=lambda m: m.name):
Patrick Rohr92d74122022-10-21 15:50:52 -0700462 m.to_string(output)
463
464
465def label_to_module_name(label):
466 """Turn a GN label (e.g., //:perfetto_tests) into a module name."""
Patrick Rohr07876662022-11-15 22:55:23 -0800467 module = re.sub(r'^//:?', '', label)
Patrick Rohr92d74122022-10-21 15:50:52 -0700468 module = re.sub(r'[^a-zA-Z0-9_]', '_', module)
Motomu Utsumi3fde1482022-11-14 15:55:21 +0900469
Patrick Rohr92d74122022-10-21 15:50:52 -0700470 if not module.startswith(module_prefix):
471 return module_prefix + module
472 return module
473
474
475def is_supported_source_file(name):
476 """Returns True if |name| can appear in a 'srcs' list."""
Patrick Rohrf9f3a992022-11-10 19:40:32 -0800477 return os.path.splitext(name)[1] in ['.c', '.cc', '.cpp', '.java', '.proto', '.S']
Patrick Rohr92d74122022-10-21 15:50:52 -0700478
479
480def create_proto_modules(blueprint, gn, target):
481 """Generate genrules for a proto GN target.
482
483 GN actions are used to dynamically generate files during the build. The
484 Soong equivalent is a genrule. This function turns a specific kind of
485 genrule which turns .proto files into source and header files into a pair
486 equivalent genrules.
487
488 Args:
489 blueprint: Blueprint instance which is being generated.
490 target: gn_utils.Target object.
491
492 Returns:
493 The source_genrule module.
494 """
495 assert (target.type == 'proto_library')
496
Motomu Utsumibd4013f2022-11-17 16:06:05 +0900497 protoc_gn_target_name = gn.get_target('//third_party/protobuf:protoc').name
Motomu Utsumid58c1dc2022-11-16 18:04:46 +0900498 protoc_module_name = label_to_module_name(protoc_gn_target_name)
499 tools = {protoc_module_name}
Motomu Utsumid7e0e422022-11-08 17:49:52 +0900500 cpp_out_dir = '$(genDir)/%s/%s/' % (tree_path, target.proto_in_dir)
Patrick Rohr92d74122022-10-21 15:50:52 -0700501 target_module_name = label_to_module_name(target.name)
502
503 # In GN builds the proto path is always relative to the output directory
504 # (out/tmp.xxx).
Motomu Utsumid58c1dc2022-11-16 18:04:46 +0900505 cmd = ['$(location %s)' % protoc_module_name]
Motomu Utsumid7e0e422022-11-08 17:49:52 +0900506 cmd += ['--proto_path=%s/%s' % (tree_path, target.proto_in_dir)]
Patrick Rohr92d74122022-10-21 15:50:52 -0700507
508 if buildtools_protobuf_src in target.proto_paths:
509 cmd += ['--proto_path=%s' % android_protobuf_src]
510
511 # We don't generate any targets for source_set proto modules because
512 # they will be inlined into other modules if required.
513 if target.proto_plugin == 'source_set':
514 return None
515
516 # Descriptor targets only generate a single target.
517 if target.proto_plugin == 'descriptor':
518 out = '{}.bin'.format(target_module_name)
519
520 cmd += ['--descriptor_set_out=$(out)']
521 cmd += ['$(in)']
522
Mohannad Farrag1de6cb12022-11-28 12:27:26 +0000523 descriptor_module = Module('cc_genrule', target_module_name, target.name)
Patrick Rohr92d74122022-10-21 15:50:52 -0700524 descriptor_module.cmd = ' '.join(cmd)
525 descriptor_module.out = [out]
526 descriptor_module.tools = tools
527 blueprint.add_module(descriptor_module)
528
529 # Recursively extract the .proto files of all the dependencies and
530 # add them to srcs.
531 descriptor_module.srcs.update(
532 gn_utils.label_to_path(src) for src in target.sources)
533 for dep in target.transitive_proto_deps:
534 current_target = gn.get_target(dep)
535 descriptor_module.srcs.update(
536 gn_utils.label_to_path(src) for src in current_target.sources)
537
538 return descriptor_module
539
540 # We create two genrules for each proto target: one for the headers and
541 # another for the sources. This is because the module that depends on the
542 # generated files needs to declare two different types of dependencies --
543 # source files in 'srcs' and headers in 'generated_headers' -- and it's not
544 # valid to generate .h files from a source dependency and vice versa.
545 source_module_name = target_module_name + '_gen'
Mohannad Farrag1de6cb12022-11-28 12:27:26 +0000546 source_module = Module('cc_genrule', source_module_name, target.name)
Patrick Rohr92d74122022-10-21 15:50:52 -0700547 blueprint.add_module(source_module)
548 source_module.srcs.update(
549 gn_utils.label_to_path(src) for src in target.sources)
550
Mohannad Farrag1de6cb12022-11-28 12:27:26 +0000551 header_module = Module('cc_genrule', source_module_name + '_headers',
Patrick Rohr92d74122022-10-21 15:50:52 -0700552 target.name)
553 blueprint.add_module(header_module)
554 header_module.srcs = set(source_module.srcs)
555
556 # TODO(primiano): at some point we should remove this. This was introduced
557 # by aosp/1108421 when adding "protos/" to .proto include paths, in order to
558 # avoid doing multi-repo changes and allow old clients in the android tree
559 # to still do the old #include "perfetto/..." rather than
560 # #include "protos/perfetto/...".
561 header_module.export_include_dirs = {'.', 'protos'}
Patrick Rohr2267a0a2022-11-08 18:59:34 -0800562 # Since the .cc file and .h get created by a different gerule target, they
563 # are not put in the same intermediate path, so local includes do not work
564 # without explictily exporting the include dir.
565 header_module.export_include_dirs.add(target.proto_in_dir)
Patrick Rohr92d74122022-10-21 15:50:52 -0700566
Motomu Utsumi8ca12412022-11-30 16:27:30 +0900567 # This function does not return header_module so setting apex_available attribute here.
568 header_module.apex_available.add(tethering_apex)
569
Patrick Rohr92d74122022-10-21 15:50:52 -0700570 source_module.genrule_srcs.add(':' + source_module.name)
571 source_module.genrule_headers.add(header_module.name)
572
573 if target.proto_plugin == 'proto':
574 suffixes = ['pb']
575 source_module.genrule_shared_libs.add('libprotobuf-cpp-lite')
576 cmd += ['--cpp_out=lite=true:' + cpp_out_dir]
577 elif target.proto_plugin == 'protozero':
578 suffixes = ['pbzero']
579 plugin = create_modules_from_target(blueprint, gn, protozero_plugin)
580 tools.add(plugin.name)
581 cmd += ['--plugin=protoc-gen-plugin=$(location %s)' % plugin.name]
582 cmd += ['--plugin_out=wrapper_namespace=pbzero:' + cpp_out_dir]
583 elif target.proto_plugin == 'cppgen':
584 suffixes = ['gen']
585 plugin = create_modules_from_target(blueprint, gn, cppgen_plugin)
586 tools.add(plugin.name)
587 cmd += ['--plugin=protoc-gen-plugin=$(location %s)' % plugin.name]
588 cmd += ['--plugin_out=wrapper_namespace=gen:' + cpp_out_dir]
589 elif target.proto_plugin == 'ipc':
590 suffixes = ['ipc']
591 plugin = create_modules_from_target(blueprint, gn, ipc_plugin)
592 tools.add(plugin.name)
593 cmd += ['--plugin=protoc-gen-plugin=$(location %s)' % plugin.name]
594 cmd += ['--plugin_out=wrapper_namespace=gen:' + cpp_out_dir]
595 else:
596 raise Error('Unsupported proto plugin: %s' % target.proto_plugin)
597
598 cmd += ['$(in)']
599 source_module.cmd = ' '.join(cmd)
600 header_module.cmd = source_module.cmd
601 source_module.tools = tools
602 header_module.tools = tools
603
604 for sfx in suffixes:
605 source_module.out.update('%s/%s' %
606 (tree_path, src.replace('.proto', '.%s.cc' % sfx))
607 for src in source_module.srcs)
608 header_module.out.update('%s/%s' %
609 (tree_path, src.replace('.proto', '.%s.h' % sfx))
610 for src in header_module.srcs)
611 return source_module
612
613
Patrick Rohr92d74122022-10-21 15:50:52 -0700614def create_proto_group_modules(blueprint, gn, module_name, target_names):
615 # TODO(lalitm): today, we're only adding a Java lite module because that's
616 # the only one used in practice. In the future, if we need other target types
617 # (e.g. C++, Java full etc.) add them here.
618 bp_module_name = label_to_module_name(module_name) + '_java_protos'
619 module = Module('java_library', bp_module_name, bp_module_name)
620 module.comment = f'''GN: [{', '.join(target_names)}]'''
621 module.proto = {'type': 'lite', 'canonical_path_from_root': False}
622
623 for name in target_names:
624 target = gn.get_target(name)
625 module.srcs.update(gn_utils.label_to_path(src) for src in target.sources)
626 for dep_label in target.transitive_proto_deps:
627 dep = gn.get_target(dep_label)
628 module.srcs.update(gn_utils.label_to_path(src) for src in dep.sources)
629
630 blueprint.add_module(module)
631
Mohannad Farrag9c2cee12022-12-06 17:11:25 +0000632def create_gcc_preprocess_modules(blueprint, target):
633 # gcc_preprocess.py internally execute host gcc which is not allowed in genrule.
634 # So, this function create multiple modules and realize equivalent processing
635 # TODO: Consider to support gcc_preprocess.py in different way
636 # It's not great to have genrule and cc_object in the dependency from java_library
637 assert (len(target.sources) == 1)
638 source = list(target.sources)[0]
639 assert (Path(source).suffix == '.template')
640 stem = Path(source).stem
641
642 bp_module_name = label_to_module_name(target.name)
643
644 # Rename .template to .cc since cc_object does not accept .template file as srcs
645 rename_module = Module('genrule', bp_module_name + '_rename', target.name)
646 rename_module.srcs.add(gn_utils.label_to_path(source))
647 rename_module.out.add(stem + '.cc')
648 rename_module.cmd = 'cp $(in) $(out)'
649 blueprint.add_module(rename_module)
650
651 # Preprocess template file and generates java file
652 preprocess_module = Module('cc_object', bp_module_name + '_preprocess', target.name)
653 # -E: stop after preprocessing.
654 # -P: disable line markers, i.e. '#line 309'
655 preprocess_module.cflags.update(['-E', '-P', '-DANDROID'])
656 preprocess_module.srcs.add(':' + rename_module.name)
657 defines = ['-D' + target.args[i+1] for i, arg in enumerate(target.args) if arg == '--define']
658 preprocess_module.cflags.update(defines)
659 # HACK: Specifying compile_multilib to build cc_object only once.
660 # Without this, soong complain to genrule that depends on cc_object when built for 64bit target.
661 # It seems this is because cc object is a module with per-architecture variants and genrule is a
662 # module with default variant. For 64bit target, cc_object is built multiple times for 32/64bit
663 # modes and genrule doesn't know which one to depend on.
664 preprocess_module.compile_multilib = 32
665 blueprint.add_module(preprocess_module)
666
667 # Generates srcjar using soong_zip
668 module = Module('genrule', bp_module_name, target.name)
669 module.srcs.add(':' + preprocess_module.name)
670 module.out.add(stem + '.srcjar')
671 module.cmd = NEWLINE.join([
672 f'cp $(in) $(genDir)/{stem}.java &&',
673 f'$(location soong_zip) -o $(out) -srcjar -f $(genDir)/{stem}.java'
674 ])
675 module.tools.add('soong_zip')
676 blueprint.add_module(module)
677 return module
678
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800679
Mohannad Farrag420c14e2022-11-30 17:13:15 +0000680class BaseActionSanitizer():
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800681 def __init__(self, target):
Patrick Rohr9e414b52022-11-29 22:12:18 -0800682 # Just to be on the safe side, create a deep-copy.
683 self.target = copy.deepcopy(target)
Motomu Utsumi9752bd32022-12-02 15:16:55 +0900684 self.target.args = self._normalize_args()
685
Mohannad Farrag7f7c9b42022-12-02 14:37:56 +0000686 def get_name(self):
687 return label_to_module_name(self.target.name)
688
Motomu Utsumi9752bd32022-12-02 15:16:55 +0900689 def _normalize_args(self):
Patrick Rohr9e414b52022-11-29 22:12:18 -0800690 # Convert ['--param=value'] to ['--param', 'value'] for consistency.
Mohannad Farrag60b37702022-12-02 14:07:33 +0000691 # Escape quotations.
Motomu Utsumi9752bd32022-12-02 15:16:55 +0900692 normalized_args = []
693 for arg in self.target.args:
Mohannad Farrag60b37702022-12-02 14:07:33 +0000694 arg = arg.replace('"', r'\"')
Motomu Utsumi13399322022-12-02 15:36:48 +0900695 if arg.startswith('-'):
696 normalized_args.extend(arg.split('='))
697 else:
698 normalized_args.append(arg)
Motomu Utsumi9752bd32022-12-02 15:16:55 +0900699 return normalized_args
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800700
Patrick Rohr2cad9332022-11-30 14:27:40 -0800701 # There are three types of args:
702 # - flags (--flag)
703 # - value args (--arg value)
704 # - list args (--arg value1 --arg value2)
Motomu Utsumi8be8a262022-12-02 14:35:15 +0900705 # value args have exactly one arg value pair and list args have one or more arg value pairs.
Motomu Utsumi923688c2022-12-01 15:51:05 +0900706 # Note that the set of list args contains the set of value args.
Motomu Utsumi8be8a262022-12-02 14:35:15 +0900707 # This is because list and value args are identical when the list args has only one arg value pair
Patrick Rohr2cad9332022-11-30 14:27:40 -0800708 # Some functions provide special implementations for each type, while others
709 # work on all of them.
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800710 def _has_arg(self, arg):
711 return arg in self.target.args
712
Motomu Utsumi923688c2022-12-01 15:51:05 +0900713 def _get_arg_indices(self, target_arg):
714 return [i for i, arg in enumerate(self.target.args) if arg == target_arg]
Patrick Rohr3a2c3dd2022-11-29 22:29:36 -0800715
Motomu Utsumi923688c2022-12-01 15:51:05 +0900716 # Whether an arg value pair appears once or more times
717 def _is_list_arg(self, arg):
718 indices = self._get_arg_indices(arg)
719 return len(indices) > 0 and all([not self.target.args[i + 1].startswith('--') for i in indices])
720
Motomu Utsumic363b412022-12-01 16:01:58 +0900721 def _update_list_arg(self, arg, func, throw_if_absent = True):
722 if self._should_fail_silently(arg, throw_if_absent):
723 return
724 assert(self._is_list_arg(arg))
725 indices = self._get_arg_indices(arg)
726 for i in indices:
727 self._set_arg_at(i + 1, func(self.target.args[i + 1]))
728
Motomu Utsumi923688c2022-12-01 15:51:05 +0900729 # Whether an arg value pair appears exactly once
Patrick Rohref4f2bf2022-11-30 14:22:40 -0800730 def _is_value_arg(self, arg):
Motomu Utsumid75b8b52022-12-02 14:29:00 +0900731 return operator.countOf(self.target.args, arg) == 1 and self._is_list_arg(arg)
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800732
Patrick Rohr2cad9332022-11-30 14:27:40 -0800733 def _get_value_arg(self, arg):
Patrick Rohref4f2bf2022-11-30 14:22:40 -0800734 assert(self._is_value_arg(arg))
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800735 i = self.target.args.index(arg)
736 return self.target.args[i + 1]
737
Patrick Rohrf0abead2022-11-30 19:44:10 -0800738 # used to check whether a function call should cause an error when an arg is
739 # missing.
740 def _should_fail_silently(self, arg, throw_if_absent):
741 return not throw_if_absent and not self._has_arg(arg)
742
743 def _set_value_arg(self, arg, value, throw_if_absent = True):
744 if self._should_fail_silently(arg, throw_if_absent):
Patrick Rohr4d74aed2022-11-30 15:42:16 -0800745 return
Patrick Rohref4f2bf2022-11-30 14:22:40 -0800746 assert(self._is_value_arg(arg))
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800747 i = self.target.args.index(arg)
748 self.target.args[i + 1] = value
749
Patrick Rohrf0abead2022-11-30 19:44:10 -0800750 def _update_value_arg(self, arg, func, throw_if_absent = True):
751 if self._should_fail_silently(arg, throw_if_absent):
Patrick Rohr4d74aed2022-11-30 15:42:16 -0800752 return
Patrick Rohr1bedf6c2022-11-30 15:12:57 -0800753 self._set_value_arg(arg, func(self._get_value_arg(arg)))
754
Patrick Rohr77c4f5c2022-11-30 12:56:29 -0800755 def _set_arg_at(self, position, value):
Mohannad Farrag9ab17932022-11-30 17:28:35 +0000756 self.target.args[position] = value
757
Patrick Rohr357b25c2022-11-30 19:46:26 -0800758 def _delete_value_arg(self, arg, throw_if_absent = True):
Patrick Rohrf0abead2022-11-30 19:44:10 -0800759 if self._should_fail_silently(arg, throw_if_absent):
Patrick Rohr4d74aed2022-11-30 15:42:16 -0800760 return
Patrick Rohr357b25c2022-11-30 19:46:26 -0800761 assert(self._is_value_arg(arg))
Patrick Rohr9f439322022-11-30 15:56:15 -0800762 i = self.target.args.index(arg)
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800763 self.target.args.pop(i)
Patrick Rohr357b25c2022-11-30 19:46:26 -0800764 self.target.args.pop(i)
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800765
Patrick Rohr1f7dd582022-11-30 13:44:07 -0800766 def _append_arg(self, arg, value):
767 self.target.args.append(arg)
768 self.target.args.append(value)
769
Mohannad Farrag8fa90652022-12-01 15:40:40 +0000770 def _sanitize_filepath_with_location_tag(self, arg):
771 if arg.startswith('../../'):
772 arg = self._sanitize_filepath(arg)
773 arg = self._add_location_tag(arg)
774 return arg
775
Patrick Rohr73ef7ae2022-11-29 22:33:09 -0800776 # wrap filename in location tag.
Patrick Rohrfda026732022-11-30 16:07:11 -0800777 def _add_location_tag(self, filename):
Patrick Rohr73ef7ae2022-11-29 22:33:09 -0800778 return '$(location %s)' % filename
779
Patrick Rohr0e24c5f2022-11-30 15:20:21 -0800780 # applies common directory transformation that *should* be universally applicable.
781 # TODO: verify if it actually *is* universally applicable.
Patrick Rohr872a2812022-11-30 19:28:22 -0800782 def _sanitize_filepath(self, filepath):
Patrick Rohr0e24c5f2022-11-30 15:20:21 -0800783 # Careful, order matters!
Patrick Rohr8bcd7832022-11-30 19:48:56 -0800784 # delete all leading ../
Patrick Rohr9e5a3c72022-11-30 15:51:30 -0800785 filepath = re.sub('^(\.\./)+', '', filepath)
Patrick Rohr0e24c5f2022-11-30 15:20:21 -0800786 filepath = re.sub('^gen/jni_headers', '$(genDir)', filepath)
787 filepath = re.sub('^gen', '$(genDir)', filepath)
788 return filepath
Patrick Rohr32276892022-11-29 22:38:13 -0800789
Motomu Utsumi21485ba2022-12-01 17:01:50 +0900790 # Iterate through all the args and apply function
791 def _update_all_args(self, func):
792 self.target.args = [func(arg) for arg in self.target.args]
793
Mohannad Farragd5515ca2022-12-02 15:39:53 +0000794 def get_cmd(self):
Mohannad Farragc739dda2022-12-02 15:43:46 +0000795 arg_string = NEWLINE.join(self.target.args)
796 cmd = '$(location %s) %s' % (
797 gn_utils.label_to_path(self.target.script), arg_string)
798
799 if self.use_response_file:
800 # Pipe response file contents into script
801 cmd = 'echo \'%s\' |%s%s' % (self.target.response_file_contents, NEWLINE, cmd)
802 return cmd
Mohannad Farragd5515ca2022-12-02 15:39:53 +0000803
Motomu Utsumi5afd0812022-12-02 15:43:36 +0900804 def get_outputs(self):
805 return self.target.outputs
806
Motomu Utsumi80fa0b02022-12-05 12:50:57 +0900807 def get_srcs(self):
808 # gn treats inputs and sources for actions equally.
809 # soong only supports source files inside srcs, non-source files are added as
810 # tool_files dependency.
811 files = self.target.sources.union(self.target.inputs)
812 return {gn_utils.label_to_path(file) for file in files if is_supported_source_file(file)}
813
Motomu Utsumiaaf42cf2022-12-05 12:55:02 +0900814 def get_tool_files(self):
815 # gn treats inputs and sources for actions equally.
816 # soong only supports source files inside srcs, non-source files are added as
817 # tool_files dependency.
818 files = self.target.sources.union(self.target.inputs)
Motomu Utsumi69975862022-12-05 12:59:06 +0900819 tool_files = {gn_utils.label_to_path(file)
820 for file in files if not is_supported_source_file(file)}
821 tool_files.add(gn_utils.label_to_path(self.target.script))
822 return tool_files
Motomu Utsumiaaf42cf2022-12-05 12:55:02 +0900823
Motomu Utsumicdb45ea2022-12-02 17:05:07 +0900824 def _sanitize_args(self):
Mohannad Farrag00ecfb52022-12-02 14:44:15 +0000825 # Handle passing parameters via response file by piping them into the script
826 # and reading them from /dev/stdin.
827
Mohannad Farraga0e37c12022-12-02 14:46:08 +0000828 self.use_response_file = gn_utils.RESPONSE_FILE in self.target.args
Mohannad Farrag00ecfb52022-12-02 14:44:15 +0000829 if self.use_response_file:
830 # Replace {{response_file_contents}} with /dev/stdin
Mohannad Farraga0e37c12022-12-02 14:46:08 +0000831 self.target.args = ['/dev/stdin' if it == gn_utils.RESPONSE_FILE else it
832 for it in self.target.args]
Motomu Utsumicdb45ea2022-12-02 17:05:07 +0900833
834 def _sanitize_outputs(self):
835 pass
836
Motomu Utsumi735a5a42022-12-05 12:15:07 +0900837 def _sanitize_inputs(self):
838 pass
839
Motomu Utsumicdb45ea2022-12-02 17:05:07 +0900840 def sanitize(self):
841 self._sanitize_args()
842 self._sanitize_outputs()
Motomu Utsumi735a5a42022-12-05 12:15:07 +0900843 self._sanitize_inputs()
Motomu Utsumicdb45ea2022-12-02 17:05:07 +0900844
Motomu Utsumi7db75832022-12-02 16:46:22 +0900845 # Whether this target generates header files
846 def is_header_generated(self):
Motomu Utsumia91ade62022-12-02 16:58:36 +0900847 return any(os.path.splitext(it)[1] == '.h' for it in self.target.outputs)
Motomu Utsumi7db75832022-12-02 16:46:22 +0900848
Mohannad Farrag9ab17932022-11-30 17:28:35 +0000849class WriteBuildDateHeaderSanitizer(BaseActionSanitizer):
Motomu Utsumi805591d2022-12-02 17:17:16 +0900850 def _sanitize_args(self):
Patrick Rohr77c4f5c2022-11-30 12:56:29 -0800851 self._set_arg_at(0, '$(out)')
Motomu Utsumi805591d2022-12-02 17:17:16 +0900852 super()._sanitize_args()
Mohannad Farrag9ab17932022-11-30 17:28:35 +0000853
Mohannad Farrag71353f92022-11-30 17:20:48 +0000854class WriteBuildFlagHeaderSanitizer(BaseActionSanitizer):
Motomu Utsumi805591d2022-12-02 17:17:16 +0900855 def _sanitize_args(self):
Patrick Rohr2cad9332022-11-30 14:27:40 -0800856 self._set_value_arg('--gen-dir', '.')
857 self._set_value_arg('--output', '$(out)')
Motomu Utsumi805591d2022-12-02 17:17:16 +0900858 super()._sanitize_args()
Patrick Rohrf6de33f2022-11-29 22:02:55 -0800859
Patrick Rohr0242a3f2022-11-30 13:48:59 -0800860class JniGeneratorSanitizer(BaseActionSanitizer):
Motomu Utsumi4d551d72022-12-01 16:18:23 +0900861 def _add_location_tag_to_filepath(self, arg):
862 if not arg.endswith('.class'):
863 # --input_file supports both .class specifiers or source files as arguments.
864 # Only source files need to be wrapped inside a $(location <label>) tag.
865 arg = self._add_location_tag(arg)
866 return arg
867
Motomu Utsumi805591d2022-12-02 17:17:16 +0900868 def _sanitize_args(self):
Patrick Rohrf0abead2022-11-30 19:44:10 -0800869 self._update_value_arg('--jar_file', self._sanitize_filepath, False)
870 self._update_value_arg('--jar_file', self._add_location_tag, False)
Patrick Rohr0242a3f2022-11-30 13:48:59 -0800871 if self._has_arg('--jar_file'):
872 self._append_arg('--javap', '$$(find out/.path -name javap)')
Patrick Rohr872a2812022-11-30 19:28:22 -0800873 self._update_value_arg('--output_dir', self._sanitize_filepath)
Patrick Rohrf0abead2022-11-30 19:44:10 -0800874 self._update_value_arg('--includes', self._sanitize_filepath, False)
Patrick Rohr357b25c2022-11-30 19:46:26 -0800875 self._delete_value_arg('--prev_output_dir', False)
Motomu Utsumi4d551d72022-12-01 16:18:23 +0900876 self._update_list_arg('--input_file', self._sanitize_filepath)
877 self._update_list_arg('--input_file', self._add_location_tag_to_filepath)
Motomu Utsumi805591d2022-12-02 17:17:16 +0900878 super()._sanitize_args()
Patrick Rohr0242a3f2022-11-30 13:48:59 -0800879
Motomu Utsumi94019962022-12-02 17:18:58 +0900880 def _sanitize_outputs(self):
Motomu Utsumid4f72642022-12-02 16:01:59 +0900881 # fix target.output directory to match #include statements.
882 self.target.outputs = {re.sub('^jni_headers/', '', out) for out in self.target.outputs}
Motomu Utsumi94019962022-12-02 17:18:58 +0900883 super()._sanitize_outputs()
Motomu Utsumid4f72642022-12-02 16:01:59 +0900884
Motomu Utsumia6824ea2022-12-05 14:53:11 +0900885 def get_tool_files(self):
886 tool_files = super().get_tool_files()
887 # android_jar.classes should be part of the tools as it list implicit classes
888 # for the script to generate JNI headers.
889 tool_files.add("base/android/jni_generator/android_jar.classes")
890 return tool_files
891
Motomu Utsumib80903c2022-12-01 16:21:55 +0900892class JniRegistrationGeneratorSanitizer(BaseActionSanitizer):
Motomu Utsumi07027f62022-12-05 12:16:53 +0900893 def _sanitize_inputs(self):
894 self.target.inputs = [file for file in self.target.inputs if not file.startswith('//out/')]
895
Motomu Utsumi805591d2022-12-02 17:17:16 +0900896 def _sanitize_args(self):
Motomu Utsumi28cbf2f2022-12-01 16:24:29 +0900897 self._update_value_arg('--depfile', self._sanitize_filepath)
898 self._update_value_arg('--srcjar-path', self._sanitize_filepath)
899 self._update_value_arg('--header-path', self._sanitize_filepath)
Motomu Utsumi55907472022-12-01 16:26:21 +0900900 self._set_value_arg('--sources-files', '$(genDir)/java.sources')
Motomu Utsumi4fe0b952022-12-01 16:29:15 +0900901 # update_jni_registration_module removes them from the srcs of the module
902 # It might be better to remove sources by '--sources-exclusions'
903 self._delete_value_arg('--sources-exclusions')
Motomu Utsumi805591d2022-12-02 17:17:16 +0900904 super()._sanitize_args()
Patrick Rohr0242a3f2022-11-30 13:48:59 -0800905
Mohannad Farrag291f5672022-12-02 15:49:00 +0000906 def get_cmd(self):
907 # jni_registration_generator.py doesn't work with python2
908 cmd = "python3 " + super().get_cmd()
909 # Path in the original sources file does not work in genrule.
910 # So creating sources file in cmd based on the srcs of this target.
911 # Adding ../$(current_dir)/ to the head because jni_registration_generator.py uses the files
912 # whose path startswith(..)
913 commands = ["current_dir=`basename \\\`pwd\\\``;",
914 "for f in $(in);",
915 "do",
916 "echo \\\"../$$current_dir/$$f\\\" >> $(genDir)/java.sources;",
917 "done;",
918 cmd]
919
920 # .h file jni_registration_generator.py generates has #define with directory name.
921 # With the genrule env that contains "." which is invalid. So replace that at the end of cmd.
922 commands.append(";sed -i -e 's/OUT_SOONG_.TEMP_SBOX_.*_OUT/GEN/g' ")
923 commands.append("$(genDir)/components/cronet/android/cronet_jni_registration.h")
924 return NEWLINE.join(commands)
925
Mohannad Farrag457bc022022-12-02 14:31:22 +0000926class JavaJniRegistrationGeneratorSanitizer(JniRegistrationGeneratorSanitizer):
Mohannad Farrag7f7c9b42022-12-02 14:37:56 +0000927 def get_name(self):
928 return label_to_module_name(self.target.name) + "__java"
929
Mohannad Farrag457bc022022-12-02 14:31:22 +0000930 def _sanitize_outputs(self):
931 self.target.outputs = [out for out in self.target.outputs if
932 out.endswith(".srcjar")]
933 super()._sanitize_outputs()
934
Motomu Utsumi6af5b2a2022-12-01 16:33:42 +0900935class VersionSanitizer(BaseActionSanitizer):
Motomu Utsumi805591d2022-12-02 17:17:16 +0900936 def _sanitize_args(self):
Motomu Utsumic6b08b82022-12-01 16:48:19 +0900937 self._set_value_arg('-o', '$(out)')
Motomu Utsumi21485ba2022-12-01 17:01:50 +0900938 # args for the version.py contain file path without leading --arg key. So apply sanitize
939 # function for all the args.
Mohannad Farrag8fa90652022-12-01 15:40:40 +0000940 self._update_all_args(self._sanitize_filepath_with_location_tag)
Mohannad Farrag25697342022-12-02 18:01:48 +0000941 self._set_value_arg('-e', "'%s'" % self._get_value_arg('-e'))
Motomu Utsumi805591d2022-12-02 17:17:16 +0900942 super()._sanitize_args()
Motomu Utsumi6af5b2a2022-12-01 16:33:42 +0900943
Motomu Utsumidf634142022-12-05 15:02:44 +0900944 def get_tool_files(self):
945 tool_files = super().get_tool_files()
946 # android_chrome_version.py is not specified in anywhere but version.py imports this file
947 tool_files.add('build/util/android_chrome_version.py')
948 return tool_files
949
Mohannad Farragb73ce0f2022-12-01 15:43:58 +0000950class JavaCppEnumSanitizer(BaseActionSanitizer):
Motomu Utsumi805591d2022-12-02 17:17:16 +0900951 def _sanitize_args(self):
Mohannad Farragb73ce0f2022-12-01 15:43:58 +0000952 self._update_all_args(self._sanitize_filepath_with_location_tag)
953 self._set_value_arg('--srcjar', '$(out)')
Motomu Utsumi805591d2022-12-02 17:17:16 +0900954 super()._sanitize_args()
Mohannad Farragb73ce0f2022-12-01 15:43:58 +0000955
Motomu Utsumi9701d2f2022-12-02 16:53:06 +0900956class MakeDafsaSanitizer(BaseActionSanitizer):
957 def is_header_generated(self):
Motomu Utsumi1e028b82022-12-02 16:54:20 +0900958 # This script generates .cc files but they are #included by other sources
959 # (e.g. registry_controlled_domain.cc)
960 return True
Motomu Utsumi9701d2f2022-12-02 16:53:06 +0900961
Motomu Utsumi56a2f442022-12-05 16:01:34 +0900962class JavaCppFeatureSanitizer(BaseActionSanitizer):
Motomu Utsumid7c36772022-12-05 16:04:37 +0900963 def _sanitize_args(self):
964 self._update_all_args(self._sanitize_filepath_with_location_tag)
965 self._set_value_arg('--srcjar', '$(out)')
966 super()._sanitize_args()
Motomu Utsumi56a2f442022-12-05 16:01:34 +0900967
Motomu Utsumice5166b2022-12-05 16:08:37 +0900968class JavaCppStringSanitizer(BaseActionSanitizer):
Motomu Utsumi3f7ab312022-12-05 16:12:21 +0900969 def _sanitize_args(self):
970 self._update_all_args(self._sanitize_filepath_with_location_tag)
971 self._set_value_arg('--srcjar', '$(out)')
972 super()._sanitize_args()
Motomu Utsumice5166b2022-12-05 16:08:37 +0900973
Motomu Utsumib90a76b2022-12-05 16:17:26 +0900974class WriteNativeLibrariesJavaSanitizer(BaseActionSanitizer):
Motomu Utsumi3dbc2762022-12-05 16:20:21 +0900975 def _sanitize_args(self):
976 self._set_value_arg('--output', '$(out)')
977 super()._sanitize_args()
Motomu Utsumib90a76b2022-12-05 16:17:26 +0900978
Mohannad Farrag457bc022022-12-02 14:31:22 +0000979def get_action_sanitizer(target, type):
Patrick Rohr7f117152022-11-30 13:58:05 -0800980 if target.script == "//build/write_buildflag_header.py":
981 return WriteBuildFlagHeaderSanitizer(target)
982 elif target.script == "//build/write_build_date_header.py":
983 return WriteBuildDateHeaderSanitizer(target)
984 elif target.script == '//base/android/jni_generator/jni_generator.py':
985 return JniGeneratorSanitizer(target)
Motomu Utsumib80903c2022-12-01 16:21:55 +0900986 elif target.script == '//base/android/jni_generator/jni_registration_generator.py':
Mohannad Farrag457bc022022-12-02 14:31:22 +0000987 if type == 'java_genrule':
988 return JavaJniRegistrationGeneratorSanitizer(target)
989 else:
990 return JniRegistrationGeneratorSanitizer(target)
Motomu Utsumi6af5b2a2022-12-01 16:33:42 +0900991 elif target.script == "//build/util/version.py":
992 return VersionSanitizer(target)
Mohannad Farragb73ce0f2022-12-01 15:43:58 +0000993 elif target.script == "//build/android/gyp/java_cpp_enum.py":
994 return JavaCppEnumSanitizer(target)
Motomu Utsumi9701d2f2022-12-02 16:53:06 +0900995 elif target.script == "//net/tools/dafsa/make_dafsa.py":
996 return MakeDafsaSanitizer(target)
Motomu Utsumi56a2f442022-12-05 16:01:34 +0900997 elif target.script == '//build/android/gyp/java_cpp_features.py':
998 return JavaCppFeatureSanitizer(target)
Motomu Utsumice5166b2022-12-05 16:08:37 +0900999 elif target.script == '//build/android/gyp/java_cpp_strings.py':
1000 return JavaCppStringSanitizer(target)
Motomu Utsumib90a76b2022-12-05 16:17:26 +09001001 elif target.script == '//build/android/gyp/write_native_libraries_java.py':
1002 return WriteNativeLibrariesJavaSanitizer(target)
Patrick Rohr7f117152022-11-30 13:58:05 -08001003 else:
1004 # TODO: throw exception here once all script hacks have been converted.
1005 return BaseActionSanitizer(target)
1006
Mohannad Farragbab6c892022-11-02 14:09:46 +00001007def create_action_foreach_modules(blueprint, target):
1008 """ The following assumes that rebase_path exists in the args.
1009 The args of an action_foreach contains hints about which output files are generated
1010 by which source files.
1011 This is copied directly from the args
1012 "gen/net/base/registry_controlled_domains/{{source_name_part}}-reversed-inc.cc"
1013 So each source file will generate an output whose name is the {source_name-reversed-inc.cc}
1014 """
1015 new_args = []
Motomu Utsumi56afcac2022-11-04 12:58:30 +09001016 for i, src in enumerate(sorted(target.sources)):
Mohannad Farragbab6c892022-11-02 14:09:46 +00001017 # don't add script arg for the first source -- create_action_module
1018 # already does this.
1019 if i != 0:
1020 new_args.append('&& python3 $(location %s)' %
1021 gn_utils.label_to_path(target.script))
1022 for arg in target.args:
1023 if '{{source}}' in arg:
1024 new_args.append('$(location %s)' % (gn_utils.label_to_path(src)))
1025 elif '{{source_name_part}}' in arg:
1026 source_name_part = src.split("/")[-1] # Get the file name only
1027 source_name_part = source_name_part.split(".")[0] # Remove the extension (Ex: .cc)
1028 file_name = arg.replace('{{source_name_part}}', source_name_part).split("/")[-1]
1029 # file_name represent the output file name. But we need the whole path
1030 # This can be found from target.outputs.
1031 for out in target.outputs:
1032 if out.endswith(file_name):
1033 new_args.append('$(location %s)' % out)
1034 else:
1035 new_args.append(arg)
1036
1037 target.args = new_args
Mohannad Farrag7ff99912022-11-29 17:16:00 +00001038 return create_action_module(blueprint, target, 'cc_genrule')
Motomu Utsumia6c33152022-11-02 18:21:55 +09001039
Mohannad Farrag7ff99912022-11-29 17:16:00 +00001040def create_action_module(blueprint, target, type):
Mohannad Farrag457bc022022-12-02 14:31:22 +00001041 sanitizer = get_action_sanitizer(target, type)
Motomu Utsumicdb45ea2022-12-02 17:05:07 +09001042 sanitizer.sanitize()
Motomu Utsumi47fd40a2022-12-05 15:07:31 +09001043
Mohannad Farrag7f7c9b42022-12-02 14:37:56 +00001044 module = Module(type, sanitizer.get_name(), target.name)
Mohannad Farragc739dda2022-12-02 15:43:46 +00001045 module.cmd = sanitizer.get_cmd()
Motomu Utsumi24213232022-12-02 16:04:05 +09001046 module.out = sanitizer.get_outputs()
Motomu Utsumi7db75832022-12-02 16:46:22 +09001047 if sanitizer.is_header_generated():
1048 module.genrule_headers.add(module.name)
Motomu Utsumi80fa0b02022-12-05 12:50:57 +09001049 module.srcs = sanitizer.get_srcs()
Motomu Utsumiaaf42cf2022-12-05 12:55:02 +09001050 module.tool_files = sanitizer.get_tool_files()
Patrick Rohr9b99a982022-10-28 11:00:57 -07001051
Patrick Rohre1a853e2022-10-26 12:31:39 -07001052 blueprint.add_module(module)
1053 return module
1054
1055
Patrick Rohr92d74122022-10-21 15:50:52 -07001056
Motomu Utsumic34b1372022-11-17 22:15:51 +09001057def _get_cflags(cflags, defines):
1058 cflags = {flag for flag in cflags if flag in cflag_allowlist}
Motomu Utsumifa7e9262022-10-26 19:43:02 +09001059 # Consider proper allowlist or denylist if needed
Motomu Utsumic34b1372022-11-17 22:15:51 +09001060 cflags |= set("-D%s" % define.replace("\"", "\\\"") for define in defines)
Patrick Rohr92d74122022-10-21 15:50:52 -07001061 return cflags
1062
Motomu Utsumic34b1372022-11-17 22:15:51 +09001063def set_module_flags(module, cflags, defines):
1064 module.cflags.update(_get_cflags(cflags, defines))
1065 # TODO: implement proper cflag parsing.
1066 for flag in cflags:
1067 if '-std=' in flag:
1068 module.cpp_std = flag[len('-std='):]
Motomu Utsumic34b1372022-11-17 22:15:51 +09001069 if '-fexceptions' in flag:
1070 module.cppflags.add('-fexceptions')
Patrick Rohr92d74122022-10-21 15:50:52 -07001071
Mohannad Farrag631443e2022-11-21 16:17:01 +00001072def add_genrule_per_arch(module, dep_module, type):
1073 module.generated_headers.update(dep_module.genrule_headers)
1074 # If the module is a static library, export all the generated headers.
1075 if type == 'cc_library_static':
1076 module.export_generated_headers.update(dep_module.genrule_headers)
1077 module.srcs.update(dep_module.genrule_srcs)
1078 module.shared_libs.update(dep_module.genrule_shared_libs)
1079 module.header_libs.update(dep_module.genrule_header_libs)
1080
Motomu Utsumi88efbb42022-11-17 22:18:15 +09001081def set_module_include_dirs(module, cflags, include_dirs):
Motomu Utsumi88efbb42022-11-17 22:18:15 +09001082 for flag in cflags:
1083 if '-isystem' in flag:
Patrick Rohr3cd5ffb2022-11-18 17:40:55 -08001084 module.local_include_dirs.add(flag[len('-isystem../../'):])
Motomu Utsumi88efbb42022-11-17 22:18:15 +09001085
1086 # Adding local_include_dirs is necessary due to source_sets / filegroups
1087 # which do not properly propagate include directories.
1088 # Filter any directory inside //out as a) this directory does not exist for
1089 # aosp / soong builds and b) the include directory should already be
1090 # configured via library dependency.
Patrick Rohr3cd5ffb2022-11-18 17:40:55 -08001091 module.local_include_dirs.update([gn_utils.label_to_path(d)
Motomu Utsumi88efbb42022-11-17 22:18:15 +09001092 for d in include_dirs
1093 if not re.match('^//out/.*', d)])
Motomu Utsumi88efbb42022-11-17 22:18:15 +09001094
Patrick Rohr92d74122022-10-21 15:50:52 -07001095def create_modules_from_target(blueprint, gn, gn_target_name):
1096 """Generate module(s) for a given GN target.
1097
1098 Given a GN target name, generate one or more corresponding modules into a
1099 blueprint. The only case when this generates >1 module is proto libraries.
1100
1101 Args:
1102 blueprint: Blueprint instance which is being generated.
1103 gn: gn_utils.GnParser object.
1104 gn_target_name: GN target for module generation.
1105 """
1106 bp_module_name = label_to_module_name(gn_target_name)
1107 if bp_module_name in blueprint.modules:
1108 return blueprint.modules[bp_module_name]
1109 target = gn.get_target(gn_target_name)
Patrick Rohr16228942022-10-26 14:00:26 -07001110 log.info('create modules for %s (%s)', target.name, target.type)
Patrick Rohr92d74122022-10-21 15:50:52 -07001111
Patrick Rohr92d74122022-10-21 15:50:52 -07001112 if target.type == 'executable':
Patrick Rohrc8f41cd2022-11-15 22:46:10 -08001113 if target.testonly:
Patrick Rohr92d74122022-10-21 15:50:52 -07001114 module_type = 'cc_test'
1115 else:
Patrick Rohrc8f41cd2022-11-15 22:46:10 -08001116 # Can be used for both host and device targets.
Patrick Rohr92d74122022-10-21 15:50:52 -07001117 module_type = 'cc_binary'
1118 module = Module(module_type, bp_module_name, gn_target_name)
1119 elif target.type == 'static_library':
1120 module = Module('cc_library_static', bp_module_name, gn_target_name)
1121 elif target.type == 'shared_library':
1122 module = Module('cc_library_shared', bp_module_name, gn_target_name)
1123 elif target.type == 'source_set':
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001124 module = Module('cc_object', bp_module_name, gn_target_name)
Patrick Rohr92d74122022-10-21 15:50:52 -07001125 elif target.type == 'group':
1126 # "group" targets are resolved recursively by gn_utils.get_target().
1127 # There's nothing we need to do at this level for them.
1128 return None
1129 elif target.type == 'proto_library':
1130 module = create_proto_modules(blueprint, gn, target)
1131 if module is None:
1132 return None
1133 elif target.type == 'action':
Mohannad Farrag4b89a822022-12-02 14:25:44 +00001134 module = create_action_module(blueprint, target, 'cc_genrule')
Mohannad Farragf076f3e2022-10-31 17:45:28 +00001135 elif target.type == 'action_foreach':
Mohannad Farragbab6c892022-11-02 14:09:46 +00001136 module = create_action_foreach_modules(blueprint, target)
Patrick Rohr59a76652022-10-26 12:36:56 -07001137 elif target.type == 'copy':
1138 # TODO: careful now! copy targets are not supported yet, but this will stop
1139 # traversing the dependency tree. For //base:base, this is not a big
1140 # problem as libicu contains the only copy target which happens to be a
1141 # leaf node.
1142 return None
Patrick Rohrad440602022-11-10 22:09:04 -08001143 elif target.type == 'java_group':
1144 # Java targets are handled outside of create_modules_from_target.
1145 return None
Patrick Rohr92d74122022-10-21 15:50:52 -07001146 else:
1147 raise Error('Unknown target %s (%s)' % (target.name, target.type))
1148
1149 blueprint.add_module(module)
Patrick Rohr92d74122022-10-21 15:50:52 -07001150 module.init_rc = target_initrc.get(target.name, [])
1151 module.srcs.update(
1152 gn_utils.label_to_path(src)
1153 for src in target.sources
Motomu Utsumif951e502022-11-07 19:31:15 +09001154 if is_supported_source_file(src) and not src.startswith("//out/test"))
Patrick Rohr92d74122022-10-21 15:50:52 -07001155
Patrick Rohr3b5ff762022-11-16 10:22:16 -08001156 # Add arch-specific properties
1157 for arch_name, arch in target.arch.items():
Motomu Utsumi40f95c52022-11-17 19:39:13 +09001158 module.target[arch_name].srcs.update(
1159 gn_utils.label_to_path(src)
1160 for src in arch.sources
1161 if is_supported_source_file(src) and not src.startswith("//out/test"))
Patrick Rohr3b5ff762022-11-16 10:22:16 -08001162
Mohannad Farragbaf0d572022-11-22 11:53:54 +00001163 module.rtti = target.rtti
1164
Patrick Rohr92d74122022-10-21 15:50:52 -07001165 if target.type in gn_utils.LINKER_UNIT_TYPES:
Motomu Utsumic34b1372022-11-17 22:15:51 +09001166 set_module_flags(module, target.cflags, target.defines)
Motomu Utsumi88efbb42022-11-17 22:18:15 +09001167 set_module_include_dirs(module, target.cflags, target.include_dirs)
Motomu Utsumif0f47682022-11-17 22:34:39 +09001168 # TODO: set_module_xxx is confusing, apply similar function to module and target in better way.
1169 for arch_name, arch in target.arch.items():
1170 set_module_flags(module.target[arch_name], arch.cflags, arch.defines)
Motomu Utsumi3371d682022-11-28 16:56:52 +09001171 # -Xclang -target-feature -Xclang +mte are used to enable MTE (Memory Tagging Extensions).
1172 # Flags which does not start with '-' could not be in the cflags so enabling MTE by
1173 # -march and -mcpu Feature Modifiers. MTE is only available on arm64. This is needed for
1174 # building //base/allocator/partition_allocator:partition_alloc for arm64.
1175 if '+mte' in arch.cflags and arch_name == 'android_arm64':
1176 module.target[arch_name].cflags.add('-march=armv8-a+memtag')
Motomu Utsumif0f47682022-11-17 22:34:39 +09001177 set_module_include_dirs(module.target[arch_name], arch.cflags, arch.include_dirs)
Patrick Rohr92d74122022-10-21 15:50:52 -07001178
Mohannad Farragf2391cc2022-11-29 13:26:32 +00001179 module.host_supported = target.host_supported()
1180 module.device_supported = target.device_supported()
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001181
Motomu Utsumi8ca12412022-11-30 16:27:30 +09001182 if module.is_genrule():
1183 module.apex_available.add(tethering_apex)
1184
Mohannad Farragf2391cc2022-11-29 13:26:32 +00001185 if module.is_compiled():
Patrick Rohr92d74122022-10-21 15:50:52 -07001186 # Don't try to inject library/source dependencies into genrules or
1187 # filegroups because they are not compiled in the traditional sense.
1188 module.defaults = [defaults_module]
1189 for lib in target.libs:
1190 # Generally library names should be mangled as 'libXXX', unless they
1191 # are HAL libraries (e.g., android.hardware.health@2.0) or AIDL c++ / NDK
1192 # libraries (e.g. "android.hardware.power.stats-V1-cpp")
1193 android_lib = lib if '@' in lib or "-cpp" in lib or "-ndk" in lib \
1194 else 'lib' + lib
1195 if lib in shared_library_allowlist:
1196 module.add_android_shared_lib(android_lib)
1197 if lib in static_library_allowlist:
1198 module.add_android_static_lib(android_lib)
1199
Patrick Rohrd9dd3b92022-11-09 16:15:30 -08001200 # Remove prohibited include directories
1201 module.local_include_dirs = [d for d in module.local_include_dirs
1202 if d not in local_include_dirs_denylist]
1203
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001204 # If the module is a static library, export all the generated headers.
1205 if module.type == 'cc_library_static':
1206 module.export_generated_headers = module.generated_headers
1207
Motomu Utsumiee47af62022-11-30 16:41:15 +09001208 if module.name == 'cronet_aml_components_cronet_android_cronet':
1209 if target.output_name is None:
1210 raise Error('Failed to get output_name for libcronet name')
1211 # .so file name needs to match with CronetLibraryLoader.java (e.g. libcronet.109.0.5386.0.so)
1212 # So setting the output name based on the output_name from the desc.json
1213 module.stem = 'lib' + target.output_name
1214
Patrick Rohr92d74122022-10-21 15:50:52 -07001215 # dep_name is an unmangled GN target name (e.g. //foo:bar(toolchain)).
Motomu Utsumif1daa232022-11-08 13:28:37 +09001216 # Currently, only one module is generated from target even target has multiple toolchains.
1217 # And module is generated based on the first visited target.
1218 # Sort deps before iteration to make result deterministic.
1219 all_deps = sorted(target.deps | target.source_set_deps | target.transitive_proto_deps)
Patrick Rohr92d74122022-10-21 15:50:52 -07001220 for dep_name in all_deps:
Patrick Rohr5cc46e02022-10-26 14:32:45 -07001221 # |builtin_deps| override GN deps with Android-specific ones. See the
1222 # config in the top of this file.
Patrick Rohr07876662022-11-15 22:55:23 -08001223 if dep_name in builtin_deps:
1224 builtin_deps[dep_name](module)
Patrick Rohr5cc46e02022-10-26 14:32:45 -07001225 continue
1226
Patrick Rohr92d74122022-10-21 15:50:52 -07001227 dep_module = create_modules_from_target(blueprint, gn, dep_name)
1228
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001229 if dep_module is None:
1230 continue
Motomu Utsumie246feb2022-11-01 17:25:56 +09001231 # TODO: Proper dependency check for genrule.
1232 # Currently, only propagating genrule dependencies.
1233 # Also, currently, all the dependencies are propagated upwards.
1234 # in gn, public_deps should be propagated but deps should not.
1235 # Not sure this information is available in the desc.json.
1236 # Following rule works for adding android_runtime_jni_headers to base:base.
1237 # If this doesn't work for other target, hardcoding for specific target
1238 # might be better.
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001239 if module.is_genrule() and dep_module.is_genrule():
1240 module.genrule_headers.add(dep_module.name)
1241 module.genrule_headers.update(dep_module.genrule_headers)
Motomu Utsumie246feb2022-11-01 17:25:56 +09001242
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001243 # For filegroups, and genrule, recurse but don't apply the
Patrick Rohra6ce0232022-11-16 22:09:01 -08001244 # deps.
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001245 if not module.is_compiled() or module.is_genrule():
Patrick Rohr92d74122022-10-21 15:50:52 -07001246 continue
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001247
Patrick Rohr92d74122022-10-21 15:50:52 -07001248 if dep_module.type == 'cc_library_shared':
1249 module.shared_libs.add(dep_module.name)
1250 elif dep_module.type == 'cc_library_static':
1251 module.static_libs.add(dep_module.name)
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001252 elif dep_module.type == 'cc_object':
Mohannad Farragf2391cc2022-11-29 13:26:32 +00001253 module.merge_attribute('generated_headers', dep_module, target.arch.keys())
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001254 if module.type != 'cc_object':
1255 if dep_module.has_input_files():
1256 # Only add it as part of srcs if the dep_module has input files otherwise
1257 # this would throw an error.
1258 module.srcs.add(":" + dep_module.name)
Mohannad Farragf2391cc2022-11-29 13:26:32 +00001259 module.merge_attribute('export_generated_headers', dep_module,
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001260 target.arch.keys(), 'generated_headers')
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001261 elif dep_module.type == 'cc_genrule':
Mohannad Farragf2391cc2022-11-29 13:26:32 +00001262 module.merge_attribute('generated_headers', dep_module, [], 'genrule_headers')
1263 module.merge_attribute('srcs', dep_module, [], 'genrule_srcs')
1264 module.merge_attribute('shared_libs', dep_module, [], 'genrule_shared_libs')
1265 module.merge_attribute('header_libs', dep_module, [], 'genrule_header_libs')
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001266 if module.type not in ["cc_object"]:
Mohannad Farragf2391cc2022-11-29 13:26:32 +00001267 module.merge_attribute('export_generated_headers', dep_module, [],
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001268 'genrule_headers')
Patrick Rohr92d74122022-10-21 15:50:52 -07001269 elif dep_module.type == 'cc_binary':
1270 continue # Ignore executables deps (used by cmdline integration tests).
1271 else:
1272 raise Error('Unknown dep %s (%s) for target %s' %
1273 (dep_module.name, dep_module.type, module.name))
1274
Patrick Rohrb51878f2022-11-16 23:49:03 -08001275 for arch_name, arch in target.arch.items():
1276 for dep_name in arch.deps:
1277 dep_module = create_modules_from_target(blueprint, gn, dep_name)
1278 # Arch-specific dependencies currently only include cc_library_static.
1279 # Revisit this approach once we need to support more target types.
1280 if dep_module.type == 'cc_library_static':
1281 module.target[arch_name].static_libs.add(dep_module.name)
Mohannad Farrag1de6cb12022-11-28 12:27:26 +00001282 elif dep_module.type == 'cc_genrule':
1283 if dep_module.name.endswith(arch_name):
1284 module.target[arch_name].generated_headers.update(dep_module.genrule_headers)
1285 module.target[arch_name].srcs.update(dep_module.genrule_srcs)
1286 module.target[arch_name].shared_libs.update(dep_module.genrule_shared_libs)
1287 module.target[arch_name].header_libs.update(dep_module.genrule_header_libs)
1288 if module.type not in ["cc_object"]:
1289 module.target[arch_name].export_generated_headers.update(
1290 dep_module.genrule_headers)
Patrick Rohrb51878f2022-11-16 23:49:03 -08001291 else:
1292 raise Error('Unsupported arch-specific dependency %s of target %s with type %s' %
1293 (dep_module.name, target.name, dep_module.type))
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001294 for dep_name in arch.source_set_deps:
1295 dep_module = create_modules_from_target(blueprint, gn, dep_name)
1296 if dep_module.type == 'cc_object':
1297 if module.type != 'cc_object':
1298 # We only want to bubble up cc_objects for modules that are not cc_objects
1299 # otherwise they'd be recompiled and that would cause multiple symbol redefinitions.
1300 if dep_module.has_input_files():
1301 # Only add it as part of srcs if the dep_module has input files otherwise
1302 # this would throw an error.
1303 module.target[arch_name].srcs.add(":" + dep_module.name)
1304 else:
1305 raise Error('Unsupported arch-specific dependency %s of target %s with type %s' %
1306 (dep_module.name, target.name, dep_module.type))
Patrick Rohr92d74122022-10-21 15:50:52 -07001307 return module
1308
Mohannad Farrag3d3d6132022-12-06 18:11:48 +00001309def create_java_jni_preprocessor(blueprint):
1310 bp_module_name = module_prefix + 'java_jni_annotation_preprocessor'
1311 module = Module('java_plugin', bp_module_name, '//base/android/jni_generator:jni_processor')
1312 module.srcs.update(
1313 [
1314 "base/android/jni_generator/java/src/org/chromium/jni_generator/JniProcessor.java",
1315 # Avoids a circular dependency with base:base_java. This is okay because
1316 # no target should ever expect to package an annotation processor.
1317 "build/android/java/src/org/chromium/build/annotations/CheckDiscard.java",
1318 "build/android/java/src/org/chromium/build/annotations/MainDex.java",
Mohannad Farrag89f38e42022-12-06 18:54:46 +00001319 "base/android/java/src/org/chromium/base/JniStaticTestMocker.java",
1320 "base/android/java/src/org/chromium/base/NativeLibraryLoadedStatus.java",
1321 "base/android/java/src/org/chromium/base/annotations/NativeMethods.java",
1322 "base/android/java/src/org/chromium/base/JniException.java",
1323 ":cronet_aml_build_android_build_config_gen",
Mohannad Farrag3d3d6132022-12-06 18:11:48 +00001324 ])
Mohannad Farrag89f38e42022-12-06 18:54:46 +00001325 module.static_libs.update({
1326 "javapoet",
1327 "guava",
1328 "auto_service_annotations",
1329 })
1330 module.processor_class = "org.chromium.jni_generator.JniProcessor"
Mohannad Farrag3d3d6132022-12-06 18:11:48 +00001331 blueprint.add_module(module)
1332 return module
1333
Patrick Rohrb18aca22022-11-04 15:07:32 -07001334def create_java_module(blueprint, gn):
1335 bp_module_name = module_prefix + 'java'
1336 module = Module('java_library', bp_module_name, '//gn:java')
Mohannad Farrag21562d62022-11-07 13:09:31 +00001337 module.srcs.update([gn_utils.label_to_path(source) for source in gn.java_sources])
Mohannad Farrage815d862022-12-06 17:51:43 +00001338 module.libs = {
1339 "androidx.annotation_annotation",
1340 "jsr305",
1341 }
Mohannad Farragb30d3712022-12-06 17:27:04 +00001342 module.aidl["include_dirs"] = {"frameworks/base/core/java/"}
1343 module.aidl["local_include_dirs"] = {"base/android/java/src/"}
Mohannad Farrag6a2d88a2022-11-28 19:33:48 +00001344 for dep in gn.java_actions:
Mohannad Farrag9c2cee12022-12-06 17:11:25 +00001345 target = gn.get_target(dep)
1346 if target.script == '//build/android/gyp/gcc_preprocess.py':
1347 module.srcs.add(':' + create_gcc_preprocess_modules(blueprint, target).name)
1348 else:
1349 module.srcs.add(':' + create_action_module(blueprint, target, 'java_genrule').name)
Mohannad Farrag3d3d6132022-12-06 18:11:48 +00001350 preprocessor_module = create_java_jni_preprocessor(blueprint)
1351 module.plugins.add(preprocessor_module.name)
Patrick Rohrb18aca22022-11-04 15:07:32 -07001352 blueprint.add_module(module)
Patrick Rohr92d74122022-10-21 15:50:52 -07001353
Patrick Rohr6ef22722022-11-18 18:24:01 -08001354def update_jni_registration_module(module, gn):
Motomu Utsumi47d122f2022-11-10 17:32:23 +09001355 # TODO: deny list is in the arg of jni_registration_generator.py. Should not be hardcoded
1356 deny_list = [
1357 '//base/android/java/src/org/chromium/base/library_loader/LibraryLoader.java',
1358 '//base/android/java/src/org/chromium/base/library_loader/LibraryPrefetcher.java',
1359 '//base/android/java/src/org/chromium/base/process_launcher/ChildProcessService.java',
1360 '//base/android/java/src/org/chromium/base/SysUtils.java']
1361
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001362 # TODO: java_sources might not contain all the required java files
Motomu Utsumi47d122f2022-11-10 17:32:23 +09001363 module.srcs.update([gn_utils.label_to_path(source)
Motomu Utsumi6e514122022-12-05 17:51:40 +09001364 for source in gn.java_sources
1365 if source.endswith('.java') and source not in deny_list])
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001366
Motomu Utsumia71281c2022-11-18 15:19:00 +09001367def create_blueprint_for_targets(gn, targets):
Patrick Rohr92d74122022-10-21 15:50:52 -07001368 """Generate a blueprint for a list of GN targets."""
1369 blueprint = Blueprint()
1370
1371 # Default settings used by all modules.
1372 defaults = Module('cc_defaults', defaults_module, '//gn:default_deps')
Patrick Rohr92d74122022-10-21 15:50:52 -07001373 defaults.cflags = [
Patrick Rohr3ce74772022-11-11 14:19:58 -08001374 '-DGOOGLE_PROTOBUF_NO_RTTI',
Patrick Rohr92d74122022-10-21 15:50:52 -07001375 '-Wno-error=return-type',
Patrick Rohr3a1ec1d2022-10-31 13:30:17 -07001376 '-Wno-non-virtual-dtor',
Patrick Rohr5c700022022-11-08 19:33:07 -08001377 '-Wno-macro-redefined',
Patrick Rohr98065152022-10-31 14:49:58 -07001378 '-Wno-missing-field-initializers',
Patrick Rohr92d74122022-10-21 15:50:52 -07001379 '-Wno-sign-compare',
1380 '-Wno-sign-promo',
1381 '-Wno-unused-parameter',
Mohannad Farrag54d52442022-11-21 16:27:02 +00001382 '-Wno-null-pointer-subtraction', # Needed to libevent
Mohannad Farragd98a96d2022-11-10 14:56:19 +00001383 '-Wno-deprecated-non-prototype', # needed for zlib
Patrick Rohr92d74122022-10-21 15:50:52 -07001384 '-fvisibility=hidden',
Motomu Utsumiba020942022-11-14 15:15:41 +09001385 '-Wno-ambiguous-reversed-operator', # needed for icui18n
Motomu Utsumib1ec8782022-11-14 15:25:57 +09001386 '-Wno-unreachable-code-loop-increment', # needed for icui18n
Patrick Rohr92d74122022-10-21 15:50:52 -07001387 '-O2',
Mohannad Farrag7f29d832022-11-23 19:52:41 +00001388 '-fPIC',
Patrick Rohr92d74122022-10-21 15:50:52 -07001389 ]
Patrick Rohrc03f1bb2022-11-18 16:13:17 -08001390 # Chromium builds do not add a dependency for headers found inside the
1391 # sysroot, so they are added globally via defaults.
1392 defaults.target['android'].header_libs = [
1393 'media_ndk_headers',
1394 'jni_headers',
1395 ]
Patrick Rohr5446df82022-11-18 14:54:55 -08001396 defaults.target['host'].cflags = [
1397 # -DANDROID is added by default but target.defines contain -DANDROID if
1398 # it's required. So adding -UANDROID to cancel default -DANDROID if it's
1399 # not specified.
1400 # Note: -DANDROID is not consistently applied across the chromium code
1401 # base, so it is removed unconditionally for host targets.
1402 '-UANDROID',
1403 ]
Patrick Rohr61f2acb2022-10-31 14:08:18 -07001404 defaults.stl = 'none'
Motomu Utsumi8ca12412022-11-30 16:27:30 +09001405 defaults.min_sdk_version = 29
1406 defaults.apex_available.add(tethering_apex)
Patrick Rohr92d74122022-10-21 15:50:52 -07001407 blueprint.add_module(defaults)
Patrick Rohr344b2472022-10-25 11:32:15 -07001408
Patrick Rohr92d74122022-10-21 15:50:52 -07001409 for target in targets:
1410 create_modules_from_target(blueprint, gn, target)
Patrick Rohrb18aca22022-11-04 15:07:32 -07001411
1412 create_java_module(blueprint, gn)
Patrick Rohr6ef22722022-11-18 18:24:01 -08001413 for module in blueprint.modules.values():
1414 if 'cronet_jni_registration' in module.name:
1415 update_jni_registration_module(module, gn)
Patrick Rohra7d029d2022-11-08 12:23:11 -08001416
1417 # Merge in additional hardcoded arguments.
1418 for module in blueprint.modules.values():
1419 for key, add_val in additional_args.get(module.name, []):
1420 curr = getattr(module, key)
1421 if add_val and isinstance(add_val, set) and isinstance(curr, set):
1422 curr.update(add_val)
1423 elif isinstance(add_val, str) and (not curr or isinstance(curr, str)):
1424 setattr(module, key, add_val)
1425 elif isinstance(add_val, bool) and (not curr or isinstance(curr, bool)):
1426 setattr(module, key, add_val)
1427 elif isinstance(add_val, dict) and isinstance(curr, dict):
1428 curr.update(add_val)
1429 elif isinstance(add_val, dict) and isinstance(curr, Target):
1430 curr.__dict__.update(add_val)
1431 else:
1432 raise Error('Unimplemented type %r of additional_args: %r' %
1433 (type(add_val), key))
1434
Patrick Rohr92d74122022-10-21 15:50:52 -07001435 return blueprint
1436
1437
1438def main():
1439 parser = argparse.ArgumentParser(
1440 description='Generate Android.bp from a GN description.')
1441 parser.add_argument(
Patrick Rohr92d74122022-10-21 15:50:52 -07001442 '--desc',
Motomu Utsumi879dec82022-11-18 15:25:12 +09001443 help='GN description (e.g., gn desc out --format=json --all-toolchains "//*".' +
1444 'You can specify multiple --desc options for different target_cpu',
1445 required=True,
1446 action='append'
Patrick Rohr92d74122022-10-21 15:50:52 -07001447 )
1448 parser.add_argument(
1449 '--extras',
1450 help='Extra targets to include at the end of the Blueprint file',
1451 default=os.path.join(gn_utils.repo_root(), 'Android.bp.extras'),
1452 )
1453 parser.add_argument(
1454 '--output',
1455 help='Blueprint file to create',
1456 default=os.path.join(gn_utils.repo_root(), 'Android.bp'),
1457 )
1458 parser.add_argument(
Patrick Rohr16228942022-10-26 14:00:26 -07001459 '-v',
1460 '--verbose',
1461 help='Print debug logs.',
1462 action='store_true',
1463 )
1464 parser.add_argument(
Patrick Rohr92d74122022-10-21 15:50:52 -07001465 'targets',
1466 nargs=argparse.REMAINDER,
Patrick Rohr1aa504a2022-10-25 10:30:42 -07001467 help='Targets to include in the blueprint (e.g., "//:perfetto_tests")'
1468 )
Patrick Rohr92d74122022-10-21 15:50:52 -07001469 args = parser.parse_args()
1470
Patrick Rohr16228942022-10-26 14:00:26 -07001471 if args.verbose:
1472 log.basicConfig(format='%(levelname)s:%(funcName)s:%(message)s', level=log.DEBUG)
1473
Patrick Rohrd0077b72022-11-15 12:43:26 -08001474 targets = args.targets or default_targets
Motomu Utsumi879dec82022-11-18 15:25:12 +09001475 gn = gn_utils.GnParser()
1476 for desc_file in args.desc:
1477 with open(desc_file) as f:
1478 desc = json.load(f)
1479 for target in targets:
1480 gn.parse_gn_desc(desc, target)
Motomu Utsumia71281c2022-11-18 15:19:00 +09001481 blueprint = create_blueprint_for_targets(gn, targets)
Patrick Rohr92d74122022-10-21 15:50:52 -07001482 project_root = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
1483 tool_name = os.path.relpath(os.path.abspath(__file__), project_root)
1484
Patrick Rohr92d74122022-10-21 15:50:52 -07001485 # Add any proto groups to the blueprint.
1486 for l_name, t_names in proto_groups.items():
1487 create_proto_group_modules(blueprint, gn, l_name, t_names)
1488
1489 output = [
Patrick Rohr5478b392022-10-25 09:58:50 -07001490 """// Copyright (C) 2022 The Android Open Source Project
Patrick Rohr92d74122022-10-21 15:50:52 -07001491//
1492// Licensed under the Apache License, Version 2.0 (the "License");
1493// you may not use this file except in compliance with the License.
1494// You may obtain a copy of the License at
1495//
1496// http://www.apache.org/licenses/LICENSE-2.0
1497//
1498// Unless required by applicable law or agreed to in writing, software
1499// distributed under the License is distributed on an "AS IS" BASIS,
1500// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1501// See the License for the specific language governing permissions and
1502// limitations under the License.
1503//
1504// This file is automatically generated by %s. Do not edit.
1505""" % (tool_name)
1506 ]
1507 blueprint.to_string(output)
Patrick Rohrcb98e9b2022-10-25 09:57:02 -07001508 if os.path.exists(args.extras):
1509 with open(args.extras, 'r') as r:
1510 for line in r:
1511 output.append(line.rstrip("\n\r"))
Patrick Rohr92d74122022-10-21 15:50:52 -07001512
1513 out_files = []
1514
1515 # Generate the Android.bp file.
1516 out_files.append(args.output + '.swp')
1517 with open(out_files[-1], 'w') as f:
1518 f.write('\n'.join(output))
1519 # Text files should have a trailing EOL.
1520 f.write('\n')
1521
Patrick Rohr94693eb2022-10-25 10:09:16 -07001522 return 0
Patrick Rohr92d74122022-10-21 15:50:52 -07001523
1524
1525if __name__ == '__main__':
1526 sys.exit(main())