Uitrol 16-10-2026 15:41

docs/iOS-app.md

@@ -14,11 +14,33 @@ Dit document gaat over dat verschil, en over wat Apple wil.
   Dat moet wel zo: staat de iOS-doelomgeving er onvoorwaardelijk in, dan wil ook een build van
   alleen de Android-APK de iOS-werkbelasting en een Mac hebben, en struikelt het maken van de
   APK over iets wat er niets mee te maken heeft.
-- `Platforms/iOS/` heeft `AppDelegate.cs`, `Program.cs` en `Info.plist`.
+- `Platforms/iOS/` heeft `AppDelegate.cs`, `Program.cs`, `Info.plist`, `PrivacyInfo.xcprivacy`
+  (de privacyverklaring die Apple uit de app leest) en `Entitlements.plist` (Keychain-toegang;
+  zonder die kan SecureStorage in de simulator niets bewaren). De csproj wijst er voor iOS naar.
+- `tools/ios-bouwen.sh` voor op de Mac: `controle`, `simulator` of `toestel`.
 - `Toestelslot` heeft een iOS-tak: Face ID of Touch ID via LocalAuthentication, met de code van
   de telefoon als terugval.
 - De gebruikstoelichtingen staan in `Info.plist`.
 
+## Eerste keer op de Mac
+
+1. Xcode uit de App Store, één keer openen, licentie accepteren.
+2. .NET 10 SDK installeren (https://dotnet.microsoft.com/download).
+3. De repo naar de Mac halen (git of kopiëren) en in de hoofdmap:
+
+       chmod +x tools/ios-bouwen.sh
+       tools/ios-bouwen.sh controle      # installeert zo nodig de maui-ios-werkbelasting
+       tools/ios-bouwen.sh simulator     # bouwt en start in de iPhone-simulator
+
+Een simulator heeft geen Apple Developer-account nodig. Een echt toestel kan met een gratis
+Apple-ID ("personal team", 7 dagen geldig, zonder meldingen). TestFlight, App Store en meldingen
+hebben het betaalde Developer Program nodig.
+
+Als bouwen mislukt, stuur dan de eerste foutregels op: de eerste build van iOS-code die nog nooit
+gecompileerd is, geeft meestal een handvol kleine dingen (een ontbrekende using, een
+API-naam). `PrivacyInfo.xcprivacy` moet na het bouwen in de `.app` zitten
+(`find . -name PrivacyInfo.xcprivacy`).
+
 ## Wat er nog moet
 
 **Een Mac.** Apple's bouwgereedschap draait alleen op macOS. Visual Studio op Windows verbindt