How To Install 3rd Party Externals For Use in the IDE and Standalone Builder
This lesson will show you how to install an external so that it loads into the Revolution IDE and can be included with a standalone.
Locate The User Extensions Folder
Add External to Externals Folder
Update Externals.txt File
Open the Externals.txt file (1), creating it if necessary. You need to add one line to this file that tells Revolution about your external. The line contains 2 items. The 1st item is the name of your external as it appears in the externalPackages property (2). In this example I'm using the EnhancedQT external so that name is EnhancedQT. The 2nd item is the name of the external file (3). Save the file and close.
Add External To Runtime Folder
Also in your User Extensions folder is a Runtime folder (1) that you can create if necessary. This is where you put the version of the external that should be included when building a standalone application. Place a copy of the external in the platform folders that you want to include (2). Note that for OS X the external is in the Universal folder. That is because the EnhancedQT is a universal binary.
Quick Tip: If you have to create this folder then note the folder structure in this example. The folder structure mimics that of the Runtime folder that sits alongside the Revolution IDE engine.
Check Your Work
Check the Standalone Builder
Build Standalone
If you select your external to be included then when you build a standalone application Revolution will copy the external to the proper locations. Revolution also creates a substack named revExternalLibrary that is attached to the stack you used to build the standalone. If you check the externalPackages of stack "revExternalLibrary" then your external should be listed. Note that this stack is only created when you build the standalone.
Very confusing directions. It shows the extensions folder as "My Revolution Enterprise" but the next step says to put the external in the folder External. It talks about adding a .bundle file, but the external I purchased doesn't have a .bundle file. Do I then add the same files to the Runtime folder? Why does it need to be in two folders? etc. etc.