# 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
You need to add the SumUp SDK framework to **your Tauri app's project**, not the plugin.
#### For Tauri iOS Projects:
```bash
# 1. Navigate to your app's generated iOS project
cd your-tauri-app/src-tauri/gen/apple
# 2. Create a Frameworks directory if it doesn't exist
mkdir -p Frameworks
# 3. Copy the SumUp SDK framework
cp -R /path/to/downloaded/SumUpSDK.xcframework ./Frameworks/
```
#### Linking the Framework in Xcode:
1. Open your app's Xcode project:
```bash
cd your-tauri-app/src-tauri/gen/apple
open your-app.xcodeproj
```
2. Select your app target (e.g., `your-app_iOS`)
3. Go to "Build Phases" tab
4. Under "Link Binary With Libraries", click the "+" button
5. Click "Add Other..." → "Add Files..."
6. Navigate to and select `Frameworks/SumUpSDK.xcframework`
7. Under "Embed Frameworks", also add the same framework (create this section if it doesn't exist)
8. In "Build Settings", search for "Framework Search Paths" and ensure it includes:
```
$(PROJECT_DIR)/Frameworks
```
### 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.