extension-file-save

A cross-platform OpenFL/Lime native extension for saving files via native OS file pickers. Supports desktop (direct path write) and mobile (copy-to-destination) workflows.

Platform Support

Installation

haxelib dev extension-file-save path/to/extension-file-save

Add to project.xml:

<haxelib name="extension-file-save" />

API

Desktop — requestSavePath / releasePath

The user picks a save location; your code writes directly to that path. On macOS the extension holds a security-scoped bookmark until releasePath() is called.

// Ask the user where to save, then write directly to the returned path
FileSave.requestSavePath('animation.mp4', 'video/mp4', (path:String) -> {
    beginEncoding(path, () -> {
        FileSave.releasePath(); // Release security-scoped access (macOS sandbox)
    });
}, () -> {
    trace('User cancelled');
});

Mobile — saveFile

Copies an existing file to a user-chosen location via the native picker.

FileSave.saveFile('/tmp/output.mp4', 'animation.mp4', 'video/mp4', (success:Bool) -> {
    if (success) trace('Saved');
});

Building the Native Library

lime rebuild . <target> -release

Or directly via hxcpp:

haxelib run hxcpp project/Build.xml -D<platform> -DHXCPP_ARM64

Windows and Linux use Lime's built-in FileDialog and do not require a native library build.

macOS Sandbox Note

requestSavePath calls NSSavePanel and retains a security-scoped URL for the chosen file. This keeps sandbox access open while your code writes to the path. Call releasePath() as soon as writing is complete to release the resource.

License

MIT