Capacitor App Upgrade v8 to v9

Capacitor 9 is a prerelease (next dist-tag, 9.0.0-alpha.x as of October 2026). Install with @next; switch to @latest / ^9.0.0 once 9.0.0 is GA. Tell the user it is not GA before upgrading a production app, and work on a branch.

Canonical source: https://capacitorjs.com/docs/updating/9-0

When to Use

TRIGGER when:

• App is on @capacitor/core 8.x and the user wants Capacitor 9
• Build errors after moving to Xcode 27 / Swift 6, AGP 9, or Gradle 9 in a Capacitor 8 app
• npx cap run -l --host ... no longer works (--url replaced it)
• Push notifications presentationOptions: ['alert'] stopped showing banners on iOS
• Cordova-plugin-free app fails on CapacitorCordova / com.getcapacitor.cordova references after upgrading