sergio/takana

1# Firefox 154.0 — el navegador. Tercera app de usuario final, y **la cabeza de la familia Gecko**:
2# Waterfox y Zen son forks suyos y reutilizan todo lo de abajo.
3#
4# ══ POR QUÉ 154 Y NO 155, QUE ES LA QUE SIGUE ZEN ══════════════════════════════════════════════
5# Zen declara `"version": "155.0.1"` en su `surfer.json` y Waterfox 6.7 también va por el canal
6# release, así que 155 parecía la base obvia. Se eligió **154** por una razón concreta: **los parches
7# de musl de Alpine son para 154.0**, y son once. Ese es el trabajo de portabilidad que un import de
8# nix pierde y que no conviene rehacer a mano — sin ellos Firefox no compila contra musl.
9#
10# Un Firefox que compila con el set probado vale más que uno con el número correcto que no compila.
11# Y como Firefox se mueve cada cuatro semanas, la paridad exacta con Zen es una cinta de correr: lo
12# que de verdad se reutiliza entre los tres es LA PLATAFORMA (gtk3/nodejs/clang/cbindgen, todo ya en
13# el corpus) y ESTE SET DE PARCHES. Subir a 155 después es un rebase, no un port.
14#
15# ══ TODO BUNDLEADO SALVO GTK3 ══════════════════════════════════════════════════════════════════
16# Alpine usa `--with-system-{icu,nspr,nss,av1,libvpx,webp,libevent,...}`; de ésas el corpus tiene
17# CERO. Firefox trae todas en el árbol, así que se dejan bundleadas: son menos piezas móviles para el
18# primer build, que es exactamente cuando conviene minimizar variables. Cuando alguna de esas
19# librerías tenga receta propia y valga compartirla, el flag se enciende y se re-mide.
20#
21# ══ SIN BRANDING OFICIAL, Y NO ES UN DESCUIDO ══════════════════════════════════════════════════
22# Alpine pone `--enable-official-branding`. Acá NO: el binario lleva once parches, y usar el nombre y
23# el logo de Firefox sobre un build modificado entra en la política de marcas de Mozilla — es
24# literalmente la historia de Iceweasel en Debian. Con el branding `unofficial` el navegador es el
25# mismo software y nadie tiene que pedir permiso a nadie. Es la misma cautela que la receta de
26# `dejavu-fonts-nerd` ya aplicó con la licencia de Bitstream Vera: **una fuente modificada no puede
27# llamarse como la original, y un navegador parcheado tampoco.**
28#
29# ══ WAYLAND-ONLY, HEREDADO DE GTK3 ═════════════════════════════════════════════════════════════
30# `--enable-default-toolkit=cairo-gtk3-wayland`. Nuestro GTK3 se construyó con `-Dx11_backend=false`
31# ⇒ este Firefox **no puede correr como cliente X11 ni bajo Xwayland**. Bajo Wayland nativo sí. Está
32# escrito en `recipes/gtk3.toml` y se repite acá porque es lo primero que alguien va a preguntar.
33#
34# ══ HERMÉTICO: NADA DE RED DURANTE EL BUILD ════════════════════════════════════════════════════
35#   --disable-bootstrap                      su trabajo ES descargar toolchains. Prohibido.
36#   MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE  sin esto `mach` arma un virtualenv con `pip` y sale a
37#     =system                                la red. Con `system` usa lo que ya está.
38#   MOZBUILD_STATE_PATH                      por defecto escribe en `$HOME`, que en el sandbox no es
39#                                            suyo; se apunta al árbol de build.
40#   Los crates de Rust vienen VENDORIZADOS en el tarball (`third_party/rust`) ⇒ cargo no baja nada.
41#
42# ══ LO DEMÁS QUE SE APAGA ══════════════════════════════════════════════════════════════════════
43#   --disable-jemalloc            musl trae su propio allocator; jemalloc encima es la receta del
44#                                 cuelgue clásico de Firefox en Alpine.
45#   --without-wasm-sandboxed-      exige el SDK de WASI, que no está en ninguna cola. Apaga el
46#     libraries                    sandbox wasm de algunas librerías de medios, no el sandbox del
47#                                 proceso de contenido.
48#   --disable-crashreporter       manda telemetría a Mozilla; además pide breakpad.
49#   --disable-updater             la distro actualiza por hammer, no por un updater propio.
50#   --disable-tests               no entran al artefacto.
51#   (SIN --enable-linker)         Se deja que Firefox detecte solo. Con `zig-cc` esto era
52#                                 OBLIGATORIO —zig se anuncia como `zig ld 0.16.0` y el sondeo de
53#                                 `toolchain.configure` clasifica por esa cadena buscando
54#                                 «mold»/«GNU ld»/«GNU gold»/«LLD»— y **pedir el linker por nombre
55#                                 vuelve FATAL cualquier fallo del sondeo**. Con gcc el linker sí se
56#                                 anuncia como «GNU ld», así que el flag ya no haría daño; se deja
57#                                 fuera igual porque no aporta nada y una perilla menos es una
58#                                 diferencia menos entre esta receta y las de Waterfox y Zen.
59name    = "firefox"
60version = "154.0"
61license = "MPL-2.0"
62
63[source]
64# Tarball de RELEASE de Mozilla: fichero SUBIDO por upstream, sha256 estable y publicado en su
65# SHA256SUMS. No es un `/archive/<tag>` de forja, que se genera al vuelo (ver `recipes/mbedtls.toml`).
66tarball = "https://ftp.mozilla.org/pub/firefox/releases/154.0/source/firefox-154.0.source.tar.xz"
67sha256  = "36cec5b3688a60f78a6d20dcaee15b598f84e03c66f6587056aead6cb498b99a"
68# Los once de musl del APKBUILD de Alpine (community/firefox). NO se traen los suyos de ppc64le,
69# loongarch ni Android: no aplican a x86_64 y cada parche que no hace falta es una forma más de que
70# un rebase falle sin motivo.
71patches = [
72  "firefox-patches/lfs64.patch",
73  "firefox-patches/time64.patch",
74  "firefox-patches/musl-no-linux-prctl.patch",
75  "firefox-patches/fix-fortify-system-wrappers.patch",
76  "firefox-patches/fix-rust-target.patch",
77  "firefox-patches/sandbox-sched_setscheduler.patch",
78  "firefox-patches/abseil-cpp.patch",
79  "firefox-patches/glean-stub.patch",
80  "firefox-patches/rust-lto-thin.patch",
81  "firefox-patches/wasip1.patch",
82  "firefox-patches/widevine.patch",
83]
84
85[build]
86# ══ `gcc` Y NO `zig-cc` — TRES MUROS DE UNA VEZ ════════════════════════════════════════════════
87# El resto del corpus va con zig-cc y esta receta es una EXCEPCIÓN consciente, del mismo tipo que la
88# que el repo ya mantiene para el kernel y cmake (ADR 0011). Se llegó acá por eliminación, no por
89# comodidad — con zig-cc el configure de Firefox murió tres veces seguidas:
90#
91#   1. «Could not use lld as linker» — zig se identifica como `zig ld 0.16.0` y el sondeo de Mozilla
92#      clasifica por esa cadena buscando «LLD»/«GNU ld»/«GNU gold».
93#   2. «Cannot find ar» — zig trae `ar` como SUBCOMANDO y `check_prog` busca un ejecutable.
94#   3. **«Firefox does not support linking statically with libstdc++»** — y éste no es un flag:
95#      `flags.configure:79` compila un C++ mínimo, lo pasa por `llvm-objdump --private-headers` y
96#      exige encontrar un `NEEDED …libc++`. zig enlaza libc++ ESTÁTICA para musl, así que ese NEEDED
97#      no existe nunca. No hay perilla que apagar; es una negativa de upstream.
98#
99# El gcc del lab (15.2.0, con `libstdc++` COMPARTIDA) satisface los tres: `NEEDED libstdc++.so.6`,
100# un `ar` de verdad y un linker que se anuncia como «GNU ld».
101#
102# ⚠ EL PRECIO, ESCRITO: **el lab NO entra en `hash_inputs`**, así que un Firefox construido con el
103# gcc del lab queda más expuesto a la deriva del rootfs que uno con zig-cc — dos labs con gcc
104# distinto pueden sellar bytes distintos sin que el store lo note. Es la misma deuda que ya cargan el
105# kernel y las otras recetas `compiler=gcc`, y la razón por la que conviene no ampliar esta lista sin
106# haber agotado antes el camino de zig.
107compiler = "gcc"
108target   = "x86_64-linux-musl"
109link     = "dynamic"
110flags    = []
111# ══ `strip_debug`: SIN ESTO EL ARTEFACTO SERÍA INMANEJABLE ═════════════════════════════════════
112# Medido en el `nodejs` que acaba de sellar sin strip: su binario pesa **984 MB, de los cuales
113# `.debug_info` son 497 MB y `.debug_line` otros 43** — más de la mitad del artefacto es información
114# de depuración. Firefox es varias veces V8, así que sin strip su artefacto entraría en varios GB, y
115# el store no es sólo disco: se sincroniza hub↔worker y se respalda.
116#
117# Es además el hallazgo del SDD 23: el 79% del contenido binario del store era `.debug_*`, y quitarlo
118# hace que artefactos que no reproducían PASEN a reproducir, porque lo que difería eran las rutas del
119# árbol de build embebidas en esas secciones.
120#
121# Entra en `hash_inputs` A PROPÓSITO (cambia el contenido del artefacto), y usa `zig objcopy`, que
122# siempre está en el sandbox ⇒ no agrega una dep de build.
123strip_debug = true
124
125[build.phases]
126configure = '''
127export MOZBUILD_STATE_PATH="$PWD/.mozbuild"
128export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system
129export MOZ_NOSPAM=1
130# ── RUST_TARGET: lo EXIGE el parche de Alpine, no Firefox ─────────────────────────────────────
131# `fix-rust-target.patch` REEMPLAZA la autodetección del triple de Rust por un
132# `os.environ['RUST_TARGET']` pelado. Sin la variable, configure muere con
133# `KeyError: 'RUST_TARGET'` — que se lee como un bug de Firefox y es en realidad el contrato del
134# parche: el APKBUILD de Alpine lo exporta como `$CTARGET` y acá hay que hacer lo propio.
135# El valor NO se adivina: sale de `ls .dev-fs/alpine/usr/lib/rustlib/` en el lab, que es
136# `x86_64-alpine-linux-musl` — el rustc del sandbox es el de Alpine, no el del host (el del host es
137# `x86_64-unknown-linux-gnu` y usarlo produciría un cross-compile silencioso).
138export RUST_TARGET=x86_64-alpine-linux-musl
139cat > .mozconfig <<'MOZ'
140ac_add_options --prefix=/usr
141ac_add_options --enable-application=browser
142ac_add_options --enable-default-toolkit=cairo-gtk3-wayland
143ac_add_options --enable-release
144ac_add_options --enable-optimize
145ac_add_options --enable-hardening
146ac_add_options --with-branding=browser/branding/unofficial
147ac_add_options --with-libclang-path=/usr/lib
148ac_add_options --disable-bootstrap
149ac_add_options --disable-jemalloc
150ac_add_options --disable-crashreporter
151ac_add_options --disable-updater
152ac_add_options --disable-tests
153ac_add_options --disable-debug
154ac_add_options --disable-debug-symbols
155ac_add_options --disable-strip
156ac_add_options --disable-install-strip
157ac_add_options --disable-cargo-incremental
158ac_add_options --without-wasm-sandboxed-libraries
159ac_add_options --enable-alsa
160ac_add_options --enable-pulseaudio
161ac_add_options --enable-dbus
162ac_add_options --enable-ffmpeg
163mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir
164MOZ
165./mach configure
166'''
167# `mach build` respeta -jN; la cuenta es la misma que en nodejs.toml y por el mismo motivo: un número
168# fijo ataría el ArtifactHash a la RAM de quien escribió la receta.
169# ⚠ OJO con el techo: dentro del sandbox `/proc/meminfo` NO muestra la memoria del contenedor sino la
170# del host (medido en el LXC: 186 GiB en vez de 16), así que en un contenedor esta cuenta se degrada
171# a `nproc`. Es un tope, no una garantía.
172compile = '''
173export RUST_TARGET=x86_64-alpine-linux-musl   # ver la nota en la fase configure
174export MOZBUILD_STATE_PATH="$PWD/.mozbuild"
175export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system
176export MOZ_NOSPAM=1
177gib=$(awk "/MemTotal/{printf \"%d\", \$2/1024/1024}" /proc/meminfo)
178j=$(( gib / 3 )); [ "$j" -lt 1 ] && j=1
179n=$(nproc); [ "$j" -gt "$n" ] && j=$n
180echo "mach build -j$j (MemTotal ${gib} GiB, nproc $n)"
181./mach build -j"$j"
182'''
183install = '''
184export RUST_TARGET=x86_64-alpine-linux-musl   # ver la nota en la fase configure
185export MOZBUILD_STATE_PATH="$PWD/.mozbuild"
186export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system
187DESTDIR=/out ./mach install
188'''
189
190[deps]
191build = [
192  "python3", "pkgconf", "nasm", "make", "cmake",
193  # la plataforma Gecko, compartida con Waterfox y Zen
194  "nodejs", "cbindgen", "clang18", "llvm18",
195  "gtk3", "atk", "gdk-pixbuf", "pango", "cairo", "libepoxy",
196  "glib-shared", "pcre2-shared", "libffi-shared", "zlib-shared",
197  "harfbuzz", "fribidi", "freetype-shared", "fontconfig-shared", "pixman",
198  "libpng-shared", "libjpeg-turbo-shared",
199  "wayland", "wayland-protocols", "libxkbcommon", "mesa", "libdrm",
200  "dbus", "pipewire", "pulseaudio", "alsa-lib",
201  "libxml2-shared", "linux-headers",
202]