3.4 KiB
3.4 KiB
Build Script Improvements
Date: 2025-11-13
Status: ✅ FIXED
Issues Fixed
1. Missing Build Folder ✅
Problem:
- Script was looking for
builddirectory:find build -name "*.app" - Xcode actually builds to
DerivedData:~/Library/Developer/Xcode/DerivedData/App-*/Build/Products/
Solution:
- Updated script to search in
DerivedData:DERIVED_DATA_PATH="$HOME/Library/Developer/Xcode/DerivedData" APP_PATH=$(find "$DERIVED_DATA_PATH" -name "App.app" -path "*/Build/Products/Debug-iphonesimulator/*" -type d 2>/dev/null | head -1)
Result: ✅ App path now correctly detected
2. Simulator Not Launching ✅
Problem:
- Script only built the app, didn't boot or launch simulator
- No automatic deployment after build
Solution:
- Added automatic simulator boot detection and booting
- Added Simulator.app opening if not already running
- Added boot status polling (waits up to 60 seconds)
- Added automatic app installation
- Added automatic app launch (with fallback methods)
Implementation:
# Boot simulator if not already booted
if [ "$SIMULATOR_STATE" != "Booted" ]; then
xcrun simctl boot "$SIMULATOR_ID"
open -a Simulator # Open Simulator app
# Wait for boot with polling
fi
# Install app
xcrun simctl install "$SIMULATOR_ID" "$APP_PATH"
# Launch app
xcrun simctl launch "$SIMULATOR_ID" org.timesafari.dailynotification.test
Result: ✅ Simulator now boots and app launches automatically
Improvements Made
Boot Detection
- ✅ Polls simulator state every second
- ✅ Waits up to 60 seconds for full boot
- ✅ Provides progress feedback every 5 seconds
- ✅ Adds 3-second grace period after boot detection
App Launch
- ✅ Tries direct launch first
- ✅ Falls back to console launch if needed
- ✅ Provides manual instructions if automatic launch fails
- ✅ Handles errors gracefully
Error Handling
- ✅ All commands have error handling
- ✅ Warnings instead of failures for non-critical steps
- ✅ Clear instructions for manual fallback
Current Behavior
- ✅ Builds the iOS test app successfully
- ✅ Finds the built app in DerivedData
- ✅ Detects available iPhone simulator
- ✅ Boots simulator if not already booted
- ✅ Opens Simulator.app if needed
- ✅ Waits for simulator to fully boot
- ✅ Installs app on simulator
- ✅ Launches app automatically
Known Limitations
Launch May Fail
- Sometimes
xcrun simctl launchfails even though app is installed - Workaround: App can be manually launched from Simulator home screen
- Alternative: Use Xcode to run the app directly (Cmd+R)
Boot Time
- Simulator boot can take 30-60 seconds on first boot
- Subsequent boots are faster
- Script waits up to 60 seconds, but may need more on slower systems
Testing
Command:
./scripts/build-ios-test-app.sh --simulator
Expected Output:
[INFO] Build successful!
[INFO] App built at: /Users/.../DerivedData/.../App.app
[STEP] Checking simulator status...
[STEP] Booting simulator (iPhone 17 Pro)...
[STEP] Waiting for simulator to boot...
[INFO] Simulator booted successfully (took Xs)
[STEP] Installing app on simulator...
[INFO] App installed successfully
[STEP] Launching app...
[INFO] ✅ App launched successfully!
[INFO] ✅ Build and deployment complete!
Last Updated: 2025-11-13