Packaging notes

Packaging workflow

• install Python 3.7.9 using python.org installer (Mac, Windows) or through apt (Linux)

• build tools (see BUILD.md): install from pip

  • Mac: use Pillow=6.0.0

• pyserial

  • install from pip (all platforms?)

• pyaudio

  • Linux: install from pip, first install portaudio-19 using apt. Otherwise pip needs portaudio-19-dev and python3.7-dev to compile the PortAudio library.
  • Windows: use prebuilt wheel from https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyaudio

• pyparallel

  • get from https://github.com/pyserial/pyparallel; setup.py install --user
  • Windows:
    • pyparallel-0.2-win32.exe installer needs msvcr71.dll; copy both to c:\ and run as admin
    • copy simpleio.dll into c:windows\system (not sure if still needed)
    • we may need giveio_setup.exe from https://sourceforge.net/projects/pyserial/files/pyparallel/giveio/giveio_setup.exe/download

Legacy builds

PC-BASIC 1.2 on Windows

• install Python 2.7.12
• install MS Visual C++ for Python 2.7. Note: needed to compile numpy.
• pip install pygame
• pip install pysdl2
• pip install pyinstaller==3.1.1 Note: 3.2 has a bug that causes it to look for msvc100 and fail.
• pip install numpy==1.9.2 Note: newer numpy works, but the pip version includes the 12MiB ATLAS dll which we don't need.
• pip install pyserial==2.7
• install SDL2 library
• install PyParallel 0.2 from https://sourceforge.net/projects/pyserial/files/pyparallel/0.2/pyparallel-0.2.win32.exe
• install NSIS 2.46 (including strlen-8192.zip) from http://nsis.sourceforge.net/Advanced_Uninstall_Log_NSIS_Header

PC-BASIC 2.0 on Windows with Python 2

• install Python 2.7.14
• install MS Visual C++ for Python 2.7
• pip install wheel numpy==1.9.2 pyserial cx_Freeze
• install SDL2 library
• install sdl2_gfx (see BUILD.md)
• msvcr71.dll (for pyparallel installer, put next to the installer exe)
• install PyParallel 0.2 from https://sourceforge.net/projects/pyserial/files/pyparallel/0.2/pyparallel-0.2.win32.exe
• note that pip install pyparallel is missing giveio and simpleio, doesn't work out of the box

PC-BASIC 2.0 on Mac with Python 2

• install homebrew
• brew install python@2
• pip install pcbasic
• pip install wheel pyserial cx_Freeze
• for older versions we also need pip install numpy==1.9.2
• compile SDL2, sdl2_gfx from source:
  • compile sdl2 with ./configure & make & sudo make install. Note: needs to install to /usr/local/lib for sdl2_gfx to compile
  • compile sdl2_gfx with ./configure & make & sudo make install
  • it works now but library can't be moved, has to be in /usr/local. See:
    • https://www.mikeash.com/pyblog/friday-qa-2009-11-06-linking-and-install-names.html
    • https://stackoverflow.com/questions/4677044/how-to-use-dylib-in-mac-os-x-c#11585225
  • fix sdl2_gfx install path to sdl to @loader_path/libSDL2.dylib (?)
  • change install name with install_name_tool to a @loader_path name, check with otool
• copy dylibs into lib/ (?)