Skip to content
Toss

iOS Platform Support

iOS Platform Support

Section titled “iOS Platform Support”

iOS-specific implementation details for Toss.

Background Limitations

Section titled “Background Limitations”

iOS has strict limitations on background clipboard access. The app cannot monitor clipboard changes when in the background. However, there are several workarounds:

  1. App Extensions - Share extensions can access clipboard
  2. Shortcuts Integration - Siri Shortcuts can trigger sync
  3. Widgets - Home screen widgets can trigger sync
  4. Foreground Optimization - Optimize sync when app is active

Implementation Status

Section titled “Implementation Status”

Basic Structure: Created ios_background_service.dart with:

  • Shortcut action registration
  • Widget update methods
  • Foreground sync optimization
  • App extension setup structure

Files:

  • flutter_app/lib/src/core/services/ios_background_service.dart
  • flutter_app/ios/Runner/Info.plist (updated with background modes)

Required Native Code

Section titled “Required Native Code”

1. App Extension

Section titled “1. App Extension”

Create Share Extension target in Xcode:

  • Share extension target
  • Clipboard access from extension
  • Communication with main app

2. Shortcuts Integration

Section titled “2. Shortcuts Integration”

In ios/Runner/AppDelegate.swift:

  • Handle UIApplicationShortcutItem
  • Register shortcut actions
  • Trigger sync on shortcut invocation

3. Widget

Section titled “3. Widget”

Create widget extension:

  • Home screen widget target
  • Quick sync button
  • Status display

Next Steps

Section titled “Next Steps”
  1. Create Share Extension target in Xcode
  2. Implement shortcut handlers in AppDelegate
  3. Create widget extension
  4. Test on iOS device

See Also

Section titled “See Also”