Make Windows Executables

From NSB App Studio
Revision as of 10:54, 3 April 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

  • 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.
  • The default size of the window at runtime is the project's defaultformsize property.
  • The version, copyright and title are all taken from your project's properties.
  • 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.
  • At runtime, it uses the Internet Explorer 11 engine. Users will need to have this installed to run apps.
  • 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) app.
  4. A new folder called myApp.nsx 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.

Restrictions

  1. SQLite is not supported. This is due to IE not supporting SQLite.
  2. localStorage is not supported. The app runs using the file:// protocol, for which IE does not support localStorage.
  3. Geolocation is not supported.