Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts - #48257

Closed
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode
Closed

Add CCACHE_BINARY path to Xcode build settings and use it in ccache scripts#48257
ste7en wants to merge 2 commits into
react:mainfrom
ste7en:fix-46126-ccache-path-in-xcode

Conversation

@ste7en

Copy link
Copy Markdown
Contributor

Summary:

When building a react native app from Xcode and ccache has been set to be used, the ccache-clang.sh and ccache-clang++.sh scripts cannot find ccache, because Xcode PATH does not include ccache binary.
What I've done is setting a CCACHE_BINARY user-defined Xcode setting containing the result of executing command -v ccache during pod install execution and directly calling it in ccache scripts, set by ReactNativePodsUtils when ccache is enabled.

Fixes#46126

Changelog:

[IOS] [FIXED] - fix ccache not found error exporting ccache binary path as Xcode user-defined setting to be used by ccache scripts

Test Plan:

Correctly builds helloworld and RNTester apps using ccache by enabling it at pod install time: USE_CCACHE=1 pod install.

The `$CCACHE_BINARY` env is set at `pod install` time when the USE_CCACHE flag is 1. This fixes ccache not found react#46126 as the ccache path is directly used.
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Hi @ste7en!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@ste7enste7en mentioned this pull request Dec 13, 2024
@cipolleschi

Copy link
Copy Markdown
Contributor

@ste7en thanks for the fix! Could you sign the CLA, please? Otherwise I'm not allowed to import the PR in our repo!

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Sure @cipolleschi, didn't know about the CLA. Just signed it, thanks!

@facebook-github-botfacebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@facebook-github-botfacebook-github-bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

@facebook-github-botfacebook-github-bot added the Merged This PR has been merged. label Dec 16, 2024
@facebook-github-bot

Copy link
Copy Markdown
Contributor

@cipolleschi merged this pull request in d31ac83.

@react-native-bot

Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @ste7en in d31ac83

When will my fix make it into a release? | How to file a pick request?

@mefjuu

mefjuu commented Jan 27, 2025

Copy link
Copy Markdown

@ste7en Thanks for the fix. Works great. But I wonder is it okay to store local setup ccache path into project.pbxproj? Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

@ste7en

Copy link
Copy Markdown
ContributorAuthor

Maybe it's worth to consider moving this variable to .xcode.env generating script (with-environment.sh)

Yes @mefjuu, I agree it would be a much cleaner solution

janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, and ccache reported 0
cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH, so looking ccache up there finds
nothing. The intent was right, the delivery mechanism just is not available to a
compiler launcher: Xcode passes it neither build settings nor arguments (a CC
value containing arguments fails with 'unable to spawn process').
So pod install now generates the launchers into Pods/ with the resolved path
baked in, and points CC/CXX at those. Pods/ is regenerated by every pod install
and is gitignored in the app templates, so the path can never go stale and
nothing tracked gains a machine-specific value. The shipped scripts existed only
to be pointed at by the mechanism that never worked, so they are removed.
Dropping the build setting also stops pod install writing an absolute ccache
path into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 232s, 1578/1582 cacheable
after, warm 18s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
janicduplessis added a commit to janicduplessis/react-native that referenced this pull request Aug 21, 2026
CCACHE_BINARY is set as an Xcode build setting by
set_ccache_compiler_and_linker_build_settings, and ccache-clang.sh reads it as an
environment variable. Xcode does not export build settings into the environment
of a compile task, so it is empty during a build and
exec $CCACHE_BINARY clang "$@"
word-splits down to plain clang. ccache is never invoked, and every translation
unit pays for a shell fork that achieves nothing.
Verified by logging the variable from inside the launcher during a clean
rn-tester build: empty on all 1578 compiler invocations, with 0 cacheable calls.
The build setting came from react#48257, which fixed a real problem -- builds started
from Xcode.app have no Homebrew on PATH. The intent was right, but the delivery
mechanism is not available to a compiler launcher: Xcode passes it neither build
settings nor arguments (a CC value containing arguments fails to spawn).
pod install now generates the launchers into Pods/ with both paths resolved at
install time, and points CC/CXX at those. The generated scripts are the ones this
removes, with CCACHE_BINARY replaced by the resolved ccache path and the config
path absolute rather than derived from $0. Pods/ is regenerated by every pod
install and is gitignored in the app templates, so the paths cannot go stale and
nothing tracked gains a machine-specific value.
Dropping the build setting also stops pod install writing an absolute ccache path
into a tracked project.pbxproj.
rn-tester, clean Debug simulator build, Xcode 26.6, Apple M4:
before 215s, 0 cacheable calls
after, cold 210s, 1578/1582 cacheable
after, warm 19s, 1578/1578 hits
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA SignedThis label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.MergedThis PR has been merged.Shared with MetaApplied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ccache not found

5 participants

@ste7en@facebook-github-bot@cipolleschi@react-native-bot@mefjuu