framework

The levure/framework folder contains the levure.livecodescript script-only LiveCode stack which has the Levure library handlers and provides the primary framework functionality. You should not modify any code in this stack or in the supporting framework/helpers folder.

• 📂 your_project_folder
  • 📂 levure
    • 📂 framework
      • levure.livecodescript
      • 📁 helpers
    • 📁 packager
    • 📁 utils
  • 📁 your_application_folder

When your application starts up, the levure.livecodescript stack script is automatically opened and attached to your executable standalone stack as a behavior. The framework script is then placed into the message path with start using so the framework handlers are globally accessible throughout your application.

Framework helpers

The levure/framework folder also contains a helpers folder which adds additional functionality to the framework. The helpers in the levure/framework/helpers folder should normally not be modified.

The framework ships with a number of helpers that you can use in your application. To load a helper use the {{FRAMEWORK}} variable. Example:

helpers:
  1:
    filename: {{FRAMEWORK}}/helpers/preferences

Any helpers included with the framework automatically has its preload flag set to true. That means the helper will be loaded before the PreloadApplication message is sent.

./helpers/files_and_urls

Helps with files associated with your application, managing a recent files list, as well as when the OS asks your application to process a url. Also includes functions for generating file dialog type filter strings.

ProcessFiles message sent to app stack. Check appGetFilesToProcessOnOpen when app opens for files passed on command line.

ProcessURL message sent to app stack. Check appGetURLsToProcessOnOpen() when app opens for urls passed on the command line.

./helpers/broadcaster

API for broadcasting and listening for messages.

./helpers/translate

API for providing translated versions of strings in your app. When you call translateSetLocale the library looks for a ./locales/[LANG_CODE].yml file alongside your app.yml file.

./helpers/logger

API for setting up a log file. Has option to log internet traffic. Turning it on will intercept the ulLogit message that libURL uses and log those messages to your log file.

./helpers/preferences

API for managing your application preferences. On OS X and external is used so that you can set preferences using the OS X APIs. On Windows and Linux preferences are stored in a file containing data serialized using arrayEncode.

./helpers/undo_manager

Manage undo in your application.

./helpers/window_manager

Manages windows in your application. Set a flag on a stack and it's position will be stored across sessions. Also keeps stacks on screen when the desktopChanged message is received.