apache / apache/cordova-plugin-file
required info.plist adjustments are within scope of using this plugin but not discussed
- Dominant language
- JavaScript
- Stars
- 744
- Forks
- 754
- Avg merge
- 3d 4h
- Merged PRs (30d)
- 1
Description
Regarding 6.0.2
# Feature Request
Document this plugin's relationship to the mandatory *-info-plist options for iOS builds. It is necessary to manually adjust build options for an iOS target in order to gain equivalent access to external storage as Android.
Examples:
UIFileSharingEnabled
LSSupportsOpeningDocumentsInPlace
Several iOS tags were experimented with which did not result in equivalent plist settings or file write access.
## Motivation Behind Feature
Documentation leads one to believe writing files to folders that will then be accessible in the iOS file browser ('Files' app) is a matter of choosing the correct cordova.file.* definition from the provided table. There is no mention of the XCode build options that must also be added. Managing these details fits within the scope of platform agnostic tooling. The requirement is a surprise and a troubleshooting time sink.
Ref: https://stackoverflow.com/questions/59825500/ionic-4-ios-file-access-with-ionic-native-file-ngx-cordova-plugin-file
## Feature Description
Improve iOS documentation or improve plugin installation and implementation. Manage build options or document that they ought to be.
## Alternatives or Workarounds
Manually adjust your framework's iOS build options or XCode's *-info-plist to actually make the cordoval.file.* choices work.
Contributor guide
Research direction
Review the plugin's iOS documentation and installation guidance alongside the required UIFileSharingEnabled and LSSupportsOpeningDocumentsInPlace settings. Confirm whether the work is documentation-only or requires installation changes, then document the required Xcode or *-info-plist configuration and verify that the Files app access steps are unambiguous.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- ios, javascript
- Domain
- documentation, mobile-dev
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100