| type | Reference | ||||
|---|---|---|---|---|---|
| title | iOS RNCore podspec invariants | ||||
| description | Clang non-modular-includes flag and pod_target_xcconfig order for RNFB CocoaPods specs under use_frameworks!. | ||||
| tags |
|
||||
| timestamp | 2026-09-03 00:00:00 UTC |
Canonical owner for RNFB handwritten RNFB*.podspec xcconfig around React
Native's prebuilt RNCore and use_frameworks!. Not consumer setup.
This file is Issue 1 (compile-time, inside RNFB pods), GitHub #9200.
Issue 2 (link-time, tests/ only: third-party dynamic pods vs prebuilt
RNCore) is owned by
test app dependency pins.
Vanilla RN CLI consumer compile (GitHub #8883) is owned by test-rn-bare/
plus yarn test-rn-bare:ios:build
(agent command policy).
Expo documented-path link is yarn test-expo:ios:link
(agent command policy). Do not collapse those graphs.
Firebase SPM imports and embed: iOS SPM native integration decisions.
Policy: OKF documentation and commit policy.
- Set
CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES=YESonpod_target_xcconfigso RNFB umbrellas that re-export<React/...>validate as framework modules underuse_frameworks!. - Assign that hash (plus any pod-local
HEADER_SEARCH_PATHS) beforeinstall_modules_dependencies. Reassigning afterwards overwrites helper-injectedHEADER_SEARCH_PATHSandCLANG_CXX_LANGUAGE_STANDARD=c++20, which breaks from-source RNCore (react/timing/primitives.h→react/debug/flags.h). - Live New Architecture pods call
install_modules_dependencies, which already callsadd_rncore_dependency(RN 0.84+new_architecture.rb). Do not calladd_rncore_dependencyagain on those specs. - Specs that do not call
install_modules_dependencies(the package template) must calladd_rncore_dependency(s)themselves, guarded bydefined?.
RN's NewArchitectureHelper.install_modules_dependencies writes
pod_target_xcconfig then calls add_rncore_dependency(spec) so the
helper's xcconfig assignment cannot wipe RNCore search paths. A second
call from the podspec duplicates VFS overlay flags. The RNFB-specific
work is the Clang flag and the order of our hash assignment.
When RNFB podspecs change:
pod_target_xcconfigis assigned beforeinstall_modules_dependencies; no second hash afterwards;CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES=YESis present;- live pods do not call
add_rncore_dependencyafterinstall_modules_dependencies; scripts/_TEMPLATE_/RNFB_Template_.podspecstill callsadd_rncore_dependencywhile it lacksinstall_modules_dependencies.
Do not treat this file as consumer setup.
$RNFirebaseDisableSPM / Expo disableSPM / static Firebase linkage are
removed (fail loud with Firebase Apple SDK 13+) — see
docs/ios-spm.mdx and
docs/migrating-to-v27.mdx.