apache / apache/cordova-plugin-file

required info.plist adjustments are within scope of using this plugin but not discussed

Open
#392 2 comments 1 reaction 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.