# 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)

```bash
# 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)

```bash
# 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

```bash
# 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

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

### For Standalone iOS Test App

```bash
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**:
   ```bash
   cd test-apps/daily-notification-test
   npm install  # If not done
   npm run build
   npx cap sync ios
   ```
3. **Open in Xcode and build**:
   ```bash
   # 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](COCOAPODS_INSTALLATION.md) - Detailed installation instructions
- [iOS Test Apps Setup Complete](IOS_TEST_APPS_SETUP_COMPLETE.md) - What was completed
- [iOS Sync Status](IOS_SYNC_STATUS.md) - 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.