# iOS Setup Guide
## SumUp SDK Framework Installation
The SumUp SDK framework is not included in the published package due to size constraints (101MB). You need to download and install it manually.
### Step 1: Download the SumUp iOS SDK
1. Download the SumUp iOS SDK from the official repository:
- GitHub: https://github.com/sumup/sumup-ios-sdk
- Or download the latest release ZIP
2. Extract the `SumUpSDK.xcframework` from the downloaded package
### Step 2: Add the Framework to Your Project
#### Option A: Copy to Plugin Directory (Recommended)
```bash
# Navigate to your project's ios directory
cd your-tauri-app/src-tauri/gen/apple
# Create a Frameworks directory if it doesn't exist
mkdir -p Frameworks
# Copy the framework
cp -R /path/to/downloaded/SumUpSDK.xcframework ./Frameworks/
```
#### Option B: Reference External Framework
Alternatively, you can keep the framework in a central location and update the Xcode project to reference it.
1. Open your Tauri app's Xcode project
2. Go to your target's "Build Phases"
3. Add the `SumUpSDK.xcframework` to "Link Binary With Libraries"
4. Add the framework to "Embed Frameworks" if needed
### Step 3: Verify Installation
Build your iOS app:
```bash
pnpm tauri ios build
```
If you see errors about missing `SumUpSDK`, verify:
- The framework is in the correct location
- The framework path in your Xcode project is correct
- The framework is properly linked
## Alternative: Swift Package Manager (Future)
SumUp may provide Swift Package Manager support in the future. Check the official repository for updates.
## Troubleshooting
### Framework not found
If you get "framework not found SumUpSDK" errors:
1. Check that the framework exists at the expected path
2. Clean build folder: `pnpm tauri ios build --clean`
3. Verify the framework architecture matches your target (arm64 for device, x86_64/arm64 for simulator)
### Size Issues
The SumUp SDK is approximately 101MB. This is normal for payment SDKs that include:
- Multiple architectures (device + simulator)
- Localization files for 30+ languages
- UI resources and assets
## License
Make sure you comply with SumUp's SDK license terms when distributing your application.