feat(android): port iOS rsync optimisations to Android build pipeline

[benjam-es]

Problem

The Android build pipeline in PreparesBuild.php and PlatformFileOperations.php has the same issues that were fixed for iOS in #30:

1. Minimal exclude rules — Only 4–6 hardcoded excludes (.git, node_modules, nativephp/*, vendor/nativephp/mobile/resources), so rsync copies thousands of non-runtime files (tests, docs, dotfiles, YAML configs, LICENSE files) into the temp directory.

2. Wrong vendor glob — vendor/*/vendor only matches one level deep, missing the actual Composer layout vendor/namespace/package/vendor. The separate vendor/nativephp/mobile/vendor line was a workaround for this bug.

3. No .gitattributes support — Vendor packages that declare export-ignore patterns are fully copied, including their test suites and CI configs.

4. Memory spike in ZIP step — addDirectoryToZip() calls iterator_to_array() to materialise every file into a PHP array before iterating, consuming ~20 MB unnecessarily.

5. Redundant hardcoded excludes — addDirectoryToZip() maintains its own list of 14 hardcoded excludes that partially overlap with rsync's excludes, making the filtering logic harder to maintain.

Solution

Port the iOS optimisations from #30 to the Android build:

• getExcludedPaths() — shared method with comprehensive exclude list (dotfiles, tests, docs, vendor non-runtime files, project-level build artifacts), with platform-aware nativephp/ handling
• loadVendorExportIgnorePatterns() — reads .gitattributes export-ignore from vendor packages
• prepareLaravelBundle() — replaces the match (PHP_OS_FAMILY) block with getExcludedPaths() + loadVendorExportIgnorePatterns()
• platformOptimizedCopy() — fixes vendor/*/vendor → vendor/*/*/vendor, removes hardcoded appends (now provided by caller)
• addDirectoryToZip() — streams iterator directly instead of materialising array; removes excludes now guaranteed absent after rsync (keeps safety-net excludes for files created between rsync and zip)

Benchmarks

Profiled on kitchen-sink-mobile-vue (Android build flow):

Rsync copy

	Stock	Patched
Exclude rules	10	50
Files copied	12,253	10,486
Copy size	131 MB	108 MB
Copy time	3,170 ms	2,552 ms

ZIP creation

	Stock	Patched
Files loaded into array	12,253	0 (streaming)
Files iterated	12,253	10,486
Files added to ZIP	12,253	10,486
ZIP time	5,750 ms	4,078 ms
ZIP size	48 MB	44 MB

Total

	Stock	Patched
Time (copy + zip)	9,093 ms	6,783 ms
Peak memory	20 MB	2 MB

Key takeaways:

• 10x less memory (2 MB vs 20 MB) — removing iterator_to_array is the big win
• 25% faster overall (6.8s vs 9.1s)
• 4 MB smaller ZIP (tests, docs, dotfiles excluded)
• Zero files excluded during ZIP in both cases — rsync is doing all the filtering, confirming the addDirectoryToZip() hardcoded excludes cleanup was safe

Test plan

• Profiled on kitchen-sink-mobile-vue (Android build flow)
• Verified final ZIP bundle contents match expected output
• Confirmed composer install step still runs correctly in temp directory
• Verified exclude list parity with iOS getExcludedPaths()
• Tested platform-specific nativephp/ exclude logic (Windows vs Unix)

[benjam-es]

This ports the same optimisations introduced in the iOS build in #30 — shared getExcludedPaths(), .gitattributes export-ignore support, fixed vendor glob pattern, and streaming the ZIP iterator instead of materialising it into memory.

The Android pipeline is a bit more involved since it needs to work across macOS, Linux, and Windows (robocopy vs rsync, different nativephp/ exclude logic per platform), so this might need more testing on those platforms to make sure nothing slips through. The core exclude list is identical to iOS, but the platform-conditional branches are worth a closer look.

[benjam-es]

Manual profiling: kitchen-sink-mobile-vue

Tested on real device build (native:run android) against the kitchen-sink-vue app (124 MB vendor, 14 plugins).

Build step timing

Step	v3.0.4 (original)	Optimised	Change
Copying Laravel source	3s	2s	-1s
Removing unnecessary files	—	4.56ms	new step
Creating bundle archive	4s	3s	-1s
Bundle size	44.79 MB	28.97 MB	-15.82 MB (35%)

What the 15.8 MB reduction is made of

Breakdown of the 1,794 files (34 MB pre-compression) now excluded from the bundle:

Category	Files	Size
vendor/laravel/pint/builds/	1	14.88 MB
vendor/nativephp/mobile/resources/ (Xcode/AS templates, .h, .swift, .kt)	372	12.92 MB
vendor/*/tests/	806	3.88 MB
vendor/*/*.md (README, CHANGELOG, etc)	313	1.30 MB
Root files (*.js, *.md, *.xml, *.lock)	4	0.41 MB
vendor/*/docs/	58	0.18 MB
vendor/*/LICENSE*	121	0.17 MB
nativephp/ (build output dirs)	4	0.15 MB
vendor/*/.github/	20	0.04 MB
vendor/*/*.neon	5	0.03 MB
tests/ (project)	15	0.02 MB
Dot files, storage, yml, artisan, etc	75	0.02 MB
Total	1,794	34.08 MB

Profiling script results (3-run average)

Metric	v3.0.4	Optimised	Change
Total time (copy + zip)	7.02s	6.01s	-1.01s (14%)
Peak PHP memory	42.0 MB	24.0 MB	-18 MB (43%)
Files before zip	12,250	10,462	-1,788
Pre-zip size	99.2 MB	65.1 MB	-34.1 MB
Final zip size	44.8 MB	29.0 MB	-15.8 MB (35%)

[benjam-es]

Safety of removed files

All excluded content is non-runtime:

Category	Why safe to exclude
vendor/laravel/pint/builds/ (14.9 MB)	Standalone Pint binary — CLI formatting tool, never used on device
vendor/nativephp/mobile/resources/ (12.9 MB)	Xcode/Android Studio project templates — used by native:install to scaffold the native project, not at runtime
vendor/*/tests/ (3.9 MB)	Package test suites — never executed on device
*.md, LICENSE*, docs/, .github/	Documentation and repo metadata
*.yml, *.yaml, *.neon	CI configs, PHPStan configs — not loaded at runtime
*.lock, artisan	Copied for composer install in the temp dir, then cleaned up after. Android's artisan.php bootstrap has a different filename and survives cleanup
Dot files (.gitignore, .editorconfig, .DS_Store)	SCM/editor config

The cleanup step (BundleFileManager::removeUnnecessaryFiles) runs after composer install and autoloader optimisation, so files needed by Composer (like composer.lock and artisan) are available during install and only removed from the final bundle.

[benjam-es]

Depends on #30 — this PR is rebased on feature/ios-build-rsync-copy and reuses the BundleFileManager / BundleExclusions classes introduced there. Merge #30 first.

[shanerbaner82]

Nice work — the refactor into BundleFileManager / BundleExclusions is clean and the benchmarks are compelling (10x memory reduction, 25% faster builds).

After merging main (which now includes #33's test fixes), 10 tests still fail — all the same root cause: tests calling $this->platformOptimizedCopy() which was removed from PlatformFileOperations. These tests weren't caught earlier because they only break when combined with this PR's removal of the method.

Failing tests:

• CrossPlatformFileOperationsTest (5) — calls $this->platformOptimizedCopy()
• EdgeCasesAndErrorHandlingTest (1) — circular symlinks test calls it
• InstallsAndroidTest (2) — createAndroidStudioProject calls it via the trait
• PlatformFileOperationsTest (2) — directly tests the removed method

These need to either be updated to use BundleFileManager::copy() or removed since the functionality moved. Everything else passes — the new tests (BundleFileManagerTest, AndroidBundleCopyTest, IosBuildCopyTest) all look good.

[benjam-es]

Android consistency + copyRaw()

After rebasing onto v3.1, I ported the same rsync approach to the Android build pipeline for consistency — both platforms now use BundleFileManager for all file operations.

During that work, I noticed that template and binary copies (Xcode project, Android Studio project, PHP libraries) were using a mix of File::copyDirectory() and the old platformOptimizedCopy() trait method. These copies should never have exclusion patterns applied — running them through BundleFileManager::copy() would strip files like AndroidManifest.xml because of the /*.xml exclusion pattern.

So I added BundleFileManager::copyRaw() — a plain copy with no exclusions, intended specifically for templates and binary artifacts. Under the hood it shares the same copyWithRsync/copyWithRobocopy private methods, just without passing any excludes. All template/binary copies across both platforms now use copyRaw(), while Laravel bundle copies use copy() with exclusions.

If merged this closes #30 at the same time