Enable ccache for faster builds (#335)

Author: kiftio

CONTRIBUTING.md

@@ -44,6 +44,28 @@ yarn sample start
 This command will start the Metro server. Follow the steps given by Metro to
 open both the iOS and Android simulators/emulators respectively.
 
+## Optional: Speed up builds with ccache
+
+For faster native compilation (especially on incremental builds), you can install [ccache](https://ccache.dev/), a compiler cache:
+
+```sh
+# macOS (using Homebrew)
+brew install ccache
+
+# Ubuntu/Debian
+sudo apt-get install ccache
+
+# Other systems: see https://ccache.dev/download.html
+```
+
+The build scripts will automatically detect and use ccache if available. If you encounter any build issues, you can temporarily disable it:
+
+```sh
+# Disable ccache for a single build
+CCACHE=false yarn sample ios
+CCACHE=false yarn sample android
+```
+
 ## Making changes to the Native Module
 
 If your intentions are to modify the TS code for the Native Module under

dev.yml

@@ -1,9 +1,19 @@
 name: checkout-sheet-kit-react-native
 
+edition: 2024
+
 type: node
 
 up:
+  - packages:
+    - swiftlint
+    - ccache
   - ruby
+  - xcode:
+      version: '26.0'
+      runtimes:
+        ios:
+          - '26.0'
   - node:
       version: v20.11.1
       yarn: 1.22.22
@@ -28,10 +38,6 @@ up:
       meet: |
         yarn module build
 
-packages:
-  - xcode
-  - swiftlint
-
 check:
   lint_swift: ./scripts/lint_swift
   lint_module: yarn module lint
@@ -57,6 +63,9 @@ commands:
       yarn module clean
       yarn sample clean
       yarn clean
+      if command -v ccache >/dev/null 2>&1; then
+        ccache -C
+      fi
       echo "✅ Cleaned root, module and sample workspaces"
 
   fix:

sample/ios/Podfile

@@ -34,11 +34,12 @@ target 'ReactNative' do
 
   post_install do |installer|
     # https://github.com/facebook/react-native/blob/main/packages/react-native/scripts/react_native_pods.rb#L197-L202
+    # Enable ccache by default - controlled via build script PATH manipulation
     react_native_post_install(
       installer,
       config[:reactNativePath],
       :mac_catalyst_enabled => false,
-      # :ccache_enabled => true
+      :ccache_enabled => true
     )
 
     # WORKAROUND

sample/ios/Podfile.lock

@@ -2888,6 +2888,6 @@ SPEC CHECKSUMS:
   SocketRocket: d4aabe649be1e368d1318fdf28a022d714d65748
   Yoga: a742cc68e8366fcfc681808162492bc0aa7a9498
 
-PODFILE CHECKSUM: 8b772325d9e3958706bda5b26aa6b2b8994a6f25
+PODFILE CHECKSUM: 42a4ad42b0177ca0f927363d8f2b6059c6dd77c7
 
 COCOAPODS: 1.15.2

sample/ios/ReactNative.xcodeproj/project.pbxproj

@@ -848,7 +848,8 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
-				CC = "";
+				CC = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang.sh";
+				CCACHE_BINARY = /opt/homebrew/bin/ccache;
 				CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES;
 				CLANG_CXX_LANGUAGE_STANDARD = "c++20";
 				CLANG_CXX_LIBRARY = "libc++";
@@ -876,7 +877,7 @@
 				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
 				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
 				COPY_PHASE_STRIP = NO;
-				CXX = "";
+				CXX = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang++.sh";
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
 				ENABLE_TESTABILITY = YES;
 				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = i386;
@@ -897,8 +898,8 @@
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
 				IPHONEOS_DEPLOYMENT_TARGET = 16.6;
-				LD = "";
-				LDPLUSPLUS = "";
+				LD = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang.sh";
+				LDPLUSPLUS = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang++.sh";
 				LD_RUNPATH_SEARCH_PATHS = (
 					/usr/lib/swift,
 					"$(inherited)",
@@ -931,7 +932,8 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
-				CC = "";
+				CC = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang.sh";
+				CCACHE_BINARY = /opt/homebrew/bin/ccache;
 				CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES;
 				CLANG_CXX_LANGUAGE_STANDARD = "c++20";
 				CLANG_CXX_LIBRARY = "libc++";
@@ -959,7 +961,7 @@
 				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
 				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
 				COPY_PHASE_STRIP = YES;
-				CXX = "";
+				CXX = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang++.sh";
 				ENABLE_NS_ASSERTIONS = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
 				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = i386;
@@ -976,8 +978,8 @@
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
 				IPHONEOS_DEPLOYMENT_TARGET = 16.6;
-				LD = "";
-				LDPLUSPLUS = "";
+				LD = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang.sh";
+				LDPLUSPLUS = "$(REACT_NATIVE_PATH)/scripts/xcode/ccache-clang++.sh";
 				LD_RUNPATH_SEARCH_PATHS = (
 					/usr/lib/swift,
 					"$(inherited)",

sample/scripts/build_ios

@@ -3,6 +3,19 @@
 set -ex
 set -eo pipefail
 
+# Add ccache to PATH if available for faster compilation outside of CI environments
+# Can be disabled with CCACHE=false for debugging or matching CI behavior locally
+if [ "$CI" = "true" ] || [ "$CCACHE" = "false" ]; then
+    # CI detected or ccache explicitly disabled - skipping ccache for clean builds
+    if command -v ccache >/dev/null 2>&1; then
+        ccache -C
+    fi
+else
+    if [ -d "/opt/homebrew/opt/ccache/libexec" ]; then
+        export PATH="/opt/homebrew/opt/ccache/libexec:$PATH"
+    fi
+fi
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/simulator"
 dest="$(get_sim_destination)"