Clean up path usage in build files

[woody-apple]

Problem

Templates should rebase paths to the build dir before passing them to
scripts as scripts generally do not understand GN's // syntax for
specifying paths relative to the root.

In other cases, paths should be left alone so that build file relative
paths can be specified. This is needed for consistency; all GN builtins
accept both relative-to-BUILD.gn paths (default) and
relative-to-GN-root (//) paths.

For command line arguments, paths should be specified relative to
the build directory, which will be the working directory of the script.

Change overview

• Allow & use relative paths in template arguments

• Remove most uses of rebase_path() to create filesystem-absolute paths.

  This is rarely needed and can introduce long absolute paths that are different for each developer.

  These are replaced with:

  • BUILD.gn relative paths

  • GN-rooted (//) paths

    get_path_info(path, "abspath") converts a BUILD.gn relative path to a GN-rooted path
    get_label_info(label, "label_no_toolchain") converts a BUILD.gn relative label to a GN-rooted label

Testing

CI

[github-actions]

PR #20735: Size comparison from 89d2a6a to 7ca69a6

Increases (3 builds for bl602, telink)

platform	target	config	section	89d2a6a	7ca69a6	change	% change
bl602	lighting-app	bl602+rpc	(read/write)	1442890	1442898	8	0.0
			.text	1090224	1090228	4	0.0
telink	light-switch-app	tlsr9518adk80d	text	565594	565596	2	0.0
	lighting-app	tlsr9518adk80d	text	581918	581920	2	0.0

Decreases (1 build for cyw30739)

platform	target	config	section	89d2a6a	7ca69a6	change	% change
cyw30739	ota-requestor-no-progress-logging	cyw930739m2evb_01	(read/write)	582778	582770	-8	-0.0
			.app_xip_area	462396	462388	-8	-0.0

Full report (43 builds for bl602, cc13x2_26x2, cyw30739, efr32, esp32, k32w, linux, mbed, nrfconnect, p6, telink)

platform	target	config	section	89d2a6a	7ca69a6	change	% change
bl602	lighting-app	bl602	(read/write)	1397466	1397466	0	0.0
			.bss	116978	116978	0	0.0
			.data	4480	4480	0	0.0
			.text	1058540	1058540	0	0.0
		bl602+rpc	(read/write)	1442890	1442898	8	0.0
			.bss	124418	124418	0	0.0
			.data	4600	4600	0	0.0
			.text	1090224	1090228	4	0.0
cc13x2_26x2	all-clusters-app	LP_CC2652R7	(read only)	666043	666043	0	0.0
			(read/write)	185180	185180	0	0.0
			.bss	74116	74116	0	0.0
			.data	3356	3356	0	0.0
			.rodata	88067	88067	0	0.0
			.text	577660	577660	0	0.0
	all-clusters-minimal-app	LP_CC2652R7	(read only)	631851	631851	0	0.0
			(read/write)	157684	157684	0	0.0
			.bss	73412	73412	0	0.0
			.data	3356	3356	0	0.0
			.rodata	77307	77307	0	0.0
			.text	554220	554220	0	0.0
	lock-ftd	LP_CC2652R7	(read only)	668959	668959	0	0.0
			(read/write)	172408	172408	0	0.0
			.bss	71148	71148	0	0.0
			.data	3280	3280	0	0.0
			.rodata	76207	76207	0	0.0
			.text	592272	592272	0	0.0
	lock-mtd	LP_CC2652R7	(read only)	618367	618367	0	0.0
			(read/write)	144264	144264	0	0.0
			.bss	66868	66868	0	0.0
			.data	3280	3280	0	0.0
			.rodata	76087	76087	0	0.0
			.text	541792	541792	0	0.0
	pump-app	LP_CC2652R7	(read only)	678199	678199	0	0.0
			(read/write)	164016	164016	0	0.0
			.bss	71228	71228	0	0.0
			.data	3280	3280	0	0.0
			.rodata	88631	88631	0	0.0
			.text	589084	589084	0	0.0
	pump-controller-app	LP_CC2652R7	(read only)	664023	664023	0	0.0
			(read/write)	178312	178312	0	0.0
			.bss	71348	71348	0	0.0
			.data	3276	3276	0	0.0
			.rodata	84495	84495	0	0.0
			.text	579048	579048	0	0.0
	shell	LP_CC2652R7	(read only)	658542	658542	0	0.0
			(read/write)	188184	188184	0	0.0
			.bss	76420	76420	0	0.0
			.data	3360	3360	0	0.0
			.rodata	84846	84846	0	0.0
			.text	573380	573380	0	0.0
cyw30739	light	cyw930739m2evb_01	(read/write)	579494	579494	0	0.0
			.app_xip_area	458264	458264	0	0.0
			.bss	64184	64184	0	0.0
			.data	716	716	0	0.0
			.rodata	0	0	0	0.0
			.text	112	112	0	0.0
	lock	cyw930739m2evb_01	(read/write)	585446	585446	0	0.0
			.app_xip_area	459480	459480	0	0.0
			.bss	68912	68912	0	0.0
			.data	720	720	0	0.0
			.rodata	0	0	0	0.0
			.text	112	112	0	0.0
	ota-requestor-no-progress-logging	cyw930739m2evb_01	(read/write)	582778	582770	-8	-0.0
			.app_xip_area	462396	462388	-8	-0.0
			.bss	63392	63392	0	0.0
			.data	660	660	0	0.0
			.rodata	0	0	0	0.0
			.text	112	112	0	0.0
efr32	lighting-app	BRD4161A	(read/write)	1081412	1081412	0	0.0
			.bss	132996	132996	0	0.0
			.data	2048	2048	0	0.0
			.text	946348	946348	0	0.0
		BRD4161A+rpc	(read/write)	1135732	1135732	0	0.0
			.bss	149676	149676	0	0.0
			.data	2260	2260	0	0.0
			.text	983776	983776	0	0.0
		BRD4161A+rs911x	(read/write)	947924	947924	0	0.0
			.bss	140768	140768	0	0.0
			.data	2048	2048	0	0.0
			.text	805088	805088	0	0.0
	lock-app	BRD4161A+wf200	(read/write)	1128760	1128760	0	0.0
			.bss	144184	144184	0	0.0
			.data	2060	2060	0	0.0
			.text	982492	982492	0	0.0
	window-app	BRD4161A	(read/write)	1075228	1075228	0	0.0
			.bss	134468	134468	0	0.0
			.data	2076	2076	0	0.0
			.text	938660	938660	0	0.0
esp32	all-clusters-app	c3devkit	(read only)	1019980	1019980	0	0.0
			(read/write)	1485690	1485690	0	0.0
			.dram0.bss	70080	70080	0	0.0
			.dram0.data	14600	14600	0	0.0
			.flash.rodata	215576	215576	0	0.0
			.flash.text	1019980	1019980	0	0.0
			.iram0.text	62902	62902	0	0.0
		m5stack	(read only)	1073927	1073927	0	0.0
			(read/write)	487760	487760	0	0.0
			.dram0.bss	75600	75600	0	0.0
			.dram0.data	34144	34144	0	0.0
			.flash.rodata	246020	246020	0	0.0
			.flash.text	1068543	1068543	0	0.0
			.iram0.text	123267	123267	0	0.0
k32w	light	k32w061+release	(read/write)	658544	658544	0	0.0
			.bss	69516	69516	0	0.0
			.data	1992	1992	0	0.0
			.text	581236	581236	0	0.0
	lock	k32w061+release	(read/write)	685348	685348	0	0.0
			.bss	69980	69980	0	0.0
			.data	2004	2004	0	0.0
			.text	607564	607564	0	0.0
linux	all-clusters-app	debug	(read only)	2960649	2960649	0	0.0
			(read/write)	154752	154752	0	0.0
			.bss	61536	61536	0	0.0
			.data	2048	2048	0	0.0
			.data.rel.ro	84968	84968	0	0.0
			.dynamic	608	608	0	0.0
			.got	4536	4536	0	0.0
			.init	27	27	0	0.0
			.init_array	1048	1048	0	0.0
			.rodata	263773	263773	0	0.0
			.text	2519666	2519666	0	0.0
	all-clusters-minimal-app	debug	(read only)	2813193	2813193	0	0.0
			(read/write)	146688	146688	0	0.0
			.bss	60864	60864	0	0.0
			.data	2048	2048	0	0.0
			.data.rel.ro	77608	77608	0	0.0
			.dynamic	608	608	0	0.0
			.got	4488	4488	0	0.0
			.init	27	27	0	0.0
			.init_array	1048	1048	0	0.0
			.rodata	265469	265469	0	0.0
			.text	2372690	2372690	0	0.0
	bridge-app	debug+rpc	(read only)	2315241	2315241	0	0.0
			(read/write)	125504	125504	0	0.0
			.bss	48928	48928	0	0.0
			.data	3824	3824	0	0.0
			.data.rel.ro	66984	66984	0	0.0
			.dynamic	608	608	0	0.0
			.got	4392	4392	0	0.0
			.init	27	27	0	0.0
			.init_array	728	728	0	0.0
			.rodata	198144	198144	0	0.0
			.text	1955362	1955362	0	0.0
	chip-tool	debug	(read only)	10317985	10317985	0	0.0
			(read/write)	621728	621728	0	0.0
			.bss	24728	24728	0	0.0
			.data	3234	3234	0	0.0
			.data.rel.ro	587360	587360	0	0.0
			.dynamic	608	608	0	0.0
			.got	5096	5096	0	0.0
			.init	27	27	0	0.0
			.init_array	640	640	0	0.0
			.rodata	515029	515029	0	0.0
			.text	8372564	8372564	0	0.0
	chip-tool-ipv6only	arm64	(read only)	10041692	10041692	0	0.0
			(read/write)	686913	686913	0	0.0
			.bss	42961	42961	0	0.0
			.data	3304	3304	0	0.0
			.data.rel.ro	622984	622984	0	0.0
			.dynamic	528	528	0	0.0
			.got	13736	13736	0	0.0
			.init	24	24	0	0.0
			.init_array	192	192	0	0.0
			.rodata	477772	477772	0	0.0
			.text	8001332	8001332	0	0.0
	lighting-app	debug+rpc	(read only)	2550969	2550969	0	0.0
			(read/write)	129528	129528	0	0.0
			.bss	49440	49440	0	0.0
			.data	2096	2096	0	0.0
			.data.rel.ro	72136	72136	0	0.0
			.dynamic	608	608	0	0.0
			.got	4392	4392	0	0.0
			.init	27	27	0	0.0
			.init_array	816	816	0	0.0
			.rodata	213832	213832	0	0.0
			.text	2167170	2167170	0	0.0
	lock-app	debug	(read only)	2515705	2515705	0	0.0
			(read/write)	124512	124512	0	0.0
			.bss	47840	47840	0	0.0
			.data	1712	1712	0	0.0
			.data.rel.ro	69096	69096	0	0.0
			.dynamic	608	608	0	0.0
			.got	4424	4424	0	0.0
			.init	27	27	0	0.0
			.init_array	792	792	0	0.0
			.rodata	228872	228872	0	0.0
			.text	2121666	2121666	0	0.0
	ota-provider-app	debug	(read only)	2322049	2322049	0	0.0
			(read/write)	118312	118312	0	0.0
			.bss	47488	47488	0	0.0
			.data	1944	1944	0	0.0
			.data.rel.ro	63096	63096	0	0.0
			.dynamic	608	608	0	0.0
			.got	4488	4488	0	0.0
			.init	27	27	0	0.0
			.init_array	672	672	0	0.0
			.rodata	203608	203608	0	0.0
			.text	1955666	1955666	0	0.0
	ota-requestor-app	debug	(read only)	2439153	2439153	0	0.0
			(read/write)	125216	125216	0	0.0
			.bss	49856	49856	0	0.0
			.data	2232	2232	0	0.0
			.data.rel.ro	67288	67288	0	0.0
			.dynamic	608	608	0	0.0
			.got	4480	4480	0	0.0
			.init	27	27	0	0.0
			.init_array	728	728	0	0.0
			.rodata	207424	207424	0	0.0
			.text	2060578	2060578	0	0.0
	shell	debug	(read only)	2550977	2550977	0	0.0
			(read/write)	141104	141104	0	0.0
			.bss	57448	57448	0	0.0
			.data	1264	1264	0	0.0
			.data.rel.ro	76688	76688	0	0.0
			.dynamic	608	608	0	0.0
			.got	4136	4136	0	0.0
			.init	27	27	0	0.0
			.init_array	928	928	0	0.0
			.rodata	227890	227890	0	0.0
			.text	2165986	2165986	0	0.0
	thermostat-no-ble	arm64	(read only)	2595044	2595044	0	0.0
			(read/write)	158289	158289	0	0.0
			.bss	65249	65249	0	0.0
			.data	1704	1704	0	0.0
			.data.rel.ro	83240	83240	0	0.0
			.dynamic	528	528	0	0.0
			.got	5072	5072	0	0.0
			.init	24	24	0	0.0
			.init_array	400	400	0	0.0
			.rodata	165604	165604	0	0.0
			.text	2189664	2189664	0	0.0
	tv-app	debug	(read only)	3101969	3101969	0	0.0
			(read/write)	257704	257704	0	0.0
			.bss	167016	167016	0	0.0
			.data	4848	4848	0	0.0
			.data.rel.ro	79392	79392	0	0.0
			.dynamic	608	608	0	0.0
			.got	4848	4848	0	0.0
			.init	27	27	0	0.0
			.init_array	952	952	0	0.0
			.rodata	249152	249152	0	0.0
			.text	2664914	2664914	0	0.0
	tv-casting-app	debug	(read only)	5562921	5562921	0	0.0
			(read/write)	161456	161456	0	0.0
			.bss	50248	50248	0	0.0
			.data	2416	2416	0	0.0
			.data.rel.ro	102536	102536	0	0.0
			.dynamic	608	608	0	0.0
			.got	4744	4744	0	0.0
			.init	27	27	0	0.0
			.init_array	864	864	0	0.0
			.rodata	342729	342729	0	0.0
			.text	4943538	4943538	0	0.0
mbed	lock-app	CY8CPROTO_062_4343W+release	(read only)	6224	6224	0	0.0
			(read/write)	2448168	2448168	0	0.0
			.bss	213940	213940	0	0.0
			.data	5872	5872	0	0.0
			.text	1410812	1410812	0	0.0
nrfconnect	all-clusters-app	nrf52840dk_nrf52840	(read/write)	1175183	1175183	0	0.0
			bss	142900	142900	0	0.0
			rodata	142008	142008	0	0.0
			text	811392	811392	0	0.0
	all-clusters-minimal-app	nrf52840dk_nrf52840	(read/write)	1155391	1155391	0	0.0
			bss	142136	142136	0	0.0
			rodata	133536	133536	0	0.0
			text	800836	800836	0	0.0
p6	all-clusters-app	default	(read/write)	2566152	2566152	0	0.0
			.bss	149120	149120	0	0.0
			.data	2776	2776	0	0.0
			.text	1524416	1524416	0	0.0
	all-clusters-minimal-app	default	(read/write)	2511440	2511440	0	0.0
			.bss	148400	148400	0	0.0
			.data	2776	2776	0	0.0
			.text	1469704	1469704	0	0.0
	light-app	default	(read/write)	2441376	2441376	0	0.0
			.bss	140456	140456	0	0.0
			.data	2592	2592	0	0.0
			.text	1399640	1399640	0	0.0
	lock-app	default	(read/write)	2468520	2468520	0	0.0
			.bss	140304	140304	0	0.0
			.data	2600	2600	0	0.0
			.text	1426784	1426784	0	0.0
telink	light-switch-app	tlsr9518adk80d	(read/write)	797332	797332	0	0.0
			bss	70576	70576	0	0.0
			noinit	40416	40416	0	0.0
			text	565594	565596	2	0.0
	lighting-app	tlsr9518adk80d	(read/write)	817156	817156	0	0.0
			bss	71420	71420	0	0.0
			noinit	40416	40416	0	0.0
			text	581918	581920	2	0.0