Files
SousChefAI/PRIVACY_SETUP.md
2026-02-11 15:09:39 -06:00

3.1 KiB

Privacy Configuration for SousChefAI

Camera Permission Setup (Required)

The app needs camera access to scan ingredients and monitor cooking. Follow these steps to add the required privacy descriptions:

  1. Open the project in Xcode
  2. Select the SousChefAI target in the project navigator
  3. Go to the Info tab
  4. Under "Custom iOS Target Properties", click the + button
  5. Add the following keys with their values:

Camera Permission:

  • Key: Privacy - Camera Usage Description
  • Value: SousChefAI needs camera access to scan your fridge for ingredients and monitor your cooking progress in real-time.

Microphone Permission (for voice guidance):

  • Key: Privacy - Microphone Usage Description
  • Value: SousChefAI uses the microphone to provide voice-guided cooking instructions.

Method 2: Manual Info.plist (Alternative)

If you prefer to manually edit the Info.plist:

  1. In Xcode, right-click on the SousChefAI folder
  2. Select New FileProperty List
  3. Name it Info.plist
  4. Add these entries:
<key>NSCameraUsageDescription</key>
<string>SousChefAI needs camera access to scan your fridge for ingredients and monitor your cooking progress in real-time.</string>

<key>NSMicrophoneUsageDescription</key>
<string>SousChefAI uses the microphone to provide voice-guided cooking instructions.</string>

Verifying the Setup

After adding the privacy descriptions:

  1. Clean the build folder: Product → Clean Build Folder (⌘ + Shift + K)
  2. Rebuild the project: Product → Build (⌘ + B)
  3. Run on a device or simulator
  4. When you first open the Scanner view, you should see a permission dialog

Troubleshooting

"App crashed when accessing camera"

  • Ensure you added NSCameraUsageDescription to the target's Info settings
  • Clean and rebuild the project
  • Restart Xcode if the permission isn't taking effect

"Permission dialog not appearing"

  • Check that the Info settings were saved
  • Try deleting the app from the simulator/device and reinstalling
  • Reset privacy settings on the simulator: Device → Erase All Content and Settings

"Multiple Info.plist errors"

  • Modern Xcode projects use automatic Info.plist generation
  • Use Method 1 (Target Settings) instead of creating a manual file
  • If you created Info.plist manually, make sure to configure the build settings to use it

Privacy Manifest

The PrivacyInfo.xcprivacy file is included for App Store compliance. This declares:

  • No tracking
  • No third-party SDK tracking domains
  • Camera access is for app functionality only

Testing Camera Permissions

  1. Build and run the app
  2. Navigate to the Scan tab
  3. You should see a permission dialog
  4. Grant camera access
  5. The camera preview should appear

If permission is denied:

  • Go to Settings → Privacy & Security → Camera
  • Find SousChefAI and enable it
  • Relaunch the app

Note: These privacy descriptions are required by Apple's App Store guidelines. Apps that access camera without proper usage descriptions will be rejected.