Make Windows Executables

From NSB App Studio
Revision as of 18:56, 7 June 2017 by Ghenne (talk | contribs)
Jump to navigation Jump to search

Make Windows Executable makes an exe installer file from your app. It can be redistributed to other users with Windows systems.

To run it, use Make Windows Executable (exe) App on the Run menu. A few seconds later. the exe will be produced. Depending on your settings in Preferences, it will be in one of two places:

  1. If Preferences are set to 'Deploy to local folder', the exe file will be in that local folder.
  2. Otherwise, the exe file be in a folder named with the project's ID in the project folder.

Properties

The settings for exe files are in the Properties Window, under EXE Settings.

You can also set the WindowStyle in Project Properties. A typical setting would be

wx.MINIMIZE_BOX | wx.MAXIMIZE_BOX | wx.RESIZE_BORDER | wx.SYSTEM_MENU | wx.CAPTION | wx.CLOSE_BOX | wx.CLIP_CHILDREN

Notes

  1. All the files in the project folder get included in the exe file. It's best to keep your app in its own folder, and to keep it tidy.
  2. The default size of the window at runtime is the project's defaultformsize property.
  3. The version, copyright and title are all taken from your project's properties.
  4. It works by packaging your app with a Windows runtime wrapper. InnoSetup (built into AppStudio) is then used to make a full Windows installer. Running it will install your app into Program Files and add it to the Windows Start menu.
  5. At runtime, it uses the Internet Explorer 11 engine. Users will need to have this installed to run apps.
  6. The EXE.pythonEval function can be used to execute code in the wrapper, such as system calls.

Example

  1. Create a small project called myApp in a new folder called myProject.
  2. Check that "Deploy to local folder" is not set in Preferences.
  3. From the Run menu, choose "Make Windows Executable (exe)".
  4. A new folder called myApp should now be in the myProject folder.
  5. In that, you will find myApp.exe, along with other files which will be useful if you want to make a more advanced installer of your own.
  6. Click on myApp.exe to run the install for the app.
  7. When it finishes, it will ask whether you want to start the app.
  8. You can also start it from the Windows Start menu.

Testing

EXE apps can be tested without have to create a new installer and run it each time. Here's how:

  1. Using Preferences, set the Deploy location to a local folder.
  2. Make sure Python 2.7.13 or later is installed.
  3. Copy the following files into that folder: Wrapper.py, LocalServer.py, package.json and LauncherIcon57.ico.
  4. Test your app by running Wrapper.py.

How it works: Wrapper.py is a simple app which loads your index.html (and the files it uses) into a web browser. That same Wrapper.py is the core of the EXE file which gets created, so the runtime environment is the same.

Distributing other files with your App

You can include additional files and folder in your app, to be installed in the same directory in Program Files.

  1. Do the same steps as in the Example above with your app.
  2. Add the additional files and folders to the new directory created in step 4.
  3. Run "Make Windows Executable (exe)" again.
  4. The files will now be included in the installer.

Restrictions

  1. SQLite is not supported. This is due to IE not supporting SQLite.
  2. Geolocation is not supported.