[CB-285] Add property returning root path of Important FileSystem Locations

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.4.0
• Component/s: cordova-js
• Labels: features

Environment

Both PhoneGap SDK and PhoneGap Build

• Assignee: Andrew Grieve
• Reporter: Ashley Gullen
• Created: 29/Feb/12 14:00
• Updated: 23/Aug/18 07:18
• Resolved: 27/May/14 02:02

Description

There needs to be a property in PhoneGap that returns the root path to the general files added to the PhoneGap project (i.e. the directory index.html is in). For example, if I add 'music.mp3' to my project, in Android it will be located in:

/android_asset/www/music.mp3

On iOS after being built with PhoneGap Build it will be located in some path like this:

/var/mobile/Applications/<app_ID>/<name>.app/www/music.mp3

However, there does not appear to be a programmatic way to determine both <app_ID> and <name>.app.

This has two side effects:
1. Paths to audio for Media must be hard-coded separately depending on the platform, which is inconvenient.
2. Paths to audio for Media cannot be known if developing a framework that uses PhoneGap. Since a framework does not know the App ID or name in advance, it's impossible for the framework to determine the correct path.

This is actively blocking audio from working on iOS in PhoneGap projects exported by Construct 2 (www.scirra.com), a HTML5 game creator. Also, it seems like kind of an important function to make available anyway, since hard-coding paths for each platform is a pain.

This PhoneGap Support thread led to this issue: http://phonegap.tenderapp.com/discussions/questions/208-android_asset-equivalent-for-ios

Issue Links

• is duplicated by: CB-99 Normalize Media recording in PhoneGap
• is duplicated by: CB-6670 How to use filesystem alias of cordova file plugin?
• is related to: CB-6428 Unable to read android_asset directory through File API
• relates to: CB-5915 Change iOS filesystem root location