daily-notification-plugin/docs/IOS_SETUP_REQUIREMENTS.md

iOS Setup Requirements and Current Status

Author: Matthew Raymer
Date: 2025-11-04
Status: ⚠️ MANUAL STEP REQUIRED

Current Status

✅ Completed (Command-Line Setup)

1. Vue 3 Test App iOS Platform

   • iOS platform added via npx cap add ios
   • Xcode project structure created
   • Podfile created with plugin dependency
   • All files in place

2. Standalone iOS Test App

   • App structure created
   • Capacitor config created
   • Podfile created with plugin dependency
   • Test HTML interface copied
   • All files in place

3. Plugin Integration

   • Both Podfiles configured correctly
   • Plugin paths verified
   • Ready for CocoaPods installation

⚠️ Manual Step Required

CocoaPods Installation - Cannot be automated due to:

• Ruby version requirement (>= 2.7.0, system has 2.6.10)
• Requires sudo password or Homebrew installation
• User interaction needed

System Information

Current Ruby Version: 2.6.10p210 (too old)
Required Ruby Version: >= 2.7.0
Homebrew: Not installed
CocoaPods: Not installed

Required Actions

Option 1: Install Homebrew and Ruby (Recommended)

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Ruby
brew install ruby

# Add to PATH (add to ~/.zshrc)
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Verify Ruby version
ruby --version  # Should be >= 2.7.0

# Install CocoaPods
gem install cocoapods

# Verify installation
pod --version

Option 2: Use System Ruby with sudo (Not Recommended)

# Install drb dependency (already done)
# sudo gem install drb -v 2.0.6

# Install CocoaPods (requires password)
sudo gem install cocoapods

# Note: This may still fail due to Ruby version incompatibility

Option 3: Use rbenv for Ruby Version Management

# Install rbenv
brew install rbenv ruby-build

# Install Ruby 3.2.0
rbenv install 3.2.0
rbenv global 3.2.0

# Install CocoaPods
gem install cocoapods

# Verify
pod --version

After CocoaPods Installation

For Vue 3 Test App

cd test-apps/daily-notification-test/ios/App
pod install

For Standalone iOS Test App

cd test-apps/ios-test-app/App
pod install

Verification Checklist

• Ruby version >= 2.7.0 installed
• CocoaPods installed (pod --version works)
• Vue test app: pod install completed successfully
• Standalone test app: pod install completed successfully
• Xcode workspaces created (App.xcworkspace exists)
• Can open projects in Xcode

Next Steps After CocoaPods

1. Install CocoaPods dependencies (see above)
2. Build Vue test app web assets:

   cd test-apps/daily-notification-test
   npm install  # If not done
   npm run build
   npx cap sync ios
   

3. Open in Xcode and build:

   # Vue test app
   cd test-apps/daily-notification-test/ios/App
   open App.xcworkspace
   
   # Standalone test app
   cd test-apps/ios-test-app/App
   open App.xcworkspace  # After pod install creates it
   

Documentation

• CocoaPods Installation Guide - Detailed installation instructions
• iOS Test Apps Setup Complete - What was completed
• iOS Sync Status - API comparison and status

Summary

All command-line setup is complete. The only remaining step is manual CocoaPods installation, which requires:

1. Ruby version upgrade (>= 2.7.0)
2. CocoaPods gem installation
3. Running pod install in both test app directories

Once CocoaPods is installed, both iOS test apps will be ready for building and testing in Xcode.