Skip to content

Build and Package: Windows

Parallax Git Administrator edited this page Sep 20, 2019 · 42 revisions

These steps need to be performed on a pre-configured development system every time a new installation package is desired.

Windows Building & Packaging

These instructions are incomplete and inaccurate

  • Build the BlocklyProp Launcher
    • Open a command window
    • Check out the needed branch from the BlocklyPropClient_Web repository
      • in Git command line:
        • $ cd C:\Users{username}{folder}\BlocklyPropLauncher
        • $ git checkout origin {branch}
    • That's it! the source can be run from here- there's no need for a build process; however, releasing and packing tasks extra steps
  • Make Release
    • Run the build script from within the repository directory:
      • $ ./MakeRelease
        • This builds and stores the application files in the ./release subfolder
      • Zip up the contents of the release subfolder (the contents, not the folder)
  • Download and touch-up desired nw.js release
    • Download stable release (not -rcx, -alphax, or -betax) from http://dl.nwjs.io/
    • Save it to /package/win-resources/
    • Extract it into /package/win-resources/dependencies/ folder
    • Move (don't copy) the nw.exe file from the dependencies folder up into the win-resources folder
    • Rename the nw.exe file to nw-v#.##.#-win-xAA.exe where # and A exactly matches that of the stable release archive file
    • Open the nw-v...exe file using Resource Tuner
    • Replace the Icon Group > IDR_MAINFRAME English with the blocklyprop.ico file
      • Select IDR_MAINFRAME English, right-click and choose Resource Tools > Add or Replace Icon within Icon Group (or press SHIFT+CTRL+R)
    • Update the Version > 1: English items as follows:
      • CompanyName: Parallax Inc.
      • FileDescription: BlocklyProp Launcher - NW.js v#.##.# package ;where # exactly matches that of the stable release archive file
      • FileVersion: <app_version_number>
      • LegalCopyright: Copyright 2019, Parallax Inc. and the NW.js community and The Chromium Authors. All rights reserved.
      • OriginalFilename: BlocklyPropLauncher.exe
      • ProductName: BlocklyProp Launcher
      • FileVersion: <app_version_number>
      • CompanyShortName: Parallax
      • ProductShortName: BP Launcher
  • Append the zipped-up release package to the updated nw.exe and rename
    • copy /b nw.exe+BPLauncher.nw BPLauncher.exe
  • Package BlocklyProp Launcher
    • Run InnoSetup
    • Open the installer script
      • File > Open the .iss file: C:\Users{username}{folder}\BlocklyPropLauncher\package\blocklyproplauncher-installer.iss
      • Select Build > Compile
    • Now the installer executable will be in the ./dist subfolder.
  • Additional Notes
    • Need to use Resource Tuner to edit the internal resources (Icons, names, versions, and descriptions) of the nw.exe (later BlocklyProp Launcher.ede).
    • Need to use IcoFx (if needed) to edit the .ico (Win) and/or .icns (Mac) files to be used as resources of the above.
Clone this wiki locally