Distributing

This page is here so I don't forget the commands needed to build and distribute a new Tacent View release. It's a guide rather than precice steps, plus a few command lines that often need slight tweaks.

Packaging a portable zip for Windows

• In Windows open in vscode. Configure for Release.
• Add -DPACKAGE_PORTABLE=ON to cmake configure args in cmaketools.
• Build the Install target. A portable zip will be created for you.

Packaging a portable tgz for Linux

• In Linux open in vscode. Configure for Release.
• Add -DPACKAGE_PORTABLE=ON to cmake configure args in cmaketools.
• Build the Install target. A portable tgz will be created for you.

Packaging deb file for Ubuntu/Debian etc

• mkdir builddeb
• cd builddeb
• cmake .. -GNinja -DPACKAGE_DEB=True
• ninja install

Deb builds use XDG to determine asset, config, and cache locations. The PACKAGE_DEB will make ninja install create the .deb file for you.

Installing deb file for Ubuntu/Debian etc

• Install: sudo apt install ./tacentview_1.0-44.deb
• Uninstall: sudo apt remove tacentview

Creating a Nix package.

• mkdir buildnix
• cd buildnix
• cmake .. -GNinja -DPACKAGE_NIX=True
• ninja install Nix builds use XDG to determine asset, config, and cache locations. The PACKAGE_NIX does not actually create the Nix package, it just configures the executable properly.

Creating a snap and uploading to store

• cd Linux/snapcraft

• snapcraft clean tacentview // without tacentview an entire VM image is DLed.

• snapcraft

• sudo snap install --dangerous tacentview.snap // To Test.

• sudo snap remove tacentview // To remove above.

• snapcraft export-login snapcraftcreds

• export SNAPCRAFT_STORE_CREDENTIALS=$(cat snapcraftcreds)

• snapcraft login

• snapcraft upload --release=edge tacentview_1.0.29_amd64.snap

Then manage it from the snap store.

Developing in Windows or Linux

• Open in vscode. Configure for Release or Debug.
• Add -DPACKAGE_DEV=ON to cmake configure args in cmaketools.
• Build the Install target.
• Press F5 to debug and run. The PACKAGE_DEV means keep the files as loose rather than bundling them. The directory structure matches portable in that everything is relative to the executable. This stops development from interfering with and installations.

Setting Up Ubuntu

• sudo apt-get update
• sudo snap install snapcraft --classic
• sudo snap install multipass
• sudo apt-get install gdebi # OPTIONAL Installs this gdebi thing that adds support for installing deb files.
• sudo apt-get install git
• sudo gdebi Downloads/smartgit-19_1_7.deb # Installs smartgit, my favourite git frontend at the moment.
• sudo apt-get install llvm # The compiler.
• sudo apt-get install clang # The compiler.
• sudo apt-get install lldb # The debugger.
• sudo update-alternatives --config cc # Choose gcc or clang as default C compiler.
• sudo update-alternatives --config c++ # Choose gnu or clang as default C++ compiler.

The Software and Updates app allows you to manage (and disable) repositories.

• sudo add-apt-repository ppa:eugenesan/ppa # Adds a repo
• sudo add-apt-repository --remove ppa:eugenesan/ppa # Removes a repo

To use WSL2 and allow it to create a deb file:

• sudo update-alternatives --set fakeroot /usr/bin/fakeroot-tcp