How Do I Package My Application For Use With An Installer Or Auto Update?
When it comes time to distribute your application to users you use the GLX Application Packager to package your application files for an installer or files that can be used with the auto update architecture.
Note: Currently you need to build the executables for both OS X and Windows before using the application packager.
Open The GLX Application Packager
Launch the Revolution IDE and then open the glxApplicationPackager.rev stack located in the application packager folder of the GLX distribution files. You should not open any of your application stacks in the IDE while packaging an application. The application packager would ideally run as a standalone application but during the packaging process some scripts are modified which exceed the 10 line limit. So for the time being you must package from within the IDE.
Tip: Use a Second Copy of Revolution
I like to work on my application in one copy of Revolution and have the application packager open in a second copy of Revolution. That way I don't have to quit and relaunch Revolution each time I want to build an update. On OS X I just make a duplicate of the Revolution.app file and launch that.
Load Your Application Stack
Click on the Load Application button to load your application stack.
Selection the application.dat file for your application. This file contains all of the settings for your application.
Select a Build Profile
Select the build profile you want to package the application for. The build profile affects the auto update urls used as well as the parameter passed to glxapp_build handler in the application stack script.
To build a set of files for use with auto update click Build Updater (1). If you have configured your FTP server settings in the GLX Application Framework plugin then you can automatically upload the update.
To build a set of files for use with an installer click Build Installer (2). You can choose to run an AppleScript after the installer is built and you can create a backup of your application. A backup folder contains your application files in their current state before applying any of the build settings.
Select Build Folder
When you click one of the build buttons you will be prompted to select a folder to build in.
After the application packager has finished with the build a message is displayed.
Here is a list of files that are produced when performing a build for an installer (1) and an auto update (2). A backup was also created (3).
The installer files are ready to be packaged up using your favorite installer program. Stacks have been cleansed of any development custom property sets and password protected (if you have set a password).
The auto update folder contains a folder with the auto update files as well as an update.txt file. These files can be uploaded to your server if you didn't automatically upload them. If you had set your "Base Auto Update URL" to http://www.myserver.com/test_application/auto_update and you packaged your application using the Development profile then you would upload the 0.0.1d1 folder and update.txt to http://www.myserver.com/test_application/auto_update/development. When checking for updates your application will read the update.txt file. The update.txt file will then point the GLX auto updater towards the files in the 0.0.1d1 folder.