fResourceDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

External file management functions

Integrating resources when generating the iPhone/iPad application

Handling the read-only files found in the directory of resources

See also

Constants for the external files

Functions for managing directories and external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fInsertTextAtBeginning

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

Integrating resources when generating the iPhone/iPad application
Handling the read-only files found in the directory of resources

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fResourceDir (Function)

In french: fRepRessource

Returns the path of the read-only resources of the application.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// The function returns the content of the file
fLoadBuffer(fResourceDir() + ["\"] + "data.bin")

Syntax

<Result> = fResourceDir()

<Result>: Character string

Full path of the read-only resources found in the application. Corresponds to the ".app" directory of the application. You cannot write into this directory.

Remarks

Integrating resources when generating the iPhone/iPad application

The wizard for generating the application for iOS allows you to include files in the executable. You can include:

specific resources.
specific images.
data files.

If the "Write" option is checked for the files, these files will be automatically extracted (e.g., files that must be modified by the application). In this case, specify the application directory into which this file must be extracted ("Documents" directory or "Library" directory).

If the "Write" option is unchecked for the files, these files can be:

used directly (files to read for example: sound files, image files, etc.). These files are included in the application and they will not be extracted. fResourceDir is used to access these files in read mode.
extracted by programming with fExtractResource.

Caution: The iOS system is case-sensitive.

Handling the read-only files found in the directory of resources

The tree structure of the resource directory is identical to the tree structure of the project directory on the development computer:

on the development computer, the resource included in the Xcode project can be found in a directory such as:
<Project_Name>\EXE\<Configuration Name>\<Custom Directory>.
on the iPhone or on the iPad, the resource will be found in a directory such as:
fResourceDir() + \EXE\<Configuration Name>\<Custom Directory>.

Example: the following code is used to check the existence of the "stop.png" file in the directory of resources. On the development computer, this file was found in the "C:\My Mobile Projects\MyApp\Exe\iOS Application\stop.png" directory.

On the iPhone or on the iPad, this path corresponds to: "<Application Directory>/MyApp.app/Exe/iOS Application/stop.png".

IF fFileExist(CompleteDir(fResourceDir()) + CompleteDir("Exe") + ...
CompleteDir("iOS Application") + "stop.png") = True THEN
Info("The image was found")
ELSE
Info("Image not found.")
END