apache / apache/cordova-plugin-screen-orientation

Document that rotation lock is not working when multitasking is active on iOS

Open
#59 4 comments 0 reactions 0 assignees View on GitHub
enhancement platform: ios
Dominant language
JavaScript
Stars
219
Forks
234
PR merge metrics
No merged PRs in 30d

Description

When a user sets `UIRequiresFullScreen` to false, the orientation can't be locked on iOS. This is **not** a bug, but should be documented. See, e.g., https://www.telerik.com/forums/app-store-rejects-build-with-error-itms-90475-invalid-bundle-ipad-multitasking-support-requires-launch-story-board-in-bundle#wpXQ60c5tUmub3dI7iXi-A

We could think about rejecting the Promise in this case though.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the plugin's existing documentation and the iOS setting UIRequiresFullScreen, then compare the reported behavior with the linked Apple forum discussion. Done means the documentation clearly explains that orientation locking is unavailable when multitasking is enabled and distinguishes this expected behavior from a bug.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios, javascript
Domain
documentation, mobile-dev
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.